Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution


If you have integrated with the New Third-party Merchant QR Code Payment product, see Entry Code Payment for details.


The Third-party Merchant QR Code payment solution is making use of a static QR code that issued by Alipay partners to represent the account of a merchant. In this payment solution, the customer needs to scan and then input the amount to complete the payment of transaction.

To provide such a payment service, Alipay partners need to integrate with Alipay system through the interfaces that are developed for this payment solution.

This guide provides an overview of the Third-party Merchant QR Code payment and it's overall workflow, and then introduces the detailed integration steps.

Target audience

This guide is intended for developers and testers of Alipay partners who want to integrate Alipay 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, a merchant can use a static QR Code to represent their cashier account.


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 service 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

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.