Alipay+Alipay+

Overview

The TSP mode is an innovative integration mode that is provided by Alipay+ for its Acquiring Service Provider (ACQPs). In this mode, ACQPs can obtain Alipay+capabilities by authorizing their Technical Service Providers (TSPs) to integrate Alipay+ payment products.

Basic concepts

The following terms are used in this document:

  • Acquiring Service Provide (ACQP): An institution that processes payments on behalf of merchants by integrating Alipay+ products.
  • Technical Service Provider (TSP): An institution that offers technical services, such as development and testing, to ACQPs.
  • Alipay+ Developer Center: An Alipay+ platform that provides one-stop integration experience for developers, with a series of development tools and resources.

Benefits

The following list shows the major benefits of applying the TSP mode for the integration:

Lower internal technical inputs

Technical inputs are required for every integration. Specializing in providing technical skills, resources, and tools, TSPs can help ACQPs who are lacking in technical resources to save their time and costs.

Diverse integration portfolios

For ACQPs who operate their businesses in various countries and regions, they may need different integration portfolios. By cooperating with multiple TSPs, diverse integration solutions can be built to meet their commercial needs.

Broader merchant resources

Moreover, for integration testing, TSPs are allowed and recommended to invite their own, local merchants. ACQPs thus can leverage TSPs' resources to access and acquire more merchants.

Features

In TSP mode, ACQPs can obtain two kinds of Alipay+ capabilities: payment capabilities and supporting capabilities.

Payment capabilities

Alipay+ offers the capabilities to invoke and accept payments to ACQPs with the following four payment products:

  • Cashier Payment: For more information about how to integrate Cashier Payment, see Cashier Payment.
  • Auto Debit: For more information about how to integrate Auto Debit, see Auto Debit.
  • User-presented Mode Payment: For more information about how to integrate User-presented Mode Payment, see User-presented Mode Payment.
  • Merchant-presented Mode Payment: For more information about how to integrate Merchant-presented Mode Payment, see Merchant-presented Mode Payment.

Supporting capabilities

By integrating the payment products, TSPs also help ACQPs to obtain the following supporting capabilities:

  • Post-payment actions: After making a payment, further actions might be required, such as inquiry, cancellation, and refund. In light of this, Alipay+ provides APIs for post-payment actions. For more information about how to use these APIs, see inquiryPayment, cancelPayment, and refund.
  • Merchant registration: In certain countries or regions, for legal or compliance reasons, the merchant information that is related to a payment must be registered before this payment can be processed. In light of this, Alipay+ provides APIs for merchant registration. For more information about how to register a merchant, see Registration.
  • Dispute handling: To enable Partners to resolve disputes, Alipay+ provides APIs for initiating and responding to disputes after payments. For more information about how to use these APIs, see Dispute.
  • Customs declaration: For payments that are processed by the AlipayCN wallet, customs declarations are required. In light of this, Alipay+ provides APIs for customs declaration. For more information about how to use these APIs, see Customs.

How it works

In TSP mode, the following roles are involved:

  • Merchant: A company or individual that trades on goods or services.
  • Acqurer: An institution that processes payments on behalf of merchants, also called ACQP.
  • TSP: An institution that offers technical services, such as development and testing, to ACQPs.
  • Alipay+: Alipay+ solution is a collaborative effort along with all Partners to provide more open, digitalized, and inclusive financial services to worldwide consumers and merchants.
  • Mobile Payment Provider (MPP): In TSP mode, MPP is normally a digital wallet, such as GCash.

image

Figure 1. Alipay+ payment workflow in TSP mode

Take User-presented Mode Payment as an example, the payment workflow in TSP mode consists of the following steps:

  1. The Merchant scans the payment code that is displayed on an MPP's app to collect payments.
  2. The Merchant sends a payment request to the ACQP, and the ACQP sends a payment request to the TSP.
  3. The TSP sends a payment request to Alipay+ by calling the pay API. When calling the pay API, take the following things into consideration:
    • In the request header, the TSP must specify the Agent-Token parameter to inform Alipay+ that the request is initiated by a TSP. For more information about how to customize the request header, see Request header.
    • In the request body, the TSP needs to specify the splitSettlementId parameter if the ACQP needs to split its settlement for transactions in one currency and one region into multiple batches.

Important: When calling other Alipay+ APIs, the TSP must also specify the Agent-Token parameter in the request header. The values of this parameter for the sandbox and the production environment are different. Obtain them by taking different actions:

  • Sandbox: Obtain the value from the Test Token field on the Sandbox > Settings page on the Alipay+ Developer Center. For more information, see Receive sandbox resources.
  • Production: Obtain the value from the Token column on the Launch > Authorization page on the Alipay+ Developer Center. For more information, see How to check the authorization status.
  1. Alipay+ verifies the value of Agent-Token, decodes the payment code, and then sends a payment request to the MPP.
  2. The MPP processes the payment request and notifies Alipay+ of the payment result.
  3. Alipay+ sends the payment result to the TSP by calling the notifyPayment API.
  4. The TSP sends the payment result to the ACQP, and the ACQP sends the payment result to the Merchant.