Payouts
Bangladesh
Bank and mobile wallet payouts in BDT
Before you start
Authorization
How to sign your requests with the API token.
Payouts overview
Common request format, response fields and statuses.
This payout destination is not enabled for all merchants. Check availability with your manager, and make sure your merchant balance is sufficient before creating a payout.
Overview
| Currency | Destination | Payment types |
|---|---|---|
BDT | Bank accounts and mobile wallets | C2C, SIM |
Payment types
paymentType | Description |
|---|---|
C2C | Bank transfer |
SIM | Mobile wallet transfer (Nagad, bKash, Rocket) |
account fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ Yes | Recipient name |
requisites | string | ✅ Yes | Recipient requisites: card number, phone number, PIX key, etc., depending on paymentType |
userId | string | ✅ Yes | User ID in your system |
Additional fields, all required:
| Field | Type | Required | Description |
|---|---|---|---|
userIp | string | ✅ Yes | Recipient IP address |
userPhone | string | ✅ Yes | Recipient phone number, e.g. +8801712345678 |
userEmail | string | ✅ Yes | Recipient email |
bankName | string | ✅ Yes | Wallet or bank: NAGAD, BKASH, ROCKET |
Request example
curl -X POST "https://api.riopay.online/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 1000.50,
"currency": "BDT",
"paymentType": "C2C",
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "23645856856856485468565845856865485468",
"userId": "user_12345",
"userIp": "203.0.113.10",
"userPhone": "+8801712345678",
"userEmail": "john.doe@example.com",
"bankName": "BKASH"
},
"note": "Payout for order #1234"
}'Response
The response is a standard payout object with the CREATED status. Store the id to track the payout.