URLs for payment redirection
Alipay returns URLs from the pay (Cashier Payment) API to redirect users to the cashier page of a payment method. These URLs are categorized into five types by device types, and the five types of URLs are further categorized into several subtypes by user experiences. The following table provides the description and code of each subtype of the URLs:
URL type | Subtype code | Description |
orderCodeForm | QRCODE | It contains a set of QR code pictures. It is applicable to a code-scanning payment scenario. |
schemeUrl | SCHEME | An application URL. It is used to invoke a payment method app for users to complete a payment. It cannot be opened as a mobile website. |
normalUrl | PC-H5 | A URL that can be opened on a PC. It allows users to pay with a payment method account on a Web page. |
PC-H5(QRCODE) | A URL that can be opened on a PC. It displays a QR code on a Web page and allows users to pay via scanning the code by using a payment method app. | |
H5 | A URL that can be opened on a mobile device. It allows users to pay with a payment method account on a mobile website. | |
H5-SCHEME | A URL that can be opened on a mobile device. However, it only allows users to pay in the payment method app through the redirection from a WAP page. | |
applinkUrl | AL/UL(H5) | An App Link or Universal Link. It can invoke a payment method app as well as be opened as a WAP page. Users can choose to log in to pay on the WAP page or in the app. |
AL/UL(H5-SCHEME) | An App Link or Universal Link. It can invoke a payment method app as well as be opened as a WAP page. However, it only allows users to pay in the app through the redirection from a WAP page. | |
AL/UL(H5|H5-SCHEME) | An App Link or Universal Link. It can invoke a payment method app as well as be opened as a WAP page. Users can choose to log in to pay on the WAP page or in the app through the redirection from a WAP page. |
The URL returned by Alipay varies by the value of terminalType that you specify in the pay API. See the following sections for details:
terminalType is WEB
If the value of terminalType is WEB ，the URLs supported by Alipay+ payment methods are shown in the following table:
Payment methods | orderCodeForm | schemeUrl | applinkUrl | normalUrl |
GCASH | QRCODE | ❌ | ❌ | PC-H5(QRCODE) |
DANA | QRCODE | ❌ | ❌ | PC-H5 |
TNG | QRCODE | ❌ | ❌ | PC-H5(QRCODE) |
TRUEMONEY | QRCODE | ❌ | ❌ | PC-H5(QRCODE) |
ALIPAY_HK | QRCODE | ❌ | ❌ | PC-H5(QRCODE) |
ALIPAY_CN | QRCODE | ❌ | ❌ | PC-H5(QRCODE) |
KAKAOPAY | QRCODE | ❌ | ❌ | PC-H5(QRCODE) |
terminalType is APP
If the value of terminalType is APP ，the URLs supported by Alipay+ payment methods are shown in the following table:
Payment methods | orderCodeForm | schemeUrl | applinkUrl | normalUrl |
GCASH | QRCODE | ❌ | AL/UL(H5) | H5 |
DANA | QRCODE | ❌ | AL/UL(H5) | H5 |
TNG | QRCODE | ❌ | AL/UL(H5) | H5 |
TRUEMONEY | QRCODE | ❌ | AL/UL(H5-SCHEME) | ❌ |
ALIPAY_HK | QRCODE | ❌ | AL/UL(H5|H5-SCHEME) | ❌ |
ALIPAY_CN | QRCODE | SCHEME | ❌ | H5-SCHEME |
KAKAOPAY | QRCODE | ❌ | AL/UL(H5-SCHEME) | H5-SCHEME |
terminalType is WAP
If the value of terminalType is WAP ，the URLs supported by Alipay+ payment methods are shown in the following table:
Payment method | orderCodeForm | schemeUrl | applinkUrl | normalUrl |
GCASH | QRCODE | ❌ | AL/UL(H5) | H5 |
DANA | QRCODE | ❌ | AL/UL(H5) | H5 |
TNG | QRCODE | ❌ | AL/UL(H5) | H5 |
TRUEMONEY | QRCODE | ❌ | AL/UL(H5-SCHEME) | ❌ |
ALIPAY_HK | QRCODE | ❌ | AL/UL(H5|H5-SCHEME) | ❌ |
ALIPAY_CN | QRCODE | SCHEME | ❌ | H5-SCHEME |
KAKAOPAY | QRCODE | ❌ | AL/UL(H5-SCHEME) | H5-SCHEME |
Note: For ALIPAY_CN and KAKAOPAY, the home app or WAP page of the payment method app instead of a merchant app or WAP page is displayed after a user completes a payment.