Upgrade from bundle mode

This topic introduces the user experience changes brought by the Alipay+ Unified Payment edition of Cashier Payment and lists the methods that you can choose to upgrade from Cashier Payment bundle mode to Cashier Payment Alipay+ Unified Payment edition.

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 consultPayment API 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

Upgrade the consultPayment API to consult the Alipay+ payment method information.
Upgrade the pay API to initiate payments to Alipay+.

For more information about the detailed changes of the APIs, 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.

Solution 2: By integrating your SDK with Alipay+ SDK

This solution allows you to either call the consultPayment API or call the Alipay+ SDK to consult the Alipay+ payment method information. Besides, you need to call the Alipay+ SDK to 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 consultPayment API to consult the Alipay+ payment method information.
Upgrade the pay API to initiate payments to Alipay+.

For more information about the detailed changes of the APIs, check the following excel file: 📎API_diff_bundle_VS_ unified(Cashier Payment).xlsx.

Integrate your SDK with Alipay+ SDK.
Call the showPaymentSheet API to open the prebuilt Alipay+ checkout page provided by the Alipay+ SDK.

For more information about how to open Alipay+ checkout page by integrating Alipay+ SDK, see Method 1: If ACQP has its own SDK.

For more information about the Alipay+ SDK, see SDK Reference.

Note: After your client side is integrated with the Alipay+ SDK, instead of calling the consultPayment API, you can also consult the Alipay+ payment method information by calling the inquirePaymentOption API provided by Alipay+ SDK.

For more information about how to consult payment method information with SDK, see Method 2: Integrate the Alipay+ SDK.

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

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

Server side

Client side

Upgrade the consultPayment API to consult the Alipay+ payment method information.
Upgrade the pay API to initiate payments to Alipay+.

For more information about the detailed changes of the APIs, check the following excel file: 📎API_diff_bundle_VS_ unified(Cashier Payment).xlsx.

Create an SDK based on Alipay+ SDK.
Call the showPaymentSheet API to open the prebuilt Alipay+ checkout page provided by the Alipay+ SDK.

For more information about how to open Alipay+ checkout page by creating an SDK, see Method 2: If ACQP has no SDK.

For more information about the Alipay+ SDK, see SDK Reference.

Note: After you create an SDK based on Alipay+ SDK, instead of calling the consultPayment API, you can also consult the Alipay+ payment method information by calling the inquirePaymentOption API provided by Alipay+ SDK.

For more information about how to consult payment method information with SDK, see Method 2: Integrate the Alipay+ SDK.