Direct Checkout — Mode: QR Code

Returns a QR code image for the selected payment method. Display this QR code on screen for the customer to scan with their mobile banking or wallet app.

When to Use

▾

Use this mode when:

• Integrating Maybank QR, CIMB QR, or other bank-specific QR payments
• Displaying QR on a desktop checkout for mobile scanning

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 QR Code

▾

POST with type: "QRCODE" and the desired bank method.

Step 3: Display and Poll

▾

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

Decode your Image using Base64

▾

Using qrCodeImageBase64 URL to generate a QR Code

What user will receive

▾

Once user scan the QR Code it will display

---

Request Parameters

▾

checkoutIdSTRINGrequired

Checkout ID from the Hosted Payment Checkout response.

typeSTRINGrequired

Checkout type. Set to "QRCODE".

methodSTRINGrequired

Payment method (e.g., MAYBANK_MY).

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).