With Merchant-presented Mode Payment, the consumer scans the QR code presented by the merchant to initiate a payment. The QR code can either be a dynamic order code or a static entry code.

Basic concepts

The following key terms are used in this document:

User experience

The Merchant-presented Mode Payment product provides a user experience where a consumer can scan a QR code, which might be an order code or entry code, that is presented by the merchant to complete the payment. In certain cases, the consumer might be prompted to complete authentication during the payment, such as entering the payment password.

The user experience differs depending on the QR code type.

Order code

The following figure illustrates the user experience of Merchant-presented Mode Payment where the QR code is an order code:

Figure 1. Merchant-presented Mode Payment (order code) user experience

The user experience consists of the following steps:

1. The consumer scans the order code the merchant presents.
2. The consumer is redirected to the payment confirmation page in the MPP app and confirms to pay.
3. The payment result page is presented to the user in the MPP app.

Entry code

The following figure illustrates the user experience of Merchant-presented Mode Payment where the code is an entry code:

Figure 2. Merchant-presented Mode Payment (entry code) user experience

The user experience consists of the following steps:

1. The consumer scans the entry code that the merchant presents.
2. The consumer is redirected to the merchant's cashier page and enters the payment amount.
3. The consumer is redirected to the payment confirmation page in the MPP app and confirms to pay.
4. The payment result page is presented to the user in the MPP app.
5. The consumer is redirected back to the merchant page.

Product functionalities

The Merchant-presented Mode Payment product provides several capabilities to facilitate your business.

Payment

• Accept a payment: The MPP takes a series of integration steps to ensure the user completes the payment.
• Global code identification: With both dynamic and static QR codes supported, Alipay+ maintains code rules of various countries, which helps the MPP easily reach out to worldwide merchants.
• Promotion provided: With this product, the MPP can directly offer promotional discounts that are provided by Alipay+ to consumers who use the MPP app to pay.
• Multiple currencies supported: With cross-border settlement supported, the MPP can make payments in multiple currencies across the world, as well as allow its consumers to pay in their local currencies.
• 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 push the payment result to the ACQP, who can then relay the result to merchants.

Post payment

• Refund: MPPs support both full and partial refunds.
• Cancellation: MPPs support transaction cancelations that are requested by ACQPs within the cancellable period.

Business operations

• 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 interaction between different parties differs depending on the QR code type.

Order code

The following figure illustrates the Merchant-presented Mode Payment workflow when the QR code is an order code:

Figure 3. Merchant-presented Mode Payment (order code) workflow

The workflow contains the following steps:

1. The consumer uses the MPP app to scan the QR code that is presented by the merchant.
2. The MPP app identifies the code value and sends the code value to Alipay+ for decoding.
3. Alipay+ sends the decoding result to the merchant/ACQP and the merchant/ACQP returns the order information.
4. Alipay+ sends the payment request to the MPP.
5. The MPP renders the payment information and the consumer confirms to pay.

Entry code

The following figure illustrates the Merchant-presented Mode Payment workflow when the QR code is an entry code:

Figure 4. Merchant-presented Mode Payment (entry code) workflow

The workflow contains the following steps:

1. The consumer uses the MPP app to scan the QR code that is presented by the merchant.
2. The consumer is redirected to the merchant's cashier page and enters the payment amount.
3. The merchant/ACQP redirects the user to the Alipay+ URL based on the code value.
4. Alipay+ decodes the code value and sends the decoding result to the merchant/ACQP, and then the merchant/ACQP returns the order information.
5. Alipay+ sends the payment request to the MPP.
6. The MPP renders the payment information and the consumer confirms to pay.

Page Details Requirements

This section introduces the requirements of the page details for the following two important pages for Merchant-presented Mode Payment:

• Payment Confirmation Page
• Payment Result Page

Payment Confirmation Page

The following figure illustrates the fields that can be displayed on the Payment Confirmation Page for Merchant-presented Mode Payment.

Figure 5. 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 APIs.

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

Payment Result Page

The following figures illustrate the fields that can be displayed on the Alipay+ Payment Code Page for Merchant-presented Mode Payment.

Figure 6. Fields for Payment Result Page - payment succeeds

Figure 7. Fields for Payment Result Page - payment fails

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 APIs.

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

Transaction Detail Page

The following figure illustrates the fields that can be displayed on the Transaction Detail Page for Merchant-presented Mode Payment.

Figure 8. Fields for Transaction Detail Page

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

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

Get started

To get started with the integration of the Merchant-presented Mode Payment functionalities, see Integration overview for Merchant-presented Mode Payment.