Alipay+ DocsAlipay+ Docs

Cashier Payment

Alipay+ Cashier Payment allows merchants to quickly collect online payments from the consumer's MPP account. The payment is safe as the consumer is prompted to complete authentication before confirming the payment.

Basic concepts

Terms (Abbreviations)

Definition

Acquiring Partner (ACQP)

An Acquiring Partner participating in Alipay+ Core or other acquirer cooperating with a member of Ant Group to enable payments.

Cashier Payment

An Online Payment product provided by Alipay+, whereby a Merchant redirects a User to the payment page of a Mobile Payment Partner to confirm the Transaction details and Authorise the Payment.

Merchant

A person that enters into a Transaction with a User which is acquired by an Acquiring Partner or an Indirect Acquiring Partner, as applicable.

Mobile Payment Partner (MPP)

A Mobile Payment Partner participating in Alipay+ Core or other user- or issuer-facing payment service provider cooperating with a member of Ant Group to enable payments.

QR Code

Quick Response Code as defined in ISO/IEC 18004.

Code value

Data that is encoded and stored in the QR code or barcode.

User experience

With Cashier Payment, the consumer can place an order on the merchant platform and select Alipay+ as the payment method. Then Alipay+ displays the available MPPs for the consumer to select and complete the payment on the selected MPP platform. After the payment is done, the consumer can return to the merchant platform.

For different MPP platforms, the user experience is different. The MPP platform can be a PC website (referred to as "Web" below) or a mobile app/WAP page (referred to as "Mobile" below).

  • If the consumer places the order on a Mobile page, the consumer is redirected to the MPP app or WAP page to continue the payment process.
  • If the consumer places the order on a Web page, the consumer is redirected to a Web page to continue the payment process.

Mobile

This section introduces the user experience of Cashier Payment on mobile platforms.

Scenario 1. Pay in the MPP app

In this scenario, the MPP app is installed on the consumer's phone.

After placing an order on the merchant side, the consumer is redirected to the MPP app to complete the payment. The following figure illustrates the user experience for this scenario:

image

Figure 1. Pay in the MPP app

The consumer performs the following steps to complete the payment:

  1. The consumer selects Alipay+ as the payment method on the merchant's order confirmation page.
  2. The Alipay+ sheet pops up and lets the consumer select an MPP to continue.
  3. The consumer clicks the pay button and is then redirected to the payment confirmation page in the MPP app. The consumer can check the payment information and adjust the balance or bank account to pay with.
  4. The consumer clicks the payment button and completes the verification to pay.
  5. The consumer confirms the payment result in the MPP app and returns to the merchant.

Scenario 2. Pay on the MPP WAP page

In this scenario, the MPP app is not installed on the consumer's phone.

After placing an order on the merchant side, the consumer is redirected to the MPP WAP page to complete the payment. The following figure illustrates the user experience for this scenario:

image

Figure 2. Pay on the MPP WAP page

The consumer performs the following steps to complete the payment:

  1. The consumer selects Alipay+ as the payment method on the merchant's order confirmation page.
  2. The merchant redirects the consumer to the Alipay+ checkout page to select an MPP to continue.
  3. The merchant redirects the consumer to the MPP page to log in.
  4. The consumer logs in and is then redirected to the MPP's payment confirmation page (WAP page). The consumer can check the payment information and adjust the balance or bank account to be paid with.
  5. The consumer clicks the payment button to pay.
  6. The consumer confirms the payment result on the MPP WAP page and returns to the merchant

Note: If the MPP does not support payment on WAP pages, instruct the consumer to download the MPP app.

Web

This section introduces the user experience of Cashier Payment on Web platforms. Depending on whether the MPP app supports code scanning, the payment experience varies:

  • If the MPP app supports code scanning, the consumer scans the code and completes the payment by using the MPP app.
  • If not, the consumer is redirected to a series of WAP pages to go through the payment process, including logging in and paying with a password.

Scenario 3. Scan to pay

Conditions:

  • The consumer places an order on the merchant's desktop website.
  • The wallet that the consumer pays with supports scan-to-pay

After placing an order on the merchant Web page, the consumer is redirected to the Alipay+ checkout page, where the consumer uses the MPP app to scan the QR code to pay. The following figure illustrates the user experience:

image

Figure 3. Scan to pay

The consumer performs the following steps to complete the payment:

  1. The consumer selects Alipay+ as the payment method on the merchant's order confirmation page.
  2. The consumer is redirected to the Alipay+ checkout page, where the supported wallets are displayed. The consumer selects one wallet and then a QR code is displayed.
  3. The consumer opens the corresponding MPP app on his or her phone to scan the QR code.
  4. The MPP app displays the payment confirmation page. The consumer can check the payment information and adjust the balance or bank account to pay with.
  5. The consumer completes the payment after verification.
  6. The MPP app displays the payment result.
  7. The merchant Web page displays the payment result.

Scenario 4. Log in to pay

Conditions:

  • The consumer places an order on the merchant's desktop website.
  • The wallet that the consumer pays with does not support scan-to-pay.

After placing an order on the merchant side, the consumer is redirected to the Alipay+ checkout page. The consumer then selects an MPP and logs in to the MPP page to pay. The following figure illustrates the user experience:

image

Figure 4. Log in to pay

The consumer performs the following steps to complete the payment:

  1. The consumer selects Alipay+ as the payment method on the merchant's order confirmation page.
  2. The consumer is redirected to the Alipay+ checkout page, where the supported wallets are displayed. The consumer selects one wallet and then the log-in-to-pay button is displayed.
  3. The consumer clicks the pay button and is then redirected to the MPP page to log in.
  4. The consumer completes the payment after verification.
  5. The MPP displays the payment confirmation page. The consumer can check the payment information and adjust the balance or bank account to pay with.
  6. The MPP displays the payment result page and redirects the consumer back to the merchant.

Product functionalities

Cashier Payment offers the following main features to facilitate your business:

Payment

The following functionalities related to the payment are provided:

  • One-time online payment: Consumers can pay each transaction with the MPPs worldwide.
  • SDK & Non-SDK solution: The MPPs can integrate Alipay+ APIs or Alipay+ SDKs for Cashier Payment. The SDKs assist the MPPs with order code identification and redirecting the consumers back to the merchant.

Post payment

The following functionalities related to the processes after payment are provided:

  • Payment result inquiry: The MPP can send the payment result to Alipay+ on Alipay+'s inquiry about the payment status.
  • Payment result notification: When the MPP confirms that the payment is successful, Alipay+ actively pushes the payment result to the ACQP, who can then relay the result to merchants.
  • Refund & cancellation: Consumers can refund or cancel a payment made with the MPP.

Business operations

The following functionalities related to business operations are provided:

  • One-stop settlement: Alipay+ provides a unified funds clearing and settlement service for the MPPs. Instead of mutual settlement, the MPPs only need to settle with Alipay+, which greatly simplifies the funds processing and improves the settlement efficiency.
  • Alipay+ Partner Workspace: Alipay+ Partner Workspace is a platform where the MPPs can execute operational tasks related to the Alipay+ business, which includes transaction management, risk management, account management, dispute handling, and integration.
  • Alipay+ Center: Alipay+ Center is a value-added module that can be added to the MPP app to enhance users' cross-border payment experience. It consists of Alipay+ brand introduction, payment-related services, and user incentives.

How it works

The following figure illustrates the main process of how Cashier Payment works:

image

Figure 5. Alipay+ Cashier Payment workflow

Cashier Payment workflow contains the following key steps: 

  1. The MPP provides the cashier base URL to Alipay+. (Step 1)
  2. The merchant/ACQP redirects the user to the MPP. (Step 6)
  3. The MPP decodes the Alipay+ code by calling the userInitiatedPay API. (Step 7)
  4. The MPP renders and displays the checkout page after getting all payment details from Alipay+. (Step 9)
  5. The MPP notifies Alipay+ of the payment result by calling the notifyPayment API. (Step12)

Notes:

If the MPP has integrated the Alipay+ SDK, the SDK works in the following steps:

  • A+ Server SDK helps with recognizing the code. (Step 7)
  • A+ client SDK helps with the redirection. (Step 11)

Page detail requirements

This section introduces the requirements of the page details for the following two important pages for Cashier Payment:

  • Payment Confirmation Page
  • Payment Result Page
  • Transaction Detail Page

Payment Confirmation Page

The following figure illustrates the fields that can be displayed on the Payment Confirmation Page for Cashier Payment.

image

Figure 6. Fileds for Payment Confirmation Page

The following table lists additional information about the fields in figure 6. Information on all of the fields in the table can be obtained from the related payment APIs.

If the fields in the following table are available, the fields must be provided on the Payment Confirmation Page.

Field

Description

Merchant name

The display name of the merchant.

Order amount

The order amount.

Exchange rate

The exchange rate. Used when the order currency differs from the user's payment currency. See Currency & exchange rate for details about how to display the exchange rate.

Payment amount

The amount that the user pays.

Alipay+ discount

The amount of the discount from Alipay+.

Payment Result Page

The following figure illustrates the fields that can be displayed on the Payment Result Page for Cashier Payment.

image

Figure 7. Fields for Payment Result Page

The following table lists additional information about the fields in figure 7. Information on all of the fields (except the Alipay+ brand) in the table can be obtained from the related payment APIs.

If the fields in the following table are available, the fields must be provided on the Payment Result Page.

Field

Description

Payment result

The payment result.

Payment amount

The amount that the user pays.

Merchant name

The display name of the merchant.

Order amount

The order amount.

Exchange rate

The exchange rate. Used when the order currency differs from the user's payment currency. See Currency & exchange rate for details about how to display the exchange rate.

Alipay+ discount

The amount of the discount from Alipay+.

Alipay+ brand

The image asset of Alipay+ brand. To obtain the asset, see Alipay+ Brand Mark Assets.

Transaction Detail Page

The following figure illustrates the fields that can be displayed on the Transaction Detail Page, which includes the information about a completed transaction.

image

Figure 8. Fields for Transaction Detail Page

The following table lists additional information about the fields in figure 8. Information on all of the fields (except the Alipay+ brand) in the table can be obtained from the related payment APIs.

If the fields in the following table are available, the fields must be displayed on the Transaction Detail Page.

Field

Description

Payment result

The payment result.

Payment amount

The amount that the user pays.

Merchant name

The display name of the merchant.

Transaction No.

Transaction No assigned by merchant side.

Alipay+ discount

The amount of the discount from Alipay+.

Get started

To get started with Cashier Payment integration, see Integration in the Cashier Payment integration guides.