Payment failure guide

Why Alipay fails with a foreign card in China

In short

What should I do if Alipay fails at checkout?

Step aside, then check the four things the operators publish: is your card network on the wallet's list, is the payment above Weixin Pay's 6,500 RMB single-transaction cap, are you paying a shop code rather than a person, and has the app asked for your passport. If all four are clear, switch network, wallet or card once each. If it still fails, pay cash — since February 1, 2026 a merchant may not refuse it.

Check phone and VPN setup

Applies to

Foreign visitors using Alipay, Weixin Pay, Visa, Mastercard, American Express, overseas bank cards, QR menus, taxis, small restaurants, convenience stores, metro counters, and attraction ticket desks.

Check before you rely on it

Fee, limit and card-list figures on this page are quoted from the operator and regulator pages linked beside them, with the date we read each one. Wallets change these without notice, so open the linked page before a large purchase.

Information checked:

A wallet that looks ready can still fail at a real cashier. Treat the first payment as a system check: wallet mode, merchant QR type, card risk checks, network, and backup all matter.

Mobile payment guide used for China wallet setup

Failure modes

Payment fails for more than one reason

Most advice stops at linking a card. The practical question is which part of the live payment chain broke.

The card linked, but the merchant flow is different

A linked foreign card can still behave differently across QR payment, cashier scan, in-app payment, and personal transfer flows. A shop merchant QR is not the same as sending money to a person.

The bank or wallet risk check blocks the transaction

Foreign banks, card networks, wallet checks, transaction limits, identity prompts, and unusual location signals can all stop a payment that looked ready in the app.

The network layer is unstable

Payment screens depend on mobile data, app login state, SMS or bank prompts, and sometimes whether VPN or hotel Wi-Fi is interfering. A payment failure can be a connectivity problem in disguise.

The merchant only accepts a local-friendly path

Small shops, taxis, QR menus, and personal collection codes may not behave like hotels or larger merchants. The fallback is to ask for a merchant QR or use a staffed counter, not to keep retrying the same screen.

Published numbers

What Weixin Pay charges and caps on an international card

Weixin Pay is the only wallet in this cluster that publishes fee and limit figures for a foreign card. Here they are, with the page they came from.

Identity and phone number

A passport, and any number that receives SMS

A passport, a PRC Foreign Permanent Resident ID Card, or a Mainland Travel Permit or Residence Permit for Hong Kong SAR, Macau SAR and Taiwan residents. Passport verification prompts you to upload a copy of the passport. A Chinese mainland (+86) number is not required. An international number works as long as it can receive SMS verification codes.

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

Sources disagree

Two official pages publish different limits for the same wallet

Tencent's own help page

  • Single transaction: 6,500 RMB
  • Monthly cumulative: 50,000 RMB
  • Yearly cumulative: 65,000 RMB

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

Chaoyang District government mirror

  • Single transaction: 6,000 RMB
  • Monthly cumulative: 50,000 RMB
  • Yearly cumulative: 60,000 RMB

Source: Chaoyang District Government, Beijing — Overseas Bank Cards Accepted by Weixin Pay and Alipay (read July 24, 2026)

Both pages were read on July 24, 2026. The district page carries no publication or update date, and its single and yearly figures sit below the operator's. The two agree on the fee rule and on the monthly cap. Plan against the operator's figures and treat the mirror as evidence that government copies of app rules lag the app.

The policy ceiling is not what stops your purchase

Government guidance raised the mobile-payment ceiling for overseas visitors to 5,000 US dollars for a single transaction and 50,000 US dollars a year, up from 1,000 US dollars for a single transaction and 10,000 US dollars a year before the change. This is the outer policy boundary, not the thing that will stop your purchase. Weixin Pay's own published single-transaction cap of 6,500 RMB is far below the policy ceiling, so the wallet's rule is the one you will hit.

Source: The State Council of the People's Republic of China — Payment service guide for overseas visitors to China (April 11, 2024; read July 24, 2026)

Alipay publishes no fee schedule and no transaction limit for an international card

The Alipay+ page for paying in the Chinese mainland sets out the checkout modes, the exchange-rate handling and what an international card cannot be used for, but it carries no fee and no limit anywhere. Two Alipay help URLs that once covered this were checked in the same pass: one redirects off-site and the other returns an expired-form message. Third-party figures circulate widely; none of them is a source, so none of them is on this page.

Source: Ant International — Alipay+ | Pay in the Chinese mainland (read July 24, 2026)

Decision table

Card declined? Work down this list, one change at a time

Each row is what you can see, what to try next, and the published rule behind it. Start at the top.

What you are seeing
Try this next
The published rule
The card will not attach, or your network is not offered
Check your network against the wallet's own published list before trying again.
Tencent lists Visa, Mastercard, JCB, American Express, Discover Global Network including Diners Club, and UnionPay for Weixin Pay. American Express and UnionPay do not appear on any official Alipay list we read, so an Amex card belongs in Weixin Pay.

Source: Tencent — Mobile Payment Solutions for Your China Journey: A Practical Guide (June 18, 2025; read July 24, 2026)

Source: People's Bank of China — Guide to Payment Services in China (2024 edition, page updated May 25, 2024; read July 24, 2026)

A large purchase is declined while small ones work
Split the purchase, or pay the balance another way.
Weixin Pay publishes a single-transaction limit of 6,500 RMB for an international card. A single transaction above 200 RMB also carries a 3% fee; below 200 RMB the fee is waived.

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

Payments stop working after several days of spending
Check the running total, not the individual payment.
Weixin Pay publishes cumulative limits of 50,000 RMB a month and 65,000 RMB a year for an international card. A district government mirror of the same rules still shows 6,000 RMB single and 60,000 RMB yearly, so the operator's page is the one to plan against.

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

Source: Chaoyang District Government, Beijing — Overseas Bank Cards Accepted by Weixin Pay and Alipay (read July 24, 2026)

It works at a shop counter but fails on a code someone shows you
Ask for the merchant's code instead of paying a person.
An international card added to Alipay does not support person-to-person transfers or red packets. Weixin Pay states the same limit as everyday purchases only. The two legitimate checkout modes are scanning the merchant's code, or showing your own code for the merchant to scan.

Source: Ant International — Alipay+ | Pay in the Chinese mainland (read July 24, 2026)

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

The scan opens but nothing completes
Look at the logo printed on the code and open that app.
The central bank's guide instructs visitors to scan the code carrying the logo of the payment service provider they intend to use, with an Alipay-logo code scanned by the Alipay app as the worked example.

Source: People's Bank of China — Guide to Payment Services in China (2024 edition, page updated May 25, 2024; read July 24, 2026)

The app asks you to prove who you are
Have the passport itself ready, not a local phone number.
Weixin Pay accepts a passport, a PRC Foreign Permanent Resident ID Card, or a Mainland Travel Permit or Residence Permit for Hong Kong SAR, Macau SAR and Taiwan residents. Passport verification prompts you to upload a copy. A mainland +86 number is not required; an international number that receives SMS codes is enough.

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

Source: Chaoyang District Government, Beijing — Overseas Bank Cards Accepted by Weixin Pay and Alipay (read July 24, 2026)

The amount charged does not match what you expected
Check the bank statement rather than the app.
The exchange rate on an international card is set by the card scheme and the issuing bank, not by the wallet, so it appears on the statement rather than inside the app.

Source: Ant International — Alipay+ | Pay in the Chinese mainland (read July 24, 2026)

Source: Tencent / WeChat Help Center — Guide to Add and Use International Cards with Weixin Pay (read July 24, 2026)

Every wallet path has failed and there is a queue behind you
Pay cash, then call the English support line later.
Since February 1, 2026 a merchant may not refuse RMB cash or treat a cash payer worse, staffed and face-to-face settings must support cash, and an unattended machine must display a fee-free cash route and a service contact phone number. Each wallet also publishes an English-language support line.Open the cash provisions

Source: People's Bank of China — Guide to Payment Services in China (2024 edition, page updated May 25, 2024; read July 24, 2026)

National policy · read August 2, 2026

What national payment policy says about foreign cards — and why a decline can still happen

Everything above is operational: which card to try, in what order. This is the State Council policy that sits above it, so it is what a foreign visitor can actually point to when asking whether their card is even meant to work.

Foreign-visitor mobile payment under the 2024 payment-convenience Opinions
What it means for youWhat the Opinions stateClause
Making foreign-visitor mobile payment work is an industry duty the State Council has ordered — you are not attempting a grey-area workaroundThe Opinions task banks, payment institutions and clearing institutions (银行、支付机构和清算机构) with continuously improving mobile payment while 充分考虑…外籍来华人员等群体需求 (fully considering the needs of foreign visitors to China) and 优化外籍来华人员线上、线下购买产品与服务的支付体验 (optimising foreign visitors' online and offline payment experience). Alipay and Weixin Pay are the licensed 支付机构 this clause names by role. So a foreigner is meant to be able to pay by mobile wallet in China; the friction is a policy problem the industry has been ordered to fix, not you doing something you are not allowed to do.Clause 二(三)
The same clause is why a specific card can still be declined — the mandate is conditioned on risk controlThat improvement mandate opens with 「在风险可控的前提下」 (on the precondition that risk is controllable). This is the sourced, non-invented reason an individual foreign card can still be refused even while national policy pushes to make binding work: a specific decline is the institution's own risk control acting within the policy, not the traveller failing some hidden requirement. The policy sets the direction of travel; it does not guarantee any one card binds — which is exactly why this page's 'which card to try next' list stays useful.Clause 二(三)
This is settled national policy, not a bank help page or a travel blogThe direction comes from the General Office of the State Council as 国办发〔2024〕10号, 落款成文日期 2024年3月1日, published on 中国政府网 (www.gov.cn) on 2024-03-07 — State-Council-level, current, and nationwide. It is the clause/policy layer the operator help pages and traveller forums answering this question do not carry, and that this page previously lacked.Clause 二(三)

This is one document read off its own full text on the government portal: the State Council payment-convenience Opinions. It proves the direction — that foreign-visitor mobile payment is meant to work — and the industry's duty to improve it, plus the 「在风险可控的前提下」 risk-control precondition. It does not name Alipay by brand, does not name Visa, Mastercard or American Express, does not say any specific card type must bind, and does not explain any individual decline. So the 'which card to try, in what order' steps on this page are operational triage, not statute, and are stated as such and left unchanged; nothing the Opinions do not cover is published here as sourced. There is no separate 「外卡内绑 / 外包内用」 clause — those are press labels absent from the text, so this page never asserts 'the law says your foreign card must be accepted'.

Published as 《国务院办公厅关于进一步优化支付服务提升支付便利性的意见》 (Opinions of the General Office of the State Council on Further Optimizing Payment Services and Enhancing Payment Convenience), 国办发〔2024〕10号 by General Office of the State Council (国务院办公厅), document 国办发〔2024〕10号 dated 2024-03-01, published on the Central People's Government portal 中国政府网 (www.gov.cn) on 2024-03-07.

Open source: the Opinions' full text on gov.cn

Page read

English support lines

When the app has failed, a phone call still works

These are published English-language service numbers. Calling does not depend on the wallet that just declined.

Alipay

  • +86 571 2688 6000
  • 0571 2688 6000 from a Chinese number

Ant International publishes staffed hours of 08:00-24:00 GMT+8, Monday to Sunday.

Weixin Pay

  • +86-571-95017

UnionPay

  • +86-21-95516
  • +86-21-20556900
  • 95516 from a Chinese mainland number

e-CNY

  • +86-10-956196

Published as a 24-hour line.

Source: People's Bank of China — Guide to Payment Services in China (2024 edition, page updated May 25, 2024; read July 24, 2026)

Source: Ant International — Alipay+ | Pay in the Chinese mainland (read July 24, 2026)

Before departure

Make the first checkout boring

The goal is not to guarantee every payment. It is to avoid learning the wallet under pressure.

  1. 1Install Alipay and Weixin Pay before departure and complete identity or card checks while calm.
  2. 2Check your network against the wallet's list first. Weixin Pay's operator list is the widest: Visa, Mastercard, JCB, American Express, Discover Global Network including Diners Club, and UnionPay. American Express is not on any official Alipay list we read.
  3. 3Link two cards if possible: one primary and one backup from a different bank or network.
  4. 4Find both payment actions: scan a merchant QR and show your own payment code.
  5. 5Tell the issuing bank you will travel if your bank supports travel notices.
  6. 6Save hotel address, first restaurant area, and a small cash/card backup for the first 48 hours.

Fallback sequence

If the payment fails, change one thing at a time

Step aside first

Do not debug in the queue. Move aside, keep the receipt screen or error visible if needed, and reduce pressure.

Switch the payment mode

Try showing your payment code if scanning failed, or ask for the shop's merchant QR if you were trying a personal transfer code.

Switch the network

Try mobile data instead of hotel Wi-Fi, toggle airplane mode once, and turn off VPN during the payment attempt if it appears to interfere.

Switch the wallet or card

Try Weixin Pay if Alipay failed, or the other linked card if the wallet lets you choose the funding source.

Use the human fallback

Use cash, a physical card at larger merchants, a staffed ticket counter, or hotel front desk help. Cash is not a favour here: since February 1, 2026 a merchant may not refuse RMB cash or treat a cash payer worse. Resolve the wallet later.

At an unattended machine, look for the phone number

Self-service settings have to display the accepted payment methods, a cash conversion route with no fee, and a service contact phone number in a conspicuous position. That number is the fastest route out of a failed ticket machine.

In short

Alipay, Weixin Pay, QR codes, and foreign cards

Short answers for the most common payment failure questions from first-time visitors.

Is there a fee for paying with a foreign card in China?

Weixin Pay publishes one: the transaction fee is waived for a single transaction under 200 RMB, and a single transaction above 200 RMB carries a 3% fee, reimbursed in proportion if the payment is refunded. Alipay publishes no fee schedule for an international card on any page we could reach, so we do not quote one.

How much can I spend with a foreign card in a Chinese wallet?

Weixin Pay's help page states a single-transaction limit of 6,500 RMB, a cumulative monthly limit of 50,000 RMB and a cumulative yearly limit of 65,000 RMB for an international card, read on July 24, 2026. A Chaoyang District government page still publishes 6,000 RMB single and 60,000 RMB yearly for the same wallet and carries no date, so plan against the operator's figures. The separate government policy ceiling for visitors is 5,000 US dollars per transaction and 50,000 US dollars a year, well above the wallet's own cap.

Which card networks can I link to Alipay and Weixin Pay?

Tencent lists Visa, Mastercard, JCB, American Express, Discover Global Network including Diners Club, and UnionPay for Weixin Pay. The central bank's 2024 guide lists Visa, Mastercard, JCB, Diners Club and Discover for Alipay. American Express does not appear on any official Alipay list we read, so an Amex-only traveler should set up Weixin Pay.

Why does Alipay fail even after I linked a foreign card?

Linking a foreign card only proves the card was added to the wallet. The live transaction can still fail because of merchant QR type, bank risk checks, wallet limits, identity prompts, network issues, VPN or Wi-Fi interference, or a merchant flow that does not support that funding path.

Am I even supposed to be able to use a foreign card with Alipay in China?

Yes. The State Council's payment-convenience Opinions (国办发〔2024〕10号, 2024) task banks, payment institutions and clearing institutions with improving mobile payment while fully considering the needs of foreign visitors to China and optimising their online and offline payment experience (clause 二(三)). Alipay and Weixin Pay are the licensed payment institutions that clause names by role. So making foreign-visitor mobile payment work is an industry duty the State Council has ordered — you are on the right side of national policy, not attempting a workaround.

If national policy says foreign-visitor payment should work, why is my card still declined?

The same clause opens with the qualifier 「在风险可控的前提下」 — on the precondition that risk is controllable. The improvement mandate is conditioned on the institution's own risk control, so a specific decline is that risk control acting within the policy, not you failing a hidden requirement. National policy sets the direction of travel and the industry's duty; it does not guarantee any single card binds, which is why the 'try the next card, in this order' steps above still matter. The Opinions do not name Alipay, Visa, Mastercard or American Express, and cannot explain any one decline.

Is a merchant QR different from a personal QR in China?

Yes, and the operators say so. Ant International states that an international bank card added to Alipay does not support person-to-person transfers, sending or receiving red packets, wealth management, insurance, or other financial services. Weixin Pay states the same limit in different words: an international card covers everyday purchases inside the mainland, not red packets or money transfers. A merchant code is a shop checkout; a personal code is a transfer, and a foreign card is not funded for it.

Do I need a Chinese phone number to fix a failed wallet payment?

No. Asked directly whether a Chinese mainland (+86) number is needed, Tencent's help page answers no: an international number works as long as it can receive SMS verification codes. What the wallet checks instead is a document — a passport, a PRC Foreign Permanent Resident ID Card, or a Mainland Travel Permit or Residence Permit for Hong Kong SAR, Macau SAR and Taiwan residents.

Should I use Alipay or Weixin Pay first as a foreign visitor?

Use whichever wallet you can set up and find quickly before landing. Many visitors prepare both, but one tested primary wallet plus a second fallback is better than two apps you cannot operate at the first checkout.

Can VPN or hotel Wi-Fi affect payment apps in China?

They can. Payment apps depend on network routing, app login, bank prompts, and risk checks. If a payment fails, try mobile data, turn off VPN for the attempt, and retry calmly before switching wallet or payment method.

What backup should I carry if mobile payment fails?

Carry a second wallet, second card, physical card, and small cash reserve for the first 48 hours. Hotels and larger merchants are more likely to accept cards than small restaurants or street-level shops, so do not rely on card-only backup for every purchase.

What if a shop refuses my cash after the wallet fails?

Refusing RMB cash has been prohibited since February 1, 2026 under the central bank provisions on cash receipts, payments and services. Merchants must respect the payer's choice of a lawful payment method and may not treat cash payers worse, staffed and face-to-face settings must support cash, and unattended machines must display a fee-free cash route and a service contact phone number. If cash is still refused, keep the evidence and apply to the local branch of the central bank rather than arguing at the counter.

Sources and next steps

Use official payment rules for the final check

TravelerLocal explains the operating pattern. Official wallet and government pages are still the place to verify current supported cards, limits, and app flows.

Weixin Pay international card guide

Tencent's help-center guide for adding an overseas card to Weixin Pay: the setup path, the identity documents accepted, and the current fees and transaction limits.

Open source

Cash acceptance rules in force since February 1, 2026

The central bank provisions behind the cash fallback: no refusing cash, no worse treatment for cash payers, a displayed cash route and service phone number at unattended machines, and where to take a refusal.

Open source

China travel payment hub

Use the main TravelerLocal payment page for the broader wallet, card, cash, and first-checkout setup sequence.

Open guide

Next move

Leave each page knowing what to do next.

Read enough to make the decision smaller, then open the checklist, search a specific question, choose a setup tool, or share the page with the person planning with you.

Official sources for rules, fares, payments, safety, and device setup.
Written around the day-one jobs: pay, connect, move, eat, get help.
Recommendations stay attached to a traveler task.

I need the next step

Use the checklist when the question has shifted from research to preparation.

Open checklist

I know the problem

Search by the actual problem: Alipay, eSIM, transit visa, first transfer, vegetarian food, or a city name.

Search the site

I am ready to choose

Open recommendations when the task is clear enough for a short list to be useful.

See recommendations