bKash Payment Gateway Documentation

Complete guide for bKash Checkout and Refund integration

Contents

Official bKash Docs

Test Credentials

Regular Customer

Number: 01929918378
PIN: 12121
OTP: 123456

Insufficient Balance

Number: 01823074817
PIN: 12121
OTP: 123456

Debit Block

Number: 01823074818
PIN: 12121
OTP: 123456

Merchant

Number: 01619777282
PIN: 12121
OTP: 123456

Getting Started

Please complete the signup at Merchant Integration Portal to proceed with the next steps.

Merchant Integration Portal Signup

Quick Integration Steps

  1. Sign up for a Merchant account
  2. Obtain API credentials from the Merchant Portal
  3. Implement the required APIs in your application
  4. Test your integration with sandbox credentials
  5. Submit for validation and go live

Required APIs

Grant Token
View Documentation →
Refresh Token
View Documentation →
Create Payment
View Documentation →
Execute Payment
View Documentation →
Query Payment
View Documentation →
Search Transaction
View Documentation →
Refund Transaction
View Documentation →
Important Note

API timeout of 30 seconds should be set for all the APIs.

Sandbox Wallet Numbers

Regular Active Customer Wallets

01770618575
01929918378
01770618576
01877722345
01619777282
01619777283

Failed Case Wallets

01823074817Insufficient Balance
01823074818Debit Block

PIN

12121

OTP

123456

Integration Milestones

1

Step 1: Integration Initiation

Merchant is offered Developer Portal, Merchant Integration Portal, Demo Link and Sandbox credentials for testing
2

Step 2: Merchant system readiness with bKash PGW Sandbox

a. Merchant confirms development readiness using sandbox b. Merchant shares user journey flow (if required) c. Solution document finalization (if required)
3

Step 3: Sandbox result validation

Merchant Validate Create and Execute responses in Merchant Integration portal
4

Step 4: Production info collection & Production onboarding

merchant is provided with live credentials in the Merchant Integration Portal and is onboarded for production.
5

Step 5: Merchant system readiness with bKash PGW Production

Merchant confirms system readiness using Production credentials
6

Step 6: UAT & Go Live

a. Technical UAT : Checking merchant backend security mechanism b. Business UAT : Checking user journey with Production credentials. c. Merchant makes the payment system available for all customers.

Token Management

Token Lifecycle

ID Token

Valid for 1 hour

Refresh Token

Valid for 28 days

Important Guidelines

Reuse ID token for 1 hour for any subsequent API request

Show "payment failed" message for failure/cancel status

Execute API should only be called for success status

StatusCode 0000 indicates successful execute response

Query payment should only be used if execute API fails