Create Deposit Order (Malaysia)
API for creating Malaysian Ringgit (MYR) 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 sen) |
| notify_url | Yes | String(256) | Callback URL for transaction results |
| 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
SVC0113DuitNow QRSVC0115Touch 'n Go eWalletSVC0116FPX Online Banking
Response Example
Successful Response (SVC0113 DuitNow QR)
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000,
"qr_code_content": "00020201021226590014A000000615000101..."
}
}
Successful Response (SVC0115 / SVC0116)
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000
}
}
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code, see Global Error Codes |
| error_msg | String | Error message (returned when error_code is not "0000") |
| link | String | Cashier page URL of the order |
| payment_id | String | Platform order ID |
| payment_cl_id | String | Merchant order ID |
| amount | Int | Order amount |
| qr_code_content | String | DuitNow QR code content (SVC0113 only; may be absent, see remarks) |
Remarks
- Transaction amount is in Malaysian Ringgit (sen), please multiply by 100 before sending, e.g. pass 10000 for a 100.00 MYR deposit
- Per-transaction limits: 1.00 – 2000.00 MYR for
SVC0113(DuitNow QR); 1.00 – 10000.00 MYR forSVC0115(Touch 'n Go eWallet); 100.00 – 50000.00 MYR forSVC0116(FPX Online Banking) - Redirect the payer to the
linkreturned to complete the payment SVC0113:qr_code_content(DuitNow QR code content) is normally returned as well, so merchants may render the QR code themselves; in rare cases this field is absent, in which case guide the payer throughlink. The QR code is valid for about 5 minutes, so guide the user to scan it promptly after the order is createdSVC0115/SVC0116: after openinglink, the payer is redirected to the corresponding payment page 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