Alipay

Alipay is China’s leading third-party mobile and online payment solution.

About Alipay

Alipay provides easy, safe and secure Internet payments for millions of individuals and businesses.

With Alipay, you can process escrow payments that reduce transaction risk for the customer. Before releasing the payment amount, the customer can ensure they’re happy with the items they bought.

Accept an Alipay payment

To accept an Alipay payment, follow the steps below.

When testing, do not use real customer data. Use the test data prepared by Unzer.

Step 1: Create an alipay resource

To create an alipay resource, make a POST call with an empty request body to types/alipay:

POST https://api.unzer.com/v1/types/alipay

   "id": "s-ali-otvqlpgqsh7u",
   "method": "alipay",
   "recurring": false,
   "geoLocation": {
    "clientIp": "115.77.189.143",
    "countryCode": "VN"
   }
}

Step 2: Make a charges call

To charge the Alipay resource, make a payments/charges call with the following parameters in the request body:

POST https://api.unzer.com/v1/payments/charges

Body:
{
  "amount" : "50",
  "currency" : "EUR",
  "returnUrl" : "https://www.unzer.com",
  "orderId": "", 
  "resources" : {
    "typeId" : "s-ali-otvqlpgqsh7u",
    "metadataId": "",
    "customerId": ""
  }
}

{
    "id": "s-chg-1",
    "isSuccess": false,
    "isPending": true,
    "isError": false,
    "redirectUrl": "https://dev-payment.unzer.com/v1/redirect/alipay/laksjdfloikwjerklj2lk3j",
    ....
}

Step 3: Forward the customer to the redirect URL

After you charge the alipay resource, implement the following flow:

1. Redirect the customer to the redirectURL.
2. The customer is forwarded to the Alipay payment page.
3. After a successful payment, the customer is redirected to the returnURL that you specified in the charges call (Step 2).

Step 4: Check the payment status

After the customer is redirected to the returnUrl, check the status of the payment.

Make a GET call with the following parameters in the request path:

GET https://api.unzer.com/v1/payments/{resource_ID}>/charges/{transaction_ID}

{
    "id":   "s-chg-1",
    "isSuccess":   true,
    "isPending":   false,
    "isError":     false,
    "redirectUrl": "",
     ...
}