Processing Alipay Transactions

Initiating a Payment

To initiate a payment:

Step 1

Set the apInitiateService_run field to true.

Step 2

Include the following fields in the request:

■	merchantID

■	merchantReferenceCode

■	apPaymentType

 

Set the value of the apPaymentType field to APD for a web payment or ADM for a mobile payment. The same value must be used in the follow-on Check Payment Status request and the Refund request.

■	apInitiateService_productName

■	apInitiateService_productDescription—optional. See Working with Mutltibyte Character StringsWorking with Multibyte Character Strings.

■	apInitiateService_returnURL

■	purchaseTotals_currency—this value must be CNY. See Working with Mutltibyte Character StringsWorking with Multibyte Character Strings.

■	purchaseTotals_grandTotalAmount

For detailed descriptions of all request and reply fields, see API Fields. For an Initiate Payment example, see Initiate Payment.

 

Checking Payment Status

To check the status of a payment:

Step 1

Set the apCheckStatusService field to true.

Step 2

Include the following fields in the request:

■	merchantID

■	merchantReferenceCode

■	apPaymentType

 

Set the value of the apPaymentType field to APD for a web payment or ADM for a mobile payment. The same value must be used in the follow-on Check Payment Status request and the Refund request.

■	apCheckStatusService_apInitiateRequestID—returned in the initiate payment service reply. See Reply Fields.

For detailed descriptions of all request and reply fields, see API Fields. For a Check Status example, see Check Status.

 

Refunding a Payment

 

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.

To refund a payment:

Step 1

Set the apRefundService_run field to true.

Step 2

Include the following fields in the request:

■	merchantID

■	merchantReferenceCode

■	apPaymentType

 

Set the value of the apPaymentType field to APD for a web payment or ADM for a mobile payment. The same value must be used in the follow-on Check Payment Status request and the Refund request.

■	apRefundService_requestID—returned in the initiate payment service reply. See Reply Fields.

■	apRefundService_reason

■	purchaseTotals_currency

■	purchaseTotals_grandTotalAmount

For detailed descriptions of all request and reply fields, see API Fields. For a Refund Payment example, see Refund.

To refund a transaction using the Business Center:

Step 1

Log in to the Business Center:

■	Live merchant transactions: https//ebc.cybersource.com

■	Test merchant transactions: https//ebctest.cybersource.com

Step 2

In the left navigation panel, choose Transaction Search > General Search. The General Search page appears.

Step 3

Check Search for an application or transaction type.

Step 4

Select Alternative Payment Initiate.

Step 5

Select a date range: select the date and time interval for your search, from transactions processed during the past hour to those from the previous 1-6 months or a custom range that you define.

Step 6

Click Search. The Transaction Search Results page appears.

Step 7

Click the transaction request ID link. The Transaction Search Details page appears.

Step 8

Under the heading Available Actions, click Refund. The Alipay Refund page appears.

Step 9

Enter the refund amount.

Step 10

Enter a reason for the refund. This step is optional.

Step 11

Click Refund. The Transaction Search Details page appears.

 

Viewing Transactions in the Business Center

Log in to the Business Center to search for and view transactions. Use the transaction search option to find and view transactions that you need to review or refund.

To find and view a transaction:

Step 1

Log in to the Business Center:

■	Live merchant transactions: https//ebc.cybersource.com

■	Test merchant transactions: https//ebctest.cybersource.com

Step 2

In the left navigation panel, choose Transaction Search > General Search. The General Search page appears.

Step 3

Check Search for an application or transaction type.

Step 4

Select one of the following transaction types:

■	Alternative Payment Initiate

■	Alternative Payment Refund

■	Alternative Payment Status

Step 5

Select a date range: select the date and time interval for your search, from transactions processed during the past hour to those from the previous 1-6 months or a custom range that you define.

Step 6

Click Search. The Transaction Search Results page appears.

Step 7

Click the request ID link of the transaction. The Transaction Search Details page appears.