Alipay+ DocsAlipay+ Docs

Upgrade to Alipay+ Unified Payment

This guide is designed to help you upgrade Auto Debit to the Alipay+ Unified Payment edition. It introduces the new experiences and features that are offered by this edition and lists the upgrade method that is recommended by Alipay+ for you to complete the upgrade.

Overview

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

User experience

The Alipay+ Unified Payment edition makes auto debit authorization on merchant platforms easier with a unified authorization procedure. On the merchant's cashier page or add payment method page, the consumer can just select Alipay+ as the payment method, and then goes to the Alipay+ wallet page where they can select a preferred wallet for account binding.

For more information, see Product introduction.

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

Integration step

Use experience

Tile mode

Alipay+ Unified Payment

Obtain the user authorization

Alipay+ brand display during authorization

Displayed by the selected wallet

Displayed by Alipay+

Alipay+ promotion info display

Not supported

Required

Alipay+ wallets info

Rendered by the merchant/ACQP

Rendered on the Alipay+ wallet page

User journey during account binding

  1. Merchant's cashier page or add payment method page
  2. Wallet's authorization page
  1. Merchant's cashier page or add payment method page
  2. Alipay+ wallet page
  3. Wallet's authorization page

Information about the wallet for account binding

Specified before account binding is initiated

Obtained after account binding is completed

Authorization result

Displayed by the selected wallet

Displayed by the selected wallet

Accept a payment

Alipay+ brand display during payment

Displayed by the selected wallet

Displayed by the selected wallet

User action during auto debit

Click to confirm payment

Click to confirm payment

New features

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

  • Provide Alipay+ payment promotion information.
  • Provide a unified Alipay++ wallet page to display information about the various wallets supported by Alipay+. The Alipay+ wallet page can be rendered based on a normal URL for all terminal types.

Upgrade guide

To upgrade to the Alipay+ Unified Payment edition, you need to upgrade the capabilities of obtaining the user authorization and accepting payments by using related Alipay APIs or SDKs.

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

Integration step

Server side

Client side

Obtain the user authorization

  • Upgrade the consultPayment API to consult the Alipay+ payment method information.
  • Upgrade the prepare API to obtain the Alipay+ wallet page URL.
  • Upgrade the applyToken API to request the access token.
  • Upgrade the authNotify API to receive the access token.

Note: After the upgrade, the consultPayment API no longer returns the logo information of wallets in the response. In this case, you need to contact our after-sales team to obtain the logo information of bound wallets.

For more information about the detailed changes of the APIs, check the following excel file: 📎API_diff_tile_VS_ unified(Auto Debit).xlsx

  • If the terminal type of your client side is Web or WAP, you can integrate the Alipay+ Web/WAP SDK to consult the Alipay+ payment method information, instead of calling the consultPayment API. For more information, see How to consult payment method information.
  • Use the URL (specified on the normalUrl parameter) returned in the prepare API response to open the Alipay+ wallet page. For more information, see Open the Alipay+ wallet page.
    • Note: After the upgrade, instead of using the schemeUrl, normalUrl, or applinkUrl parameter, you must use the normalUrl parameter to open the Alipay+ wallet page.

Accept a payment

  • Upgrade the pay API to initiate payments to Alipay+.

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