devrkb21/bkash-pgw-laravel

Production-ready Laravel integration for bKash Tokenized Checkout V2 (auth, payments, webhooks).

v1.0.0 2026-04-19 23:15 UTC

Requires

• php: ^8.1
• illuminate/cache: ^10.0|^11.0|^12.0
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.5|^11.0

MIT

• devrkb21

• laravel
• webhook
• bangladesh
• payment-gateway
• bkash
• tokenized-checkout
• tokenized-v2

README

🚀 Production-ready Laravel bKash package for integrating bKash Tokenized Checkout V2 API with secure webhook, token management, and full payment flow.

The most complete and secure bKash integration for Laravel.

🚀 Quick Start (30 seconds)

composer require devrkb21/bkash-pgw-laravel

use Bkash;

$url = Bkash::payment()->createPayment([
    'payerReference' => 'user_123',
    'callbackURL' => route('bkash.callback'),
    'amount' => '100',
    'currency' => 'BDT',
    'intent' => 'sale',
    'merchantInvoiceNumber' => 'INV123456',
]);

return redirect($url->bkash_url);

👉 That’s it. User will be redirected to bKash payment page.

⚙️ Configuration

Publish config:

php artisan vendor:publish --tag=bkash-config

Add credentials:

BKASH_ENV=sandbox

BKASH_APP_KEY=
BKASH_APP_SECRET=
BKASH_USERNAME=
BKASH_PASSWORD=

💳 Payment Flow

1. Create Payment

Bkash::payment()->createPayment([...]);

2. Handle Callback

Bkash::payment()->handleCallback(request()->all());

3. Query Payment

Bkash::payment()->queryPayment($paymentId);

4. Capture / Void

Bkash::payment()->capturePayment($paymentId);
Bkash::payment()->voidPayment($paymentId);

🔄 Agreement (Saved Wallet)

Bkash::agreement()->createAgreement([...]);
Bkash::agreement()->executeAgreement($agreementId);

💰 Refund API

Bkash::refund()->refundTransaction([
    'paymentId' => $paymentId,
    'trxId' => $trxId,
    'refundAmount' => '10',
    'reason' => 'Customer request',
]);

🔔 Webhook (Secure & Automatic)

Enable in config:

'enable_routes' => true,

Endpoint:

POST /bkash/webhook

Automatically handled:

• SNS Subscription confirmation
• Signature verification
• Replay attack protection
• Notification parsing

🔐 Why this package?

Most Laravel bKash packages:

• ❌ No token management
• ❌ No webhook security
• ❌ Only basic API wrappers

This package provides:

• ✅ Automatic token lifecycle (grant + refresh)
• ✅ Secure SNS webhook verification
• ✅ Replay attack protection
• ✅ Retry-safe HTTP client
• ✅ Full payment + agreement + refund APIs
• ✅ Clean Laravel integration (Facade + DI)
• ✅ Test coverage

🧪 Testing

composer test

📦 Requirements

• PHP 8.1+
• Laravel 10 / 11 / 12

📈 SEO Keywords

Laravel bKash payment gateway, bKash Laravel package, Bangladesh payment gateway Laravel, bKash Tokenized Checkout V2, Laravel payment integration bKash

🛠 Roadmap

• Event system (PaymentSuccess, Failed)
• Queue-based webhook handling
• Multi-gateway support (bKash + Nagad + SSLCommerz)

🤝 Contributing

PRs are welcome. Please ensure tests pass.

📄 License

MIT License

⭐ Support

If this package helps you, please give it a star ⭐ It helps others discover the project.

☕ Support Development

If you find this package useful, you can support ongoing development:

👉 https://buymeacoffee.com/devrkb21

Your support helps maintain and improve this package ❤️