Code Format Specification

Payment code (for UPM)

Code format

An Alipay+ Payment Code is a string composed of a Prefix Block and a User Identification Number (UIN), as follows:

Figure 1 – General Format of Alipay+ Payment Code

An Alipay+ Payment Code has the following constraints:

• All the characters are numeric.
• The length of the code varies from 17 to 32 digits.
• Codes with a length range from 20 to 23 and 25 to 32 are reserved for future use.

The mainstream Alipay+ Payment Code format currently in use is a 24-digit numeric string, composed of a 6-digit Code Issuer Identifier (CII), a 2-digit Business Type Identifier (BTI), and a 16-digit UIN.

Figure 2 - Format of Mainstream Alipay+ Payment Code

The CII and BTI are assigned or defined by Alipay+, and the UIN is defined by the code issuer itself to identify a particular User in its own account system.

For security reasons, the UIN should not contain any private information of the corresponding User, for example, bank card numbers, or national ID numbers.

Legacy Payment Codes that fulfill the following rules are also used in Alipay+:

Table 1 –Alipay+ Legacy Payment Code

Code example

Here is an example Alipay+ Payment Code.

The code value is:

2510 0102 0123 4567 8901 2345

The length of the Payment Code is 24 digits, the first 6 digits 251001 are the CII, the 7th to 8th digit 02 is the BTI (indicating this is a Payment Code used in UPM scenarios), and the last 16 digits 0123456789012345 are the UIN.

If this code value is symbolized into a barcode (1-dimension), the code image is like this:

Note: refer to

ISO/IEC 15417: 2007, Information technology — Automatic identification and data capture techniques — Code 128 bar code symbology specification

If this code value is symbolized into a QR code (2-dimension), the code image is like this:

Note: refer to

ISO/IEC 18004: 2015, Information technology -- Automatic identification and data capture techniques - QR-code bar code symbology specification

Collection code (for MPM)

Code format

An Alipay+ Collection Code is a string in the form of a URL, as follows:

Figure 3 – General Format of Alipay+ Collection Code

where:

• https://: is the default prefix to indicate the recommended network protocol. This field is case-insensitive.
• Domain Name: also known as network domain, is the name of a computer or group of computers on the Internet. The domain name is presented as a string of dot-separated names. It can be used to identify Internet resources, such as computers, networks, and services. This field is a string type with a variable length. It is defined by the code issuer itself and registered to Alipay+. This field is case-insensitive.
• Code Issuer Identifier (CII): a 6-digit numeric string assigned by Alipay+ to identify a code issuer.
• Business Type Identifier (BTI): a 2-digit numeric string defined by Alipay+ to indicate the intended business type.
• Object Identification Number (OIN): a 16-digit numeric string defined by the code issuer itself to identify a merchant, a store, a purchase order, etc., depending on the intended business type.

When a Collection Code is symbolized into a QR code image, the longer the code string is, the denser the code image appears. An extra dense QR code image should be avoided because it is difficult to resolve, therefore user experience may deteriorate. Although the capacity of a QR code is larger than a 1-dimension barcode, the length of a Collection Code should still be limited in practice, see Use a shorter code string for more details.

Code example

Here is an example Alipay+ Collection Code.

The code value is:

https://qr.yourdomian.com/281001051234567812345678

where:

• Domain Name: qr.yourdomain.com
• Code Issuer Identifier (CII): 281001.
• Business Type Identifier (BTI): 05 (indicating this is a Collection Code – Entry Code).
• Object Identification Number (OIN): 1234567812345678.

When this code value is symbolized into a QR code (2-dimension), the code image is like this:

Note: refer to

ISO/IEC 18004: 2015, Information technology -- Automatic identification and data capture techniques - QR-code bar code symbology specification

Common identifiers

Code Issuer Identifier (CII)

A Code Issuer Identifier (CII) is a 6-digit numeric string assigned by Alipay+ to identify a code issuer, which in Alipay+ is either an MPP or an ACQP. Each code issuer can apply for one or more CII(s).

The following CIIs have been allocated:

Last updated on September 6, 2022

Table 2 – Alipay+ CIIs

* The names of the code issuers are de-identified in this table.

Contact us to get the latest formal version of the CII table.

Contact the Alipay+ Solution Architect to apply for a CII.

Business Type Identifier (BTI)

Alipay+ recognizes the following Business Type Identifiers (BTI) as part of the Alipay+ Payment Codes (for UPM) and Collection Codes (for MPM):

Last updated on September 6, 2022

Table 3 – Alipay+ BTIs assigned for code-scanning payment

Alipay+ also recognizes the following Business Type Identifiers (BTI) which are related to but may not be part of the Alipay+ Payment Codes (for UPM) and Collection Codes (for MPM):

Last updated on September 6, 2022

Table 4 – Alipay+ BTIs related to code-scanning payment