Direct Checkout — Mode: DuitNow QR

Returns a DuitNow QR code that supports all DuitNow-compatible payment apps in Malaysia.

When to Use

▾

Use this mode when:

• You want a single QR accepted by Maybank, CIMB, TouchnGo, GrabPay, Boost, and other DuitNow-supported apps
• Reducing checkout friction with a universal QR

note

Poll Query Payment Checkout every 3-5 seconds to track payment status.

How to Use

▾

Endpoint

POST/v3/payment/online/checkout

Step 1: Create a Checkout

▾

Call Hosted Payment Checkout to obtain checkoutId.

Step 2: Request the DuitNow QR

▾

POST with type: "DUITNOW_QRCODE" and an empty method.

Step 3: Display and Poll

▾

Render the returned base64Image and poll Query Payment Checkout for status.

---

Request Parameters

▾

checkoutIdSTRINGrequired

Checkout ID from the Hosted Payment Checkout response.

typeSTRINGrequired

Checkout type. Set to "DUITNOW_QRCODE".

methodSTRINGrequired

Leave empty for DuitNow QR.

Response Parameters

▾

itemOBJECT

Response item

typeSTRING

Checkout session type.

qrcodeOBJECT

qrcode details

base64ImageSTRING

Base64-encoded QR code image.

dataSTRING

QR code data string.

codeSTRING

"SUCCESS" if the request succeeded.

errorOBJECT

Error details

codeSTRING

Error code.

messageSTRING

Error message.

debugSTRING

Debug message (sandbox only).