Using Alipay International Services

 

All Alipay international 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 International Services

Initiate Payment Service

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

Figure 1

Initiate Payment Service

The Alipay international payments web site is a real-time payment solution enabling international 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 apPaymentType field: APY for a web payment (personal computer or laptop) or AYM 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. requested amount, The RMB amount, and the exchange rate are displayed. The payment is not visible to you as the merchant, and the customer can cancel without your knowledge.

6	Alipay accepts the payment request and sends payment notification to CyberSource that the payment is complete.

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 apInitiateReply_ merchantURL.

Table 1

Merchant URL Parameters

Parameter	Description
Alipay web site	mapi.alipay.com/gateway.do
Body	Description of the product purchased.
Currency	Currency used for the order.
Notify URL	URL for displaying notifications after the transaction is processed.
Out trade no	Unique transaction ID.
Partner	Merchant ID for Alipay.
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.

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

If the payment status does not change to COMPLETED after 12 hours, do not send further payment requests. After 12 hours, 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 International 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 APY value in the apPaymentType 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 AYM value in the apPaymentType request field for the Initiate Payment request, the follow-on Check Payment Status request, and the Refund request.