Integration overview
This topic introduces the functions that Alipay+ Merchant-presented Mode Payment (Push Mode) provides and guides you (the ACQP) through how to use the Alipay+ APIs to build an integration for these functions.
Before you begin
Before you learn more about how to integrate with Merchant-presented Mode Payment, ensure that you are familiar with the following things:
- The user experience that Merchant-presented Mode Payment can provide to the consumers. For more information, see Product introduction.
- General steps that you need to take to go through the whole integration process. For more information, see Get started with Alipay+ integration.
Build an integration
Use the APIs that are provided by Alipay+ to integrate the following Merchant-presented Mode Payment functions as required:
Accept a payment
Depending on the type of the QR code, you need to take the following steps to accept payments from users:
- Create an entry code/private order code that represents the merchant/order.
- Decode the code and return the merchant/order information when receiving the userInitiatedPay request from Alipay+.
- Process the payment and return the result when receiving the pushPayment request from Alipay+.
For more information about how to integrate related APIs to accept a payment, see Accept a payment.
Return the payment result
To return the payment result to Alipay+, you need to integrate the inquirePushPayment API and can optionally integrate the notifyPushPayment API. For more information about how to integrate the APIs, see Return the payment result.
Refund
To support the users in refunding payments, you need to integrate the refund API. For more information about how to integrate the API, see 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.
Reconcile
Alipay+ provides multiple types of reconciliation reports to help you 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 reconciliation reports. For more information, see Reconcile.
Register a merchant
In certain countries or regions, for legal or compliance reasons, you need to register the merchant information before processing a payment. You can perform registration through APIs or in Alipay+ Partner Workspace.
- For more information about how to integrate related APIs for merchant registration, see Registration.
- For more information about how to register merchants in Alipay+ Partner Workspace, see Alipay+ Partner Workspace User Guide (ACQP) - Merchant Registration.
More information
Go through the sections below to obtain more information that empowers your integration:
- To ensure your integration with Alipay+ can work properly, you need to ensure that your outputs meet Alipay+ standards, such as logos displayed on payment terminals and payment receipts. For more information about the requirements, see Standard output checklist.
- 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 perform message signing and signature validation 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 more information, see Sign a request and validate the signature.
- For the full list of APIs that are provided for Merchant-presented Mode Payment, see API list.