bKash Agent API

Bangladesh Carteira de agente

Carteira de agente/lojista bKash (Bangladesh) — login com OTP, saldo, transações recentes, busca, histórico paginado, extratos em PDF e transferência Cash-In de agente para cliente.

🔐 Experimente a demo de login →

Visão geral

💡

URL base: https://api.openbankinggateway.com — todas as respostas usam o envelope unificado {code, data}.

Fluxo de sessão: complete os endpoints de login para receber um token do gateway e depois passe-o como token= em cada endpoint autenticado.

Transparência: o JSON fintech upstream bruto é incluído em data.upstream em cada resposta — de sucesso e de erro igualmente.

Preencha os parâmetros em qualquer endpoint abaixo e clique em Send request para chamar o gateway ao vivo, ou copie o exemplo curl para rodar no seu 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'