Alipay+ DocsAlipay+ Docs

Integration overview

Learn about the functions of Alipay+ Cashier Payment to plan your integration, and get a step-by-step guide about how to build the integration with the Alipay+ APIs and SDKs for these functions.

About this guide

This guide is for integrating the Unified Payment edition of Alipay+ Cashier Payment. For the tile mode edition, see the Cashier Payment tile mode guide.

Before you begin

Before you learn more about how to integrate with Alipay+ Cashier Payment, ensure that you are familiar with the following things:

  • The user experience that Alipay+ Cashier Payment can provide to the consumers.
  • General steps you need to take to go through the whole integration process.

Build an integration

Use the APIs and SDKs that are provided by Alipay+ to integrate the following Cashier Payment functions as required:

Accept a payment

To accept payments from users, you need to take the following steps:

  1. Render the payment method page with the information that is consulted from Alipay+.

The information mainly includes the logo and promotion information. You can consult the information by using the Alipay+ SDK or calling the Alipay+ CDN server according to your application scenario.

  1. Initiate a payment request by calling the pay API, and open the Alipay+ checkout page for the user to pay.

Depending on whether your merchant platform is an app, different integration options are provided:

    • If the merchant platform is an app, it is recommended to use the Alipay+ SDK to facilitate your integration.
    • If the merchant platform does not have an app or does not want to integrate an SDK, you can develop programming code with the payment URL.
  1. Handle the payment result that is obtained from Alipay+.

For more information about how to integrate related APIs or SDKs to accept a payment, see Accept a payment.

Obtain payment results

To obtain payment results from Alipay+, you need to integrate the inquirePayment and notifyPayment APIs. For more information about how to integrate the APIs, see Inquire about payment results and Receive payment notification.

Cancel and refund

To support the users in refunding and canceling payments, you need to integrate the refund and cancelPayment APIs. For more information about how to integrate the APIs, see Cancel a payment and Refund.

More operations

Apart from the payment-oriented functions that are mentioned above, Alipay+ provides more services and APIs for you to manage your business.

Alipay+ provides multiple types of transaction reports to help you to perform the clearing and settlement of transactions. To streamline your business workflows, you need to develop your reconciliation function module according to the production mechanism and specification of the transaction reports. For more information, see Reconcile.

More information

Go through the section below to obtain more information that empowers your integration:

  • To ensure your integration with Alipay+ can work properly, you also need to ensure your merchant meets the requirements in terms of Alipay+ brand and integration.
  • When using APIs to integrate, you need to take the following things into consideration:
    • Make a POST request to the corresponding address with the identity information, signature, and business parameters in the HTTP request. For more information about the structure of a request and response, see API overview.
    • To ensure the message transmission security, the ACQP must sign the request and validate the signature properly. When calling an Alipay+ API, the ACQP must sign the API request and validate the response signature accordingly; when receiving an API call from Alipay+, the ACQP must validate the request signature and sign the API response accordingly.
  • For the full list of APIs and SDKs that are provided for Cashier Payment, see APIs and SDKs.