# UnionPay

Accept UnionPay card payments, including Apple Pay payments on the web.

Accept UnionPay cards with an existing [card payment integration](https://docs.stripe.com/payments/accept-a-payment.md). See [online card brand capabilities](https://docs.stripe.com/payments/cards.md#online-card-brand-capabilities) for acceptance by business location and [payment method integration options](https://docs.stripe.com/payments/payment-methods/integration-options.md) for supported integrations.

## Apple Pay support 

Eligible businesses can accept UnionPay through Apple Pay on the web only. Support includes mobile web on compatible devices and browsers, and desktop Safari.

### Business locations 

Stripe accounts in the following countries and regions can accept UnionPay through Apple Pay:

- AT
- AU
- BE
- BG
- CH
- CY
- CZ
- DE
- DK
- EE
- ES
- FI
- FR
- GB
- GI
- GR
- HK
- HR
- HU
- IE
- IT
- LI
- LT
- LU
- LV
- MT
- MY
- NL
- NO
- NZ
- PL
- PT
- RO
- SE
- SG
- SI
- SK

### Integration 

Follow the [Apple Pay web integration guide](https://docs.stripe.com/apple-pay.md?platform=web) for prerequisites and domain registration.

Stripe automatically configures the UnionPay request capabilities, including `supportsEMV`, for eligible businesses using:

- [Checkout](https://docs.stripe.com/payments/checkout.md)
- [Payment Links](https://docs.stripe.com/payment-links.md)
- Supported [Elements](https://docs.stripe.com/payments/elements.md)
- Existing [Payment Request Button](https://docs.stripe.com/stripe-js/elements/payment-request-button.md) integrations (deprecated)

This also applies to a custom checkout UI that uses a Stripe-managed wallet request.

### Advanced: custom Apple Pay requests 

If your integration constructs its own Apple Pay request, configure eligible UnionPay payments as follows:

- Include `chinaUnionPay` in `supportedNetworks`.
- Add `supportsEMV` to `merchantCapabilities` when the final `supportedNetworks` list includes `chinaUnionPay`, after applying all eligibility and flow restrictions. If `chinaUnionPay` is absent from `supportedNetworks`, omit `supportsEMV` from `merchantCapabilities`.
- Retain `supports3DS` and any existing credit or debit funding capabilities.

### Limitations

UnionPay through Apple Pay doesn’t support setup-only flows, such as collecting a payment method through a `SetupIntent` without a payment.

## Sandbox testing 

The [Apple Pay testing guide](https://docs.stripe.com/apple-pay.md?platform=web#test-apple-pay) covers testing in a sandbox without making live payments.
