# BDPayGate

> BDPayGate is an open-source (MIT) Laravel package, `byteminus/laravel-bdpaygate`, that puts every Bangladeshi payment gateway behind one API: bKash, Nagad, SSLCommerz, Upay, ShurjoPay, aamarPay, PortPos (formerly PortWallet), PayStation, UddoktaPay, Moneybag, EPS and DGePay. Rocket, OK Wallet and CellFin are accepted through SSLCommerz, ShurjoPay or aamarPay. It supports Laravel 11 to 13 on PHP 8.2 to 8.5.

Install with `composer require byteminus/laravel-bdpaygate`. Every gateway callback is confirmed with the gateway's own API before a payment changes state; orders should be fulfilled in a `PaymentCompleted` listener, never on the redirect page. Status changes are atomic, timeouts leave payments pending for `php artisan bdpaygate:sync`, and `BdPayGate::fake()` gives network-free tests. Seven gateways (bKash, SSLCommerz, ShurjoPay, aamarPay, PayStation, UddoktaPay, Moneybag) have been run end to end on the gateways' real sandboxes.

## Docs

- [Overview and quick start](https://bdpaygate.github.io/index.md): install, configure, take a payment, events, refunds, testing
- [Integration guide](https://bdpaygate.github.io/docs/integration-guide.md): .env keys for every gateway, refund and sync support, lifecycle, troubleshooting
- [Full documentation in one file](https://bdpaygate.github.io/llms-full.txt): everything below concatenated

## Gateways

- [bKash](https://bdpaygate.github.io/docs/bkash.md): setup, .env keys, verification and quirks (stable)
- [Nagad](https://bdpaygate.github.io/docs/nagad.md): setup, .env keys, verification and quirks (beta)
- [SSLCommerz](https://bdpaygate.github.io/docs/sslcommerz.md): setup, .env keys, verification and quirks (stable)
- [Upay](https://bdpaygate.github.io/docs/upay.md): setup, .env keys, verification and quirks (beta)
- [ShurjoPay](https://bdpaygate.github.io/docs/shurjopay.md): setup, .env keys, verification and quirks (stable)
- [aamarPay](https://bdpaygate.github.io/docs/aamarpay.md): setup, .env keys, verification and quirks (stable)
- [PortPos (formerly PortWallet)](https://bdpaygate.github.io/docs/portpos.md): setup, .env keys, verification and quirks (beta)
- [PayStation](https://bdpaygate.github.io/docs/paystation.md): setup, .env keys, verification and quirks (stable)
- [UddoktaPay](https://bdpaygate.github.io/docs/uddoktapay.md): setup, .env keys, verification and quirks (stable)
- [Moneybag](https://bdpaygate.github.io/docs/moneybag.md): setup, .env keys, verification and quirks (stable)
- [EPS (Easy Payment System)](https://bdpaygate.github.io/docs/eps.md): setup, .env keys, verification and quirks (experimental)
- [DGePay](https://bdpaygate.github.io/docs/dgepay.md): setup, .env keys, verification and quirks (experimental)

## Source

- [GitHub repository](https://github.com/byteminus/laravel-bdpaygate): code, issues, releases
- [Packagist](https://packagist.org/packages/byteminus/laravel-bdpaygate): `byteminus/laravel-bdpaygate`

## Optional

- [Contributing and writing a gateway driver](https://bdpaygate.github.io/docs/contributing.md)
- [Changelog](https://bdpaygate.github.io/docs/changelog.md)