UnionPay via Worldpay

​

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.
• Each UnionPay payment is a new customer-initiated payment.