Create Withdrawal Order (United Arab Emirates)
API for creating UAE Dirham (AED) withdrawal orders, supporting AE IBAN bank transfers.
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 fils) |
| notify_url | No | String(256) | Callback URL for transaction results |
| bank_name | Yes | String(16) | Bank code, the English bank name is also accepted, Bank List |
| name | Yes | String(64) | Beneficiary name |
| number | Yes | String(64) | Beneficiary account: the IBAN |
| iban | Yes | String(34) | UAE IBAN (AE + 21 digits, 23 characters in total), e.g. AE070331234567890123456; when omitted, number is validated as the IBAN |
| phone_number | Yes | String(11) | Beneficiary mobile number (e.g. 0501234567) |
| currency | Yes | String(3) | Fixed value: aed |
| 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
SVC0004Bank Transfer (AE IBAN)
Response Example
{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}
Remarks
Important
In case of a timeout or HTTP 500 error, rely on the order query interface for the status; do not treat it as a failed order.
- Transaction amount is in UAE Dirham (fils)
- Bank transfer: pass the bank code or English bank name in
bank_name,ibanmust be a valid UAE IBAN (AE+ 21 digits, 23 characters in total), andphone_numberis required - Per-transaction limit: 200 – 10000 AED
- If the beneficiary details fail validation, the error is returned at creation time and no order is created
- "0000" only means the API call succeeded; call the query interface to confirm the result