If you already haven’t set up payments yet, start here first: /blog/alipay-wechat-pay-setup-foreigners.

This page is about fixing failures when you’re standing at checkout and the wallet doesn’t work.

Fast triage (30 seconds)

When a payment fails, do this before you panic:

  1. Check signal: switch between Wi‑Fi and mobile data
  2. Close/reopen the wallet app
  3. Try the other wallet (Alipay vs WeChat Pay)
  4. Try a smaller amount (if the merchant allows)
  5. If it’s still failing, switch to your backup method (cash/card) and fix it later

Avoid rapid repeated retries — it can trigger fraud/verification friction.

The failure types (and what each usually means)

Different messages often mean different root causes:

  • “Payment failed” with no detail: network/app permissions or temporary merchant-side issue
  • Card declined / issuer declined: your bank blocked it or a hold exceeded your limit
  • Identity/verification required: you hit a new step (passport/face scan/SMS) you can’t complete right now
  • Merchant not supported: that merchant accepts one wallet better than the other, or only certain payment rails

In practice, the quickest win is usually switching network + switching wallet.

Fixes that work most often (in order)

1) Fix connectivity first

Payment apps are sensitive to unstable data.

  • Switch from roaming data to stable Wi‑Fi (hotel, mall, cafe)
  • Disable “Low Data Mode” / aggressive battery saving for the wallet app
  • If you’re on a travel eSIM, consider a local physical SIM for stability

Related: /blog/china-esim-vs-sim.

2) Check permissions (QR needs camera)

If you can’t scan or show a code reliably:

  • Allow camera permission
  • Allow network access / background data
  • Allow notifications (some verification steps require it)

3) Switch wallet apps (Alipay ↔ WeChat Pay)

Some merchants behave differently with each wallet.

  • If Alipay fails, try WeChat Pay
  • If WeChat Pay fails, try Alipay

This is why the setup guide recommends installing both.

4) Switch payment card (and stop “retry spam”)

If you have more than one card linked:

  • Use your backup card once (not five times)
  • Wait 1–2 minutes between attempts if the merchant is willing

If both cards fail, assume it’s your issuer’s risk controls and move to a backup method.

5) Reduce the amount / split the payment (when possible)

Sometimes a high amount triggers extra verification or holds.

  • Ask if the merchant can split payment
  • Pay a deposit/portion now, remainder later

Don’t try to “game” systems — just use a pragmatic split if the merchant supports it.

The backup stack that keeps you moving for 24 hours

Your goal is not perfection — it’s not getting stranded.

Keep a small fallback kit:

  • A small cash reserve (transport + convenience store)
  • One physical card (separate from your phone)
  • Knowledge of one reliable ATM near your hotel

If you need the ATM/cash workflow: /blog/cash-atms-and-currency-in-china-for-foreigners.

Common scenarios (with the least-wasteful response)

You’re at a convenience store and it fails

  • Switch to the other wallet
  • If still failing: pay cash/card, walk out, and troubleshoot later on stable Wi‑Fi

You’re trying to pay for transport (metro/bus/Didi) and it fails

  • For Didi specifically, keep the ride moving with a backup card/cash if available, then fix payments at the hotel

Related: /blog/didi-in-china-for-foreigners.

You can’t complete verification because you can’t receive SMS

This is a root problem: fix SMS first, then fix payments.

Related: /blog/china-sim-esim-sms-verification-codes.

Don’t do these things

  • Don’t hand your unlocked phone to strangers to “help”
  • Don’t share passport photos or card info in random chat groups
  • Don’t keep hammering “retry” quickly; switch methods and de-risk the situation

Rules and wallet policies can change. Always follow the apps’ current in‑app help pages and official notices.

Last verified: 2026-06-12