# Accepting WeChat Pay and Alipay: The China Payment Stack for Global SaaS

> Why global SaaS need WeChat Pay and Alipay for Chinese customers, how QR code mobile payments work, USD versus CNY billing, and the integration realities.
- **Author**: Ayush Agarwal
- **Published**: 2026-05-12
- **Category**: Payments, SaaS, China
- **URL**: https://dodopayments.com/blogs/wechat-alipay-saas-china

---

China has the largest mobile payments market in the world, and the smallest credit card market relative to its size. Chinese consumers do not pay with cards online. They pay with WeChat Pay or Alipay, two QR-code based mobile wallets that together cover more than a billion users. For global SaaS founders targeting Chinese customers, building a payment stack that ignores these two methods is a fast path to losing the entire market.

This guide covers the China payment stack reality, the differences between WeChat Pay and Alipay, the USD versus CNY billing decision, the subscription limitations, and the integration patterns that work for global software businesses serving Chinese audiences.

## The China Payment Reality

Three things are true about China that founders coming from US or European markets often miss.

### Reality 1: Cards Are Not the Default

In the US, credit and debit cards dominate online payments. In Europe, regional bank methods plus cards do. In China, neither is true. Mobile wallets dominate, with WeChat Pay and Alipay together covering well above 90% of digital consumer payments.

This means a checkout that offers only cards is essentially closed to Chinese customers. They will see a card-only checkout and bounce.

### Reality 2: QR Codes Are the Native Pattern

Chinese consumers are used to scanning QR codes for everything: paying for groceries, paying restaurant bills, sending money to friends. QR codes at online checkout feel completely natural. The web flow asks the customer to scan a QR code with their WeChat or Alipay app, which then completes the payment in seconds.

This is different from card-based flows. There is no form to fill out. No CVV to enter. No 3D Secure modal. The payment happens entirely in the customer's mobile wallet app.

### Reality 3: Cross-Border Payments Are Constrained

Chinese consumers paying for foreign products face cross-border payment regulations. Foreign currencies are restricted. Most consumers prefer to see prices in CNY and pay in CNY, even if the merchant is foreign. Some prefer USD if the merchant offers it, especially for high-trust international brands.

Both WeChat Pay and Alipay support both USD and CNY billing for cross-border transactions, with the merchant settling in USD regardless of which currency the customer used at checkout.

For broader China context, see our guides on [merchant of record in China](https://dodopayments.com/blogs/merchant-of-record-china), [global billing](https://dodopayments.com/blogs/global-billing), and [scaling global SaaS](https://dodopayments.com/blogs/scaling-global-saas-microsaas-expansion).

## WeChat Pay vs Alipay

The two systems are similar from a customer's perspective but operate differently behind the scenes.

| Feature | WeChat Pay | Alipay |
|---|---|---|
| Parent company | Tencent (WeChat super-app) | Ant Group (Alibaba ecosystem) |
| User base | 1B+ active users | 1B+ active users |
| Cross-border billing | USD, CNY | USD, CNY |
| Subscription support | No | No |
| Settlement | USD | USD |
| Strongest in | Personal payments, social commerce | E-commerce, financial services |

For global SaaS, both should be available. Some customers exclusively use WeChat Pay because their entire mobile payment habit lives in WeChat. Others use Alipay for everything and rarely open WeChat for payments. Offering both covers the full audience.

## How a Chinese Customer Pays

```mermaid
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant WeChat or Alipay
    
    Customer->>Checkout: Select WeChat Pay or Alipay
    Checkout->>Dodo: Create payment
    Dodo->>WeChat or Alipay: Initiate payment
    WeChat or Alipay->>Customer: Display QR code
    Customer->>WeChat or Alipay: Scan QR with mobile app
    WeChat or Alipay->>Dodo: Payment confirmed
    Dodo->>Checkout: Payment complete
```

From the customer's view:

1. They land on your checkout page on a desktop or laptop browser.
2. They see WeChat Pay and Alipay as payment options.
3. They pick one. A QR code appears.
4. They open WeChat or Alipay on their phone.
5. They scan the QR code with the app's built-in scanner.
6. The mobile app shows them the merchant name and amount, and asks them to confirm.
7. They confirm, often with a fingerprint or face scan in the mobile app.
8. The payment confirms instantly. The desktop checkout transitions to the success state.

The customer can also browse the checkout on their mobile phone. In that case, the flow may open the WeChat or Alipay app directly via deep link, skipping the QR code step. Most modern processors handle this transparently.

## The Currency Decision

You have a choice when integrating WeChat Pay and Alipay: bill in USD or bill in CNY.

### Billing in USD

The customer sees a USD price. The mobile wallet app shows the customer the equivalent CNY amount at the time of payment. The customer pays the CNY amount, and the wallet handles conversion. You receive USD settlement.

This is simpler operationally. You only manage one currency on your side. The customer sees a price they can compare to other USD-priced products.

The downside is that prices in USD feel foreign to Chinese consumers. They may convert mentally to CNY and find the price uncomfortable, or they may distrust the conversion math and worry about being charged more than expected.

### Billing in CNY

The customer sees a CNY price. They pay in CNY directly. You still settle in USD, but the customer's experience is fully localized.

This converts better with mainland Chinese audiences. The price is in their native currency. There is no conversion math to do mentally. The transaction feels local even though the merchant is foreign.

The downside is operational complexity. You are now managing CNY pricing alongside whatever your primary currency is. Your pricing pages need to display CNY prices for Chinese visitors. Your discounting logic needs to work in CNY.

For most SaaS targeting mainland Chinese audiences seriously, CNY billing converts noticeably better and is worth the operational investment. For SaaS that gets occasional Chinese customers but does not specifically target the market, USD billing is fine.

> The currency decision usually maps to how serious the China target is. If China is a top-three market for you, bill in CNY. If China is incidental traffic, USD is fine. The conversion delta between the two is meaningful but only worth investing in when the volume justifies it.
>
> - Ayush Agarwal, Co-founder & CPTO at Dodo Payments

## The Subscription Limitation

WeChat Pay and Alipay both have the same limitation as PIX, BNPL, and most non-card payment methods: they do not support recurring billing.

Each transaction is a discrete, customer-initiated push. There is no card-on-file or saved-credential pattern. So if your SaaS is monthly-subscription, WeChat Pay and Alipay do not work for the recurring charges.

The workarounds are the same as for other non-card methods:

- Annual plans paid as a one-time annual fee work great
- Monthly plans need a card on file as the renewal payment method, with WeChat Pay or Alipay used only for the first payment
- Or you build a renewal-via-WeChat-or-Alipay flow that prompts the customer each cycle

Annual plans paid via WeChat Pay or Alipay are the cleanest pattern for global SaaS targeting Chinese customers.

For more on annual versus monthly economics, see our [annual vs monthly billing](https://dodopayments.com/blogs/annual-vs-monthly-billing-saas) deep dive.

## Configuration

The integration code is short.

```javascript
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_annual', quantity: 1 }],
  allowed_payment_method_types: ['wechat_pay', 'alipay', 'credit', 'debit'],
  customer: {
    email: 'customer@example.com',
    name: 'Li Wei'
  },
  return_url: 'https://yoursite.com/success'
});
```

A few practical notes.

1. **Always include card fallbacks.** Some Chinese customers have foreign-issued cards (especially business owners and frequent travelers). Card payment as a fallback covers them.
2. **Test with both currencies if you target China seriously.** Run an A/B with USD versus CNY pricing for a week and pick the better-converting variant.
3. **Optimize for mobile.** Many of your Chinese visitors will be on mobile. The QR code flow works best when the customer can scan from one device while the checkout is on another, so a desktop checkout displaying a QR code is the cleanest pattern. For mobile-only browsing, the deep-link pattern is automatic.

For deeper integration mechanics, see the [Dodo Payments WeChat documentation](https://docs.dodopayments.com/features/payment-methods/wechat).

## Webhook Handling

WeChat Pay and Alipay both confirm instantly when the customer scans and authorizes. So your webhook flow looks like this:

- `payment.succeeded` fires within seconds of customer authorization
- `payment.failed` fires if the customer cancels or the QR code expires

There is rarely a long-pending state to manage, in contrast to some bank-redirect methods. Build your post-payment fulfillment logic to listen for `payment.succeeded` and grant access immediately. The customer expects instant confirmation given the speed of the payment flow.

## Common China Stack Mistakes

### Mistake 1: Card-Only Checkouts

The fastest way to fail in China is to ship a checkout with only credit and debit cards. Chinese consumers will not have foreign-acceptable cards, and even if they do, they will prefer the WeChat or Alipay flow they know. A card-only checkout converts at single-digit percentages in China.

### Mistake 2: Treating WeChat Pay and Alipay as Interchangeable

Some founders ship one of the two, assuming Chinese customers will use whichever is available. They will not. WeChat Pay users prefer WeChat Pay. Alipay users prefer Alipay. Switching between them is friction. Offer both.

### Mistake 3: Ignoring QR Code Mobile Behavior

Most mobile wallets need the QR code to be scannable. If your checkout displays the QR code in a way that breaks when the customer's phone tries to scan it (poor lighting, weird formatting, low resolution), the payment fails before it starts. Test your QR code rendering on real Chinese WeChat and Alipay apps before going live.

### Mistake 4: Forcing Monthly Subscriptions

If your only subscription option is monthly, and you offer it via WeChat Pay or Alipay, you create a renewal failure trap. Customers will pay the first month and then be confused when the second month does not auto-renew. Either offer annual as the default for these payment methods, or set up a clear card-on-file flow.

### Mistake 5: Pricing in CNY but Displaying in USD

Inconsistent pricing across the customer journey is a conversion killer. If your homepage shows USD but your checkout suddenly displays CNY, customers feel surprised. Be consistent across the entire path. Pick one currency for the China market and use it everywhere.

For broader payment stack patterns, see our [best payment platform for AI startups](https://dodopayments.com/blogs/best-payment-platform-ai-startups) and [why localized payment methods matter](https://dodopayments.com/blogs/why-localized-payment-methods-are-important-for-higher-conversions) guides.

## A Real Global SaaS in China

Imagine a productivity SaaS based in San Francisco that wants to enter the Chinese market.

- Pricing in CNY (Yi 199 a month, Yi 1,990 a year)
- Annual plan as the default, with a clear "yearly is 17% off" message
- Checkout offers WeChat Pay, Alipay, and credit cards in that order
- Default selection is WeChat Pay for first-time visitors from China
- Mobile-first checkout with deep-link to WeChat or Alipay app on mobile, QR code on desktop
- Settlement to the SaaS's USD account through a merchant of record handling CNY-USD conversion and Chinese tax compliance
- Customer support available in Mandarin via in-app chat and email

This stack converts well in mainland China and keeps the unit economics clean. The MoR handles the regulatory complexity of cross-border payments and tax filings, which is critical because doing those correctly without local entity setup is non-trivial.

## When to Skip the China Stack

Skip WeChat Pay and Alipay if:

- You do not target Chinese customers
- Your product is fundamentally incompatible with Chinese internet conditions (latency-sensitive real-time apps, content blocked by the Great Firewall, etc.)
- You serve only enterprise direct-contracted accounts where procurement handles payment via wire transfer or invoicing

For everyone else with any meaningful Chinese audience, both methods should be on the checkout. Skipping them is the equivalent of skipping cards in the US: you lose the market.

## FAQ

### Do I need a Chinese entity to accept WeChat Pay and Alipay?

No, not if you use a merchant of record that has the local relationships. The MoR handles the China-side regulatory work, including tax compliance, currency conversion, and cross-border settlement. You operate from your existing entity and the MoR handles China-specific complexity.

### How does USD settlement work for CNY-billed transactions?

The customer pays in CNY (or USD, if you billed in USD). The merchant of record handles the conversion at settlement time, less an FX spread, and credits your USD wallet on the standard payout schedule. The conversion rate is typically the daily mid-market rate plus a small spread, similar to how other multi-currency platforms work.

### Can I use Hong Kong-issued cards instead of WeChat Pay or Alipay?

Hong Kong-issued cards work for Hong Kong customers but not for mainland Chinese customers. The two markets have different payment ecosystems despite the political relationship. For mainland China, WeChat Pay and Alipay are essential. Hong Kong customers typically use cards.

### How does refund work on WeChat Pay or Alipay?

Refunds work similarly to cards. You initiate a refund through your processor, the funds flow back through the WeChat Pay or Alipay system, and the customer's mobile wallet receives the refunded amount. Timing is usually faster than card refunds, often same-day or next-day, since the entire flow is digital.

### Can I send marketing or product updates via WeChat?

WeChat Pay (the payment method) is separate from WeChat (the messaging platform), although both are run by Tencent. Selling on WeChat Pay does not give you the right to message customers via WeChat. For marketing inside the WeChat ecosystem, you typically need a WeChat Official Account, which is a separate product with its own setup process.

## Final Take

The China payment stack is non-negotiable for global SaaS targeting Chinese customers. WeChat Pay and Alipay are not optional add-ons. They are the primary methods. Cards are the fallback. A checkout without these two methods is closed to most of the Chinese market.

The integration is straightforward when handled by a merchant of record that abstracts the regulatory complexity. The currency decision (USD versus CNY) is mostly about how serious you are about the market. The subscription limitation pushes most SaaS toward offering annual plans for China.

Get the basics right and China becomes a real, addressable market for your product. Skip them and you are leaving a billion potential customers on the table. For the integration patterns and merchant of record support, visit [dodopayments.com](https://dodopayments.com). For pricing details, see [dodopayments.com/pricing](https://dodopayments.com/pricing).
</content>
</invoke>
---
- [More Payments articles](https://dodopayments.com/blogs/category/payments)
- [All articles](https://dodopayments.com/blogs)