Direct Checkout — Mode: URL

Returns a redirect URL for the selected payment method. Redirect the customer to this URL to complete payment.

When to Use

▾

Use this mode when:

• Integrating Alipay+, Boost, or other URL-redirect payment methods
• Driving payment from your own checkout UI

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 Redirect URL

▾

POST with type: "URL" and the desired method.

Step 3: Redirect the Customer

▾

Send the customer to the returned url. Poll Query Payment Checkout for status updates.

---

Request Parameters

▾

checkoutIdSTRINGrequired

Checkout ID from the Hosted Payment Checkout response.

typeSTRINGrequired

Checkout type. Set to "URL".

methodSTRINGrequired

Payment method (e.g., ALIPAYPLUS_MY).

Response Parameters

▾

itemOBJECT

Response item

typeSTRING

Checkout session type.

urlSTRING

Checkout session URL.

codeSTRING

"SUCCESS" if the request succeeded.

errorOBJECT

Error details

codeSTRING

Error code.

messageSTRING

Error message.

debugSTRING

Debug message (sandbox only).