bKash Agent API

Bangladesh Agent wallet

bKash agent/merchant wallet (Bangladesh) — OTP login, balance, recent transactions, search, paged history, PDF statements, and agent→customer Cash-In transfer.

🔐 Try the login demo →

Overview

💡

Base URL: https://api.openbankinggateway.com — all responses use the unified {code, data} envelope.

Session flow: complete the login endpoints to receive a gateway token, then pass it as token= to every authenticated endpoint.

Transparency: the raw upstream fintech JSON is included under data.upstream on every response — success and error alike.

Fill in the parameters on any endpoint below and hit Send request to call the live gateway, or copy the curl example to run it from your terminal.

Discovery

GET/api/bkash-agent/auth-status

Pre-auth status/version probe

Parameter	In	Value
`msisdn`	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/auth-status'

Auth

POST/api/bkash-agent/login/request-otp

Dispatch SMS OTP

Parameter	In	Value
`account`*	query
`phoneOperator`*	query

curl -X POST 'https://api.openbankinggateway.com/api/bkash-agent/login/request-otp?account=01700000001&phoneOperator=Grameenphone'

POST/api/bkash-agent/login/verify-otp

Verify OTP and issue a session token

Parameter	In	Value
`account`*	query
`pin`*	query
`otp`*	body
`state`	body

curl -X POST 'https://api.openbankinggateway.com/api/bkash-agent/login/verify-otp?account=01700000001&pin=11223' \ -H 'Content-Type: application/json' \ -d '{"otp":"419717","state":"NOT_ONBOARDED_IN_THIS_DEVICE"}'

Account

GET/api/bkash-agent/balance

Wallet balance (token required)

Parameter	In	Value
`token`*	query
`msisdn`	query
`serviceName`	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/balance?token=<token>'

GET/api/bkash-agent/recent-transactions

Recent transactions (token required)

Parameter	In	Value
`token`*	query
`pageSize`	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/recent-transactions?token=<token>&pageSize=5'

GET/api/bkash-agent/transaction-search

Search transactions by key (token required)

Parameter	In	Value
`token`*	query
`searchKey`*	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/transaction-search?token=<token>&searchKey=<searchKey>'

GET/api/bkash-agent/transaction-history

Paged full transaction history (token required)

Parameter	In	Value
`token`*	query
`pageSize`	query
`pivot`	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/transaction-history?token=<token>&pageSize=20'

Statement

GET/api/bkash-agent/statement/metadata

Statement types and selectable date ranges (token required)

Parameter	In	Value
`token`*	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/statement/metadata?token=<token>'

GET/api/bkash-agent/statement/history

Statement download history and quota (token required)

Parameter	In	Value
`token`*	query
`pageSize`	query
`pageToken`	query

curl -X GET 'https://api.openbankinggateway.com/api/bkash-agent/statement/history?token=<token>&pageSize=10'

POST/api/bkash-agent/statement/download

Queue a statement PDF (emailed to the agent)

Parameter	In	Value
`token`*	query
`fromDate`*	query
`toDate`*	query
`type`	query

curl -X POST 'https://api.openbankinggateway.com/api/bkash-agent/statement/download?token=<token>&fromDate=2026-07-01&toDate=2026-07-22&type=DETAILED_STATEMENT'

Transfer

POST/api/bkash-agent/cash-in

Cash-In transfer to a customer wallet

Parameter	In	Value
`token`*	query
`customerWallet`*	query
`amount`*	query
`pin`*	query
`cashInType`	query

curl -X POST 'https://api.openbankinggateway.com/api/bkash-agent/cash-in?token=<token>&customerWallet=01900000001&amount=50&pin=11223'