Skip to main content
UnionPay is a payment network based in China. With the UnionPay payment method, customers in mainland China confirm the payment on a UnionPay page instead of entering card details at your checkout. Payrails processes UnionPay through Worldpay.

​
How a UnionPay payment works

UnionPay is a redirect payment method:
  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.
Each payment is single-use: the customer confirms every payment on its own. Payrails captures UnionPay payments immediately, so a successful payment is final.

​
Supported currencies and countries

Payrails sends the currency you provide to Worldpay without checking it first. Worldpay rejects a currency outside UnionPay coverage. UnionPay is available to customers based in:
RegionsCountries
Asia Pacific🇨🇳 China

​
Integrate UnionPay

Choose the PSP that processes UnionPay for you. The guide covers the PSP-side setup, the Payrails configuration and the request fields that PSP requires.

Worldpay

UnionPay via Worldpay

​
Check PSPs

WorkflowWorldpay
Payrails SDK✔
Payrails API✔
Delayed / Manual Capture✖
Instant Capture✔
Cancel / Void✖
Refund / Reverse✔
Save Instruments✖
Merchant Initiated Transaction (MIT)✖

​
Ways to integrate UnionPay

  • Payrails SDK: the Web SDK shows UnionPay when your workflow returns it as a payment option.
  • Payrails API: call lookup payment options, then authorize with unionPay as the paymentMethodCode. The PSP guide lists the meta fields that PSP requires.
In both cases, confirm the final result through webhook notifications or the execution status.
Last modified on October 16, 2026