Download the PHP package devrkb21/bkash-pgw-laravel without Composer
On this page you can find all versions of the php package devrkb21/bkash-pgw-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download devrkb21/bkash-pgw-laravel
More information about devrkb21/bkash-pgw-laravel
Files in devrkb21/bkash-pgw-laravel
Package bkash-pgw-laravel
Short Description Production-ready Laravel integration for bKash Tokenized Checkout V2 (auth, payments, webhooks).
License MIT
Informations about the package bkash-pgw-laravel
πΈ Laravel bKash Payment Gateway (Tokenized Checkout V2)
π 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)
π Thatβs it. User will be redirected to bKash payment page.
βοΈ Configuration
Publish config:
Add credentials:
Auth APIs
Grant Token - POST /auth/grant-token
Request body keys:
Response (normalized by the package, expires_at is computed):
Refresh Token - POST /auth/refresh-token
Request body keys:
Response (normalized by the package, expires_at is computed):
Payment APIs (Without Agreement)
Create Payment - POST /payment/create
Request body keys:
Response (package normalizes common fields):
Execute Payment - POST /payment/execute
Request body keys:
Response (package normalizes common fields):
Query Payment - POST /query/payment
Request body keys:
Response (raw bKash payload, normalized keys are added when present):
Capture Payment - POST /payment/capture
Request body keys:
Response (raw bKash payload, normalized keys are added when present):
Void Payment - POST /payment/void
Request body keys:
Response (raw bKash payload, normalized keys are added when present):
Payment APIs (With Agreement)
Create Payment With Agreement - POST /payment-with-agreement/create
Request body keys:
Response (package normalizes common fields):
Execute Payment With Agreement - POST /payment-with-agreement/execute
Request body keys:
Response (package normalizes common fields):
Capture Payment With Agreement - POST /payment-with-agreement/capture
Request body keys:
Response (raw bKash payload, normalized keys are added when present):
Void Payment With Agreement - POST /payment-with-agreement/void
Request body keys:
Response (raw bKash payload, normalized keys are added when present):
Agreement APIs
Create Agreement - POST /agreement/create
Request body keys:
Response (raw bKash payload):
Execute Agreement - POST /agreement/execute
Request body keys:
Response (raw bKash payload):
Query Agreement - POST /query/agreement
Request body keys:
Response (raw bKash payload):
Cancel Agreement - POST /agreement/cancel
Request body keys:
Response (raw bKash payload):
Transaction and Refund APIs
Search Transaction - POST /general/search-transaction
Request body keys:
Response (raw bKash payload):
Refund Transaction - POST /refund/payment/transaction
Request body keys:
Response (raw bKash payload):
Refund Status - POST /refund/payment/status
Request body keys:
Response (raw bKash payload):
Webhook Events (SNS)
Enable the built-in route by setting BKASH_ENABLE_ROUTES=true.
Webhook endpoint:
SubscriptionConfirmation Event
Headers:
- Content-Type: application/json
- x-amz-sns-message-type: SubscriptionConfirmation
Request body keys:
Response (from the package webhook service):
Notification Event
Headers:
- Content-Type: application/json
- x-amz-sns-message-type: Notification
Request body keys:
Response (from the package webhook service):
Checkout SDK
Checkout Script URL - GET
Response: JavaScript file (200/301/302/304/404).
Payout
Initiate Payout - POST /payout/initiate
Request body keys:
Response (raw bKash payload):
π³ Payment Flow
1. Create Payment
2. Handle Callback
3. Query Payment
4. Capture / Void
π Agreement (Saved Wallet)
π° Refund API
π Webhook (Secure & Automatic)
Enable in config:
Endpoint:
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
π¦ 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:
All versions of bkash-pgw-laravel with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
illuminate/cache Version ^10.0|^11.0|^12.0