Alipay+ DocsAlipay+ Docs

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

  1. Merchant's cashier page
  2. Alipay+ wallet list page
  3. Wallet's payment confirmation page

For all terminal types

  1. Merchant's cashier page
  2. Alipay+ checkout page
  3. Wallet's payment confirmation page

For apps with native SDK

  1. Merchant's cashier page
  2. Prebuilt payment sheet at the merchant side
  3. 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.

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.

  1. Integrate your SDK with Alipay+ SDK.
  2. 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

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.

  1. Create an SDK based on Alipay+ SDK.
  2. 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.