Skip to main content

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​

ParameterRequiredTypeDescription
platform_idYesString(6)Merchant ID
service_idYesString(7)Service ID
payment_cl_idYesString(64)Merchant Order ID
amountYesInteger(10)Amount (in sen)
notify_urlYesString(256)Callback URL for transaction results
request_timeYesInteger(10)Request time (seconds)
sign_typeNoString(16)Signature type, fixed value HMAC-SHA256
signYesString(32|64)Order Signature

Service ID​

  • SVC0113 DuitNow QR
  • SVC0115 Touch 'n Go eWallet
  • SVC0116 FPX 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​

ParameterTypeDescription
error_codeStringError code, see Global Error Codes
error_msgStringError message (returned when error_code is not "0000")
linkStringCashier page URL of the order
payment_idStringPlatform order ID
payment_cl_idStringMerchant order ID
amountIntOrder amount
qr_code_contentStringDuitNow 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 for SVC0115 (Touch 'n Go eWallet); 100.00 – 50000.00 MYR for SVC0116 (FPX Online Banking)
  • Redirect the payer to the link returned 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 through link. The QR code is valid for about 5 minutes, so guide the user to scan it promptly after the order is created
  • SVC0115 / SVC0116: after opening link, 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