Direct Checkout — Mode: FPX

Returns an FPX (online banking) redirect URL. Customer chooses their bank from the FPX bank list and is redirected to complete payment.

When to Use

▾

Use this mode when:

• Accepting Malaysian online banking payments
• The customer prefers paying via their bank's online portal

How to Use

▾

Endpoint

POST/v3/payment/online/checkout

Step 1: Get the FPX Bank List

▾

GET /v3/payment/fpx-bank to retrieve the list of supported banks, and let the customer pick their bank.

Step 2: Create a Checkout

▾

Call Hosted Payment Checkout to obtain checkoutId.

Step 3: Request the FPX Redirect URL

▾

POST with type: "URL", method: "FPX_MY", and fpx.bankCode.

Step 4: Redirect the Customer

▾

Send the customer to the returned url to complete payment at their bank.

---

Request Parameters

▾

checkoutIdSTRINGrequired

Checkout ID from the Hosted Payment Checkout response.

typeSTRINGrequired

Checkout type. Set to "URL".

methodSTRINGrequired

Payment method. Set to "FPX_MY".

fpxOBJECTrequired

FPX banking details

bankCodeSTRINGrequired

FPX bank code from the table above.

Response Parameters

▾

itemOBJECT

Response item

typeSTRING

Checkout session type.

urlSTRING

FPX payment URL to redirect the customer to.

codeSTRING

"SUCCESS" if the request succeeded.

errorOBJECT

Error details

codeSTRING

Error code.

messageSTRING

Error message.

debugSTRING

Debug message (sandbox only).