Create Withdrawal Order (Bangladesh)
API for creating Bangladeshi Taka (BDT) withdrawal orders. Bangladesh withdrawals are mobile wallet transfers (Nagad / bKash).
Request Information
- Request URL:
/gateway/api/v2/payouts - Method:
POST - Content-Type:
application/json;charset=utf-8
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| platform_id | Yes | String(6) | Merchant ID |
| service_id | Yes | String(7) | Service ID, fixed value SVC0004 |
| payout_cl_id | Yes | String(64) | Merchant Order ID |
| amount | Yes | Integer(10) | Amount (in cents) |
| notify_url | No | String(256) | Callback URL for transaction result |
| bank_name | Yes | String(45) | Wallet code, NAGAD or BKASH, see Wallet List |
| name | Yes | String(2-64) | Beneficiary name (at least 2 characters) |
| number | Yes | String(5-64) | Beneficiary wallet account (mobile number, at least 5 characters) |
| currency | Yes | String(3) | Fixed value: bdt |
| request_time | Yes | Integer(10) | Request time (seconds) |
| sign_type | No | String(16) | Signature type, fixed value HMAC-SHA256 |
| sign | Yes | String(32|64) | Order Signature |
Service ID
SVC0004Wallet Withdrawal (Nagad / bKash)
Wallet codes
bank_name only supports NAGAD and BKASH (case-insensitive). rocket and upay are not supported yet — note that submitting an unsupported wallet still returns "0000" at order creation, but the order cannot be paid out; check the error_msg field of the withdrawal query API (0053, unsupported bank) for the failure reason.
Response Example
{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}
Remarks
Important
In case of timeout or HTTP 500 error, please use the order query API to check the status. Do not treat it as a failed order directly.
- Amount is in 1/100 BDT (cents). Example: for a 100 BDT withdrawal, send
amount = 10000 - Per-transaction limit: minimum 100 BDT / maximum 25,000 BDT (reference values only; actual limits depend on channel configuration — do not hardcode them)
- The withdrawal API enforces an IP allowlist. Please register your server's egress IP with our staff first; requests from unregistered IPs will be rejected.
- A response of "0000" only indicates the API call was successful. Please use the query API to confirm the result.