bKash Agent API
bKash is the dominant **mobile financial services (MFS)** provider in Bangladesh, with more than **70 million registered users**, over **300,000 agent points** and a long-standing **>60% market share** of Bangladesh MFS. Together with Nagad (Bangladesh Post Office, ~74M users) and Rocket (Dutch-Bangla Bank, widest ATM network), bKash carries more than 80% of all retail mobile payments in the…
bKash Agent API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Authentication | ||
| GET |
/auth-status /auth-status |
Run an unauthenticated status check against the wallet platform from the device profile bound to `msisdn` (or any loaded device profile when `msisdn` is omitted). Returns… |
| POST |
/login/request-otp /login/request-otp |
Triggers the platform to send a fresh SMS OTP to `account`. Must be followed within a few minutes by `POST /login/verify-otp` or `POST /login/verify-otp-sms`. `phoneOperator` is… |
| POST |
/login/verify-otp /login/verify-otp |
Submit the already-parsed OTP digits in the JSON body. On success the server completes the upstream login handshake, persists the agent into the multi-account pool, and issues a… |
| Account | ||
| GET |
/balance /balance |
Return the current and available BDT balance for either the signed-in agent's own wallet, or — when `msisdn` is supplied — a target customer wallet (the platform supports… |
| GET |
/recent-transactions /recent-transactions |
Return the most recent transactions for the signed-in agent. **Each record already includes every detail field** (service, transaction id, time, amount, commission, fee,… |
| GET |
/transaction-history /transaction-history |
Paged full ledger. Pass the `nextPivot` value from the previous response as `pivot` to fetch the next page. `pageSize` defaults to `20`. > **Operational note.** This endpoint may… |
| GET |
/transaction-search /transaction-search |
Free-text search against the agent's transaction ledger. The `searchKey` is matched (loosely) against transaction id, amount and counterparty msisdn — useful both for exact… |
| Statement | ||
| GET |
/statement/history /statement/history |
List previously requested statement download jobs together with the remaining monthly quota. |
| POST |
/statement/download /statement/download |
Queue a statement PDF generation job. The PDF is delivered to the contact email returned by `/statement/metadata`. **This is a write operation** and consumes one slot of the… |
| GET |
/statement/metadata /statement/metadata |
Return the supported statement types (detailed / summary), the maximum and selectable date ranges (months) and the contact email currently on file for PDF delivery. Call before… |
| Transfer | ||
| POST |
/cash-in /cash-in |
Move funds from the signed-in **agent / merchant wallet** (`account`) into a **customer wallet** (`customerWallet`). Pass the wallet PIN as a query parameter and the transfer is… |
bKash Agent API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / minute |
|
| PRO | $10 / month | — |
|
| ULTRA | $100 / month | — |
|