bKash Agent API

孟加拉国代理钱包

bKash 代理/商户钱包（孟加拉国）—— OTP 登录、余额、近期交易、搜索、分页历史、PDF 对账单，以及代理→客户的 Cash-In 转账。

🔐 试用登录演示 →

概览

💡

基础 URL： https://api.openbankinggateway.com — 所有响应均采用统一的 {code, data} 结构。

会话流程： 完成登录端点即可获得网关 token，随后在每个需要鉴权的端点以 token= 传入。

透明性： 每个响应（无论成功或失败）都在 data.upstream 下附带原始的上游金融科技 JSON。

在下方任意端点填入参数并点击 Send request 即可调用在线网关，或复制 curl 示例在终端中运行。

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'