Key Parameters

Parameter Field	Parameter Type	Parameter Attribute	Parameter Description
bizType	String(64)	C	Pass fixed value CardOnFile when binding card and transaction or when card number verification is required for card binding, otherwise do not pass (contact technical support to use this value)
merchantUserId	String(64)	M	Cardholder ID of merchant website, globally unique, pass null for guest mode or non-existent cases
createToken	String(1)	M	Y/N, whether to create token
token	String(16)	M	Card information flag

Interaction Flow

Step 1: Create card token

Hosted

Related API: Hosted-JS-SDK or Get Redirect Cashier

• In cashier mode, createToken will be determined through page checkbox to be Y, no need to send via interface.
• Merchant needs to send merchantUserId to identify current payer identity.
• PingPongCheckout matches token based on merchantUserId sent by merchant, no need for merchant to upload

Non-Hosted

Related API: token creation

• Send parameter createToken=Y.
• Send parameter merchantUserId to identify current cardholder identity.
• Send parameter bizType=CardOnFile(optional) for card verification.

Step 2: Verify card elements (optional)

If you want to verify card validity, or need to perform card binding and payment process simultaneously (incoming amount>=0), you must set bizType=CardOnFile.

Step 3: Display card list (optional)

The same user may have multiple credit cards. To optimize payment experience, we need to list the card list under specified customerId (only showing first 6 and last 4 digits of card number) for cardholder selection.

Non-Hosted

This step is completed by merchant side. Merchant can record card and token relationship list by themselves, or call PingPongCheckout's card list interface.

Repeat Purchase

• Checkout mode (Hosted): Collect CVV through the embedded checkout, see Repeat Purchase CVV Collection Checkout.
• API mode (Non-Hosted): Use token to call the order API directly from merchant server, see Repeat Purchase Non-Hosted.

Previous pageOverview

Next pageRepeat Purchase CVV Collection