UnionPay

​

How a UnionPay payment works

1. The customer selects UnionPay at checkout.
2. Payrails returns a redirect URL from Worldpay, and the customer goes to UnionPay.
3. The customer confirms the payment on the UnionPay page.
4. UnionPay sends the customer back to your returnInfo URL.
5. Payrails receives the final result from Worldpay and updates the payment.

​

Supported currencies and countries

​

Supported workflows

​

Before you begin

1. Set up a Worldpay integration in your workspace. Contact your Payrails account team if Worldpay isn’t listed in your Payrails Portal yet.
2. Ask Worldpay to enable UnionPay on your Worldpay entity.
3. In the Payrails Portal, go to Settings → Integrations, open your Worldpay integration, select UnionPay under Payment methods, and save.
4. Add UnionPay as a payment option in your workflow.

​

Request fields for Worldpay

​

Authorize a UnionPay payment

{
  "amount": {
    "value": "200.00",
    "currency": "CNY"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "unionPay",
      "amount": {
        "value": "200.00",
        "currency": "CNY"
      }
    }
  ],
  "meta": {
    "order": {
      "reference": "order-1234",
      "softDescriptor": "Example Store"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Worldpay handles UnionPay

• Payrails sets the UnionPay page language to English (en).
• Payrails gives Worldpay success, pending and failure return URLs for UnionPay, with no separate cancel URL. A payment that doesn’t complete returns the customer to your error URL.
• When Worldpay reports the payment as pending after the redirect, Payrails waits for the Worldpay webhook to set the final status.
• Save Instruments and merchant-initiated transactions (MIT) aren’t available for UnionPay through Worldpay.