[PayOut] BDT Payment Data
For shops with BDT currency, when creating a payout (POST /api/v1/payouts) no additional fields are required in the paymentData object.
The recipient wallet, account, or card number must be sent in the root card_number field.
merchant_user_id and merchant_user_ip are mandatory root fields for this request.
paymentData fields
No BDT-specific paymentData fields are required for this payout contract.
Example request body
{
"external_id": "PAY-BDT-001",
"amount": "5000.00",
"currency": "BDT",
"card_number": "4111111111111111",
"shop_code": "your_bdt_shop",
"merchant_user_id": "merchant-user-001",
"merchant_user_ip": "203.0.113.10"
}
Response fields
| Parameter | Type | Description |
|---|---|---|
| id | number | Payfield operation ID. |
| status | string | Current payout status. |
| external_id | string | Unique payout identifier from the request. |
| amount | string | Payout amount. |
| currency | string | Payout currency. |
| shop_code | string | Shop code used for routing. |
| card_number | string | Recipient card number. |
| merchant_user_id | string | Merchant user identifier from the request. |
| merchant_user_ip | string | User IP from the request. |
| transaction_type | string | Always payout. |
| created_at | string | Creation timestamp. |
| updated_at | string | Last update timestamp. |
| finalization_date | string | Returned when the payout reaches a final status. |
Example response body
{
"id": 12345,
"status": "pending",
"external_id": "PAY-BDT-001",
"amount": "5000.00",
"currency": "BDT",
"shop_code": "your_bdt_shop",
"card_number": "4111111111111111",
"merchant_user_id": "merchant-user-001",
"merchant_user_ip": "203.0.113.10",
"transaction_type": "payout",
"created_at": "2025-12-05T10:00:00.000000Z",
"updated_at": "2025-12-05T10:00:00.000000Z"
}
Omit paymentData for this BDT payout contract.