Upgrade from Cashier Payment bundle mode

This topic is designed to help you upgrade Cashier Payment bundle mode to the Alipay+ Unified Payment edition. It introduces the user experience changes brought by the Alipay+ Unified Payment edition of Cashier Payment and lists the upgrade methods that are recommended by Alipay+ for you to complete the upgrade.

Overview

Compared with the bundle mode, the Alipay+ Unified Payment edition enhances the user experience and offers more features.

User experience

The Alipay+ Unified Payment edition makes paying on merchant platforms easier with a unified payment option. On the merchant's cashier page, the consumer can just select Alipay+ as the payment method, and then goes to the checkout page where they can select and use a preferred wallet to complete the payment.

For more information, see Product introduction.

The following table compares the user experiences that are provided by the bundle mode and Alipay+ Unified Payment edition:

Use experience	Bundle mode	Alipay+ Unified Payment
Alipay+ brand showcasing	Required	Required
Alipay+ promotion info display	Not supported	Required
Alipay+ wallets info	Displayed on the Alipay+ wallet list page for all terminal types	Displayed on the Alipay+ checkout page for all terminal types Displayed on the prebuilt payment sheet for apps with native SDK
User journey during payment initiation	Merchant's cashier page Alipay+ wallet list page Wallet's payment confirmation page	For all terminal types Merchant's cashier page Alipay+ checkout page Wallet's payment confirmation page For apps with native SDK Merchant's cashier page Prebuilt payment sheet at the merchant side Wallet's payment confirmation page

New features

The Alipay+ Unified Payment edition has the following new features:

Provide Alipay+ payment promotion information.
Provide a unified checkout page to display information about the various wallets supported by Alipay+. The checkout page can be rendered based on a payment URL for all terminal types and or be prebuilt as a payment sheet into your app after you integrate the Alipay+ SDK.

Upgrade guide

To upgrade to the Alipay+ Unified Payment edition, you need to upgrade the capability of accepting payments by using related Alipay APIs or SDKs.

For more information about how to accept payments with the Alipay+ Unified Payment edition, see Accept a payment.

Alipay+ recommends the following three upgrade solutions for you to upgrade the capability of accepting payments. You can choose the upgrade solution based on your terminal type and whether or not you have a native SDK.

Terminal type	Has native SDK	Want to use Alipay+ SDK	Upgrade solution
App	Yes	Yes	Solution 2: By integrating your SDK with Alipay+ SDK
	Yes	No	Solution 1: By upgrading Alipay+ APIs
	No	Yes	Solution 3: By creating an SDK based on Alipay+ SDK
	No	No	Solution 1: By upgrading Alipay+ APIs
WAP	-	-	Solution 1: By upgrading Alipay+ APIs
Web	-	-	Solution 1: By upgrading Alipay+ APIs

Solution 1: By upgrading Alipay+ APIs

This solution requires you to call the Alipay+ CDN server to consult the Alipay+ payment method information. Besides, you need to use the payment URL returned by Alipay+ to open the Alipay+ checkout page.

The following table describes the actions that your server side and client side need to take:

Server side

Client side

Call the Alipay+ CDN server to consult the Alipay+ payment method information. For more information, see Request JSON data from the Alipay+ CDN server.
Upgrade the pay API to initiate payments to Alipay+. For more information about the detailed changes of the API, check the following excel file: 📎API_diff_bundle_VS_ unified(Cashier Payment) .xlsx.

Use the payment URL (specified on the normalUrl parameter) returned in the pay API response to open the Alipay+ checkout page. For more information, see Open the Alipay+ checkout page.

Note: After the upgrade, you must use the normalUrl parameter to open the Alipay+ checkout page.

Note: You can also call the Alipay+ CDN server from your client side to consult the Alipay+ payment method information. For more information, see Request logo assets from the Alipay+ CDN server.

Solution 2: By integrating your SDK with Alipay+ SDK

This solution requires you to call the Alipay+ SDK to consult the Alipay+ payment method information and open the prebuilt Alipay+ checkout page.

The following table describes the actions that your server side and client side need to take:

Server side	Client side
Upgrade the pay API to initiate payments to Alipay+. For more information about the detailed changes of the API, check the following excel file: 📎API_diff_bundle_VS_ unified(Cashier Payment) .xlsx.	Integrate your SDK with Alipay+ SDK. Call the inquirePaymentOption API to consult the Alipay+ payment method information. For more information, see Integrate the Alipay+ SDK. Call the showPaymentSheet API to open the prebuilt Alipay+ checkout page provided by the Alipay+ SDK. For more information, see Method 1: If ACQP has its own SDK.

Note: You can also consult the Alipay+ payment method information by calling the Alipay+ CDN server. For more information, see Request JSON data from the Alipay+ CDN server and Request logo assets from the Alipay+ CDN server.

Solution 3: By creating an SDK based on Alipay+ SDK

This solution requires you to create an SDK based on the Alipay+ SDK. Then, you can call the SDK to consult the Alipay+ payment method information and open the prebuilt Alipay+ checkout page.

The following table describes the actions that your server side and client side need to take:

Server side	Client side
Upgrade the pay API to initiate payments to Alipay+. For more information about the detailed changes of the API, check the following excel file: 📎API_diff_bundle_VS_ unified(Cashier Payment) .xlsx.	Create an SDK based on Alipay+ SDK. Call the inquirePaymentOption API to consult the Alipay+ payment method information. For more information, see Integrate the Alipay+ SDK. Call the showPaymentSheet API to open the prebuilt Alipay+ checkout page provided by the Alipay+ SDK. For more information, see Method 2: If ACQP has no SDK.