Create Deposit Order (United Arab Emirates)

API for creating UAE Dirham (AED) deposit orders.

Request Information

• Request URL: /gateway/api/v2/payments
• 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
payment_cl_id	Yes	String(64)	Merchant Order ID
amount	Yes	Integer(10)	Amount (in fils)
notify_url	Yes	String(256)	Callback URL for transaction results
user_id	No	String(32)	Merchant-side user identifier, used for channel risk control and limits; falls back to the merchant order ID when omitted
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

• SVC0102 Card Payment
• SVC0103 Apple Pay
• SVC0104 Google Pay
• SVC0108 AANI Wallet
• SVC0109 EMONEY Wallet
• SVC0110 DUPAY Wallet
• SVC0111 BOTIM Wallet
• SVC0112 PAYBY Wallet

Response Example

Successful Response

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 50000
  }
}

Remarks

• Transaction amount is in UAE Dirham (fils), please multiply by 100 before sending
• Per-transaction limits: 20 – 10000 AED for SVC0102 and SVC0103; 20 – 500 AED for SVC0104 (Google Pay)
• Wallet per-transaction limits: 20 – 3000 AED for SVC0108 (AANI), SVC0109 (EMONEY) and SVC0110 (DUPAY)
• SVC0111 (BOTIM) and SVC0112 (PAYBY) accept fixed denominations only: 20 / 30 / 50 / 100 / 200 / 500 / 1000 / 2000 AED; any other amount is rejected
• Redirect the payer to the link returned to complete the payment
• No bank code is required for this channel; the payment method is determined by service_id
• Request time uses Unix timestamp in seconds
• Transaction results will be sent to notify_url, see Deposit Notification for parameter details
• The final order status must be taken from Query Deposit Order or the transaction notification