The third-party merchant QR Code payment solution uses a static QR code that is issued by Alipay acquirer for merchants to complete payments. In this payment solution, customers need to scan the QR code and then enter the payment amount to complete the transaction.

To provide such a payment service, Alipay merchants need to integrate with Alipay system through the interfaces that are developed for these payment solutions.  

Target audience

This document targets at the technical person who is intending to integrate with the third-party merchant QR code payment solution.

Terms and definitions

QR code

Quick Response code (QR code) consists of black squares arranged in a square grid on a white background, which can be read by an imaging device and processed. The required data are then extracted from patterns that are present in both horizontal and vertical components of the image, as depicted below.

In this third-party merchant QR Code payment solution, the merchant can use a static QR code to represent their cashier account.

Interface

In this context, the interface is the channel that the Alipay system provides the relevant service by invoking the corresponding APIs with the required parameter values. Throughout this guide, we may use interface and serive interchangeably.

Alipay user ID

The unique ID of an Alipay user. The ID is a string beginning with 2088.

Alipay web-based authorization page

An https authorization page such as https://openauth.alipay.com/oauth2/publicAppAuthorize.htm?app_id=APPID&scope=SCOPE&redirect_uri=ENCODED_URL

Users are directed to the authorization page to obtain an auth_code and be redirected to the callback page designated by redirect_uri. With the auth_code, developers can then obtain the user’s Alipay ID.

Web-based authorization callback page

The callback page URL that is enclosed in redirect_uri. Normally, the link is the same as the one that developers provided on Alipay Open Platform. Using this URL, developers can receive the auth_code to exchange the Alipay user ID.

UA (user-agent string)

In HTTP protocols, a characteristic identification string that is transmitted in a http request header field User-Agent.

Product flow

The following graphic shows the work flow of the third-party merchant QR code payment solution.

Process:

1. A user approaches the cashier, and then opens Alipay to scan the QR code presented by the merchant to pay the bill.
2. The merchant renders the H5 payment page.
3. The user enters the payment amount and then submits to pay.
4. The merchant sends a request to Alipay to create the payment transaction.
5. The user confirms to pay.
6. After the payment succeeds, Alipay notifies the user and acquirer of the successful payment result separately. The acquirer then further sends the result to the merchant through its own channel.

User experience

Customers scan a static QR code, and the third-party merchant QR code payment solution is activated. Customers need to scan the QR code provided by merchants, enter the payment amount, and enter the password before completing the payment. The payment process is as illustrated below.

Note:

Customers need to be connected with the Internet when using the third-party merchant QR code payment solution.