This guide provides general steps for Acquiring Service Providers (ACQPs) to go through the whole integration process in Technical Service Provider (TSP) mode. Read this topic to get started with Alipay+ integration.
The integration process in TSP mode consists of the following phases (see Figure 1):
- Phase 1: In this phase, TSPs can integrate Alipay+ payments products within 4 steps. See Step 1 ~ Step 4.
- Phase 2: In this phase, TSPs can invite their merchants for integration testing with an application provided by Alipay+. This phase is optional but recommended. See Step 5.
[ACQP] Prepare for integration3 steps Collapse all Expand all
1. Apply for a TSP accountMark the card Unmark the card
Before taking further actions for the integration, the ACQP needs to apply an account for its TSP. Contact our Solution Architect (SA) team, provide related information and acquire a TSP account. For more about the information that is required, see TSP information checklist.
2. Read integration guidesMark the card Unmark the card
Log in to the Alipay+ Docs Center and read the corresponding integration guides for the Alipay+ products. These guides help both ACQPs and their TSPs go through various Alipay+ products and understand integration workflows.
3. Plan for integrationMark the card Unmark the card
After reading the integration guides, work with our SA team to make an integration plan. Our SA team will help ACQPs figure out the integration scope, for example, which capabilities are required to be integrated and which are optional.
Develop and integrate6 steps
Alipay+ provides the Alipay+ Developer Center and other tools to help facilitate application development and integration. In TSP mode, follow the instructions described in the Alipay+ Developer Center User Guide for TSPs to perform the self-integration process, which includes the main steps below.
1. [TSP] Log inMark the card Unmark the card
With the account that is provided by the ACQP, the TSP can go to the Alipay+ Developer Center and log in. Different TSP accounts may have different roles and permissions. For more information, see the Log in chapter in Alipay+ Developer Center User Guide for TSPs.
2. [TSP] Create an applicationMark the card Unmark the card
Create an application and specify the products to be integrated. Follow these steps:
a. Complete application information
b. Select products
c. Check application information
3. [TSP] Develop in the sandboxMark the card Unmark the card
Simulate and test open APIs in the sandbox environment with provided test cases. This step helps ensure that the application can go live more smoothly. Follow these steps:
a. Receive sandbox resources
b. Configure the sandbox
c. Test with development tools
4. [TSP] Conduct sandbox acceptance testingMark the card Unmark the card
After free tests in the sandbox, the TSP needs to pass all required test cases that are provided by Alipay+, which is called sandbox acceptance testing. Follow these steps:
a. Check configurations in sandbox
b. Perform testing with test cases
Note: For test cases that require calling Alipay+ APIs, the TSP needs to specify the Agent-Token parameter in the request header.The value of this parameter can be obtained on the Sandbox Resources page of the Alipay+ Developer Center.
5. [TSP&ACQP] Authorize applicationMark the card Unmark the card
Once all required test cases are passed, the TSP needs to invite the ACQP to authorize the application. Follow these steps:
a. [TSP] Check role and permissions
b. [TSP] Generate authorization URL
c. [TSP] Send authorization URL to ACQP
d. [ACQP] Authorize application
6. [TSP] Launch into productionMark the card Unmark the card
Once the application is authorized, the TSP can launch the application into the production environment. Follow these steps:
a. Configure for production environment
b. Launch application
[TSP] Conduct production acceptance testing
Once the TSP launches the application, our SA team will check if all preconditions that are required for production acceptance testing are met, and contact the TSP to conduct production acceptance testing.
[TSP] Start your business
Once the application has been activated for business, let the ACQP notify Alipay+ so that we can monitor your system's behavior and check for any unpredictable errors that might affect your business.
In addition, in TSP mode, an ACQP can cooperate with either one TSP or multiple TSPs for its integrations. For these two scenarios, Alipay+ provides two reconciliation modes respectively for the ACQP to perform clearing and settlement.
For more information about reconciliation, see Reconcile.
[ACQP] Invite merchants for integration testingCollapse all Expand all
The Alipay+ Developer Center allows and recommends TSPs to invite one or multiple merchant(s) to further test the applications via Alipay+ Linker, a mobile application that is used to run test cases and simulate the process of making payments.
For more information, see the following documents: