Cashier Payment

If a merchant releases their mini program to AlipayCN and requires payment services, they must provide cross-border transaction capability. To provide such capability, the merchant must implement either of Alipay+'s payment solutions: Cashier Payment or Auto Debit Payment.

This topic explains Cashier Payment, including its definition, user experience, prerequisites, workflow, and implementation resources.

Note: If you release your mini program to an Alipay+ partner app located in a different country, to implement Cashier Payment for cross-border transactions, refer to the Alipay+ Cashier Payment solution.

What is Cashier Payment

Cashier Payment is a payment solution that enables merchants to accept payments worldwide within their mini programs. Within a mini program released to AlipayCN, when a user checks out, they can select AlipayCN as a payment method on the merchant's cashier page.

User experience

The user experience with Cashier Payment is described as follows:

1. The user places an order within a mini program and selects AlipayCN (支付宝) as the payment method on the merchant's cashier page.
2. The user clicks the pay button and is then redirected to AlipayCN's payment confirmation page to complete the payment.
3. The user confirms the payment result in AlipayCN and returns to the mini program.

Before you start

To implement the Cashier Payment solution, the merchant must choose either Antom or one of the Alipay+ acquiring service providers as their acquiring partner. For a full list of Alipay+ acquiring service providers, refer to Alipay+ Acquiring Service Providers.

Sequence

The following sequence diagram illustrates how Cashier Payment works:

The steps in the diagram are described as follows:

Step 1: Create order

1. The user confirms the order and proceeds to checkout within a mini program (step 1).
2. The mini program's frontend invokes the my.getSiteInfo JASPI and gets the super app information from AlipayCN (steps 1.1-1.2). This information serves two purposes:

• To identify the required JSAPI to initiate the payment process. In this case, the returned siteName is ALIPAY_CN, indicating the required JSAPI is my.crossPay.
• To request the acquirer to create an order because they might need this information in their API payload.

3. The mini program's frontend calls its backend API to create an order, potentially including the obtained super app information. (step 1.3).
4. The mini program's backend sends the order creation request to the acquirer and gets the corresponding payment information (steps 1.4.1-1.4.1.3). Note: For technical specifics on this step, consult the merchant's acquiring partner.
5. The mini program's backend sends the payment information to the frontend (step 1.5)
6. The mini program's frontend invokes the my.crossPay JSAPI with the payment information, and then AlipayCN displays the cashier page.

Step 2: Pay bill

1. The user checks the payment information on the cashier page and confirms the payment (step 2).
2. AlipayCN confirms the user's payment intention, and notifies the merchant's acquirer (steps 2.1.1-2.1.2)
3. AlipayCN sends its processing result to the mini program via the callback of the my.crossPay JSAPI (step 2.2). Note: The my.crossPay JSAPI only returns the result code 8000 (Trade is processing). It does not provide a final payment status, even if the user confirms or cancels the payment.

Step 3: Update payment result

1. The acquirer receives the payment result (step 3).
2. The mini program's backend receives the payment result (step 3.1). The method for obtaining the result might vary based on the acquirer's technical solution. Usually, the mini program receives the result in the following ways:

• The acquirer actively sends the payment result to the mini program's backend.
• The mini program's backend continuously queries the payment result until it receives a final payment status.

For technical specifics on this step, consult the merchant's acquiring partner.

3. The mini program's frontend gets the payment result and updates the page to display it to the user.

API list

The following table lists the JSAPIs that mini programs must integrate to implement Cashier Payment:

More information

Alipay+ cashier payment solution

Manage Alipay+ mini programs in Alipay China