Using Alipay Domestic Services

 

All Alipay domestic payments are processed in Renminbi (RMB). You must capture the required billing and shipping information as part of the checkout process. Alipay does not provide this information to merchants. Alipay monitors their systems for problems; however, CyberSource recommends that you monitor their customer dropout rates.

Alipay Domestic Services

Initiate Payment Service

The initiate payment service illustrated in Figure 1 is described in detail below.

Figure 1

Initiate Payment Service

The Alipay domestic payments web site is a real-time payment solution enabling China- based merchants to trade in China. The payment process is as follows:

1	When ready to pay for a product selected from your web site, the customer clicks the Alipay customized pay button.

 

CyberSource recommends that you detect the customer’s payment device and include the appropriate value in the ap_payment_type field: APD for a web payment (personal computer or laptop) or ADM for a mobile payment (handheld device).

2	Using the CyberSource API, you POST the merchant details and order information from the initiate payment service request to CyberSource.

3	CyberSource creates a signed merchant URL. To redirect customers to their Alipay accounts for transaction processing, see Merchant URL Parameters. CyberSource sends the signed merchant URL back to you.

4	The customer is redirected to the URL that CyberSource sent to you in number 3. This URL directs the customer to their Alipay account.

5	The customer logs in to their Alipay account or creates a new account. The RMB amount is displayed. The payment is not visible to you as the merchant, and the customer can cancel without your knowledge. The customer pays in RMB for a purchase from a domestic e-commerce web site.

6	Alipay accepts the payment request and sends payment notification to CyberSource that the payment is complete. Alipay withdraws the payment from the customer’s account in real time and remits the funds to the domestic merchant account in settlement.

7	CyberSource stores the payment status. You can retrieve the payment status by requesting the check status service. See Check Status Service.

8	The customer’s browser is redirected to the return URL that is specified during merchant boarding. Alipay recommends that you ignore the HTTP GET information indicating the transaction result because it could have been tampered with. See Initiating a Payment.

Merchant URL Parameters

The merchant URL consists of the following parameters. See ap_initiate_merchant_url.

Table 1

Merchant URL Parameters

Parameter	Description
Alipay web site	mapi.alipay.com/gateway.do
Body	Description of the product purchased.
Notify URL	URL for displaying notifications after the transaction is processed.
Out trade no	Unique transaction ID.
Partner	Merchant ID for Alipay.
Payment type	The payment type used for the transaction. The value is 1.
Return URL	URL of the web page that is displayed to the customer when the transaction is complete.
Service	Alipay service name.
Subject	Product purchased by the customer.
Total fee	Grand total for the order.
Sign and sign type	Digital signature and type of signature used to verify the transaction information. The digital signature prevents data tampering.
Seller email	Merchant email address registered in the merchant Alipay account.
it_b_pay	The time out limit for a transaction. The time out limit starts when Alipay approves the URL request, and when it expires the transaction is automatically closed. The possible integer values are: ■ 1c: the transaction expires at the end of the day (Chinese Standard Time) ■ ##d: minimum of 1 day to a maximum of 15 days ■ ###h: maximum of 360 hours ■ #####m: minimum of 5 minutes to a maximum of 21600 minutes For example, it_b_pay=1.5h is not a valid value. The value must be an integer value of it_b_pay=90m. Note If no value is included Alipay adds the default value of 15d. If an incorrect or invalid value is included, Alipay rejects the transaction. Important Contact CyberSource Customer Support to configure your transaction time-out settings.

Check Status Service

 

You must request the check status service to receive the most recent status of a payment.

When the customer is redirected to your web site after making a payment, you must request the status of the payment at the recommended intervals listed below to receive the most recent status of the payment. The status confirms whether the payment was accepted or not between the customer and Alipay. Checking payment status is a follow-on transaction that uses the request ID returned from the initiate payment request. The initiate payment request ID links the check status request to the payment transaction.

If the payment status is PENDING, wait 1 hour before trying again. Recommended intervals are:

■	Immediately

■

1 hour

■

4 hours

■

12 hours

■

Daily

If the payment status does not change to COMPLETED after 15 days, do not send further payment requests. After 15 days, the status changes to ABANDONED.

When the payment status is COMPLETED or ABANDONED it appears in the Payment Events report. For more information regarding the Payment Events report, see the Classic Reporting Developer Guide (PDF | HTML).

Refund Payment Service

A refund is a follow-on transaction that uses the request ID returned from the initiate payment request. The request ID links the refund transaction to the payment transaction.

CyberSource recommends that the payment status must be COMPLETED before refunding a payment and returning funds to the customer account. Before refunding a payment, request the Check Status service to retrieve the status of the payment.

Supported Payment Types

Alipay Domestic Services support two payment types: web payments and mobile payments.

Table 2

Supported Payment Types

Payment Type	Description
Web Payment	The payment flow is optimized for a browser displayed on a personal computer or laptop. Include the APD value in the ap_payment_type request field for the Initiate Payment request, the follow-on Check Payment Status request, and the Refund request.
Mobile Payment	The payment flow is optimized for a browser displayed on a mobile device. Include the ADM value in the ap_payment_type request field for the Initiate Payment request, the follow-on Check Payment Status request, and the Refund request.