Alipay Troubleshooting: What to Do When Payments Fail in China

Quick Answer

Almost every Alipay problem a foreign visitor hits falls into one of three buckets, and the right fix depends on which bucket you are in:

• Your card won't link, or a payment is declined. This is usually your issuing bank's decision, not Alipay's. The fix is on the bank's side (or you use a different card).
• Identity verification won't pass. Passport scan or the face check keeps failing. This is fixable with better conditions and patience.
• "Account restricted," frozen, or payments blocked. Only Alipay's own support can lift a restriction. Do not burn time on internet "tricks" — go straight to official support.

The single best defense is set up before your trip: install and test Alipay at home (see the setup guide), carry at least two cards, and keep WeChat Pay plus some cash as backup so one failure never strands you. Payment rules, limits, and fees in China change often, so treat every number below as current as of the last review and confirm anything critical in-app before you rely on it.

First, work out which failure you have

Before you change anything, read the on-screen message. Alipay usually tells you where the problem is:

• A message about your bank, card network, or "issuer" → the card or bank is refusing. Go to Card won't link or gets declined.
• A message about verification, ID, or a face/photo check → go to Identity verification keeps failing.
• A message about a limit, amount, or "exceeded" → go to Payment declined or over your limit.
• A message that your account is restricted, limited, or under review → go to "Account restricted" or frozen.
• A transport / ride / metro QR problem → go to Transport and metro code errors.

Changing the wrong setting (for example, re-verifying your identity when the real problem is your bank) wastes time and can trigger extra security checks.

Card won't link or gets declined

Alipay supports seven international card networks for visitors: Visa, Mastercard, American Express, JCB, Discover, Diners Club, and overseas UnionPay. In practice Visa and Mastercard are the most reliable; support for the others varies by issuing bank and account type.

If a card won't add, or it links but every payment fails, the cause is almost always on your bank's side rather than Alipay's:

Your bank is blocking the transaction

Many banks automatically flag or freeze the first transaction from China as suspicious. According to Trip.com's payments guide, banks commonly reject first-time China charges and Alipay uses 3-D Secure (Verified by Visa, Mastercard SecureCode) to authorize foreign cards, so a card that can't complete that step will fail. Treat those specifics as reported rather than official — but the action is the same and reliable: call your bank (use the number on the back of the card), tell them you are traveling in China and using Alipay, and ask them to allow the charges. Many travelers find the card works on the very next attempt.

The card type isn't accepted

Some debit cards, prepaid cards, and business/corporate cards are not accepted even when they belong to a supported network. If linking keeps failing, try a different personal credit card.

Prefer an overseas UnionPay card if you have one

Overseas-issued UnionPay cards are fully supported for Alipay binding, and — during the current promotion period — carry no service fee on domestic payments. That fee waiver is officially described as promotional, not permanent, so don't assume it forever, but it makes a UnionPay card the cheapest option to link if you hold one.

It links but you can't send money to a friend

That's expected, not a bug. International bank cards on Alipay cannot do person-to-person transfers, send or receive red packets (红包), or use wealth-management and insurance features. They are for paying merchants. If you need to repay a friend, use cash or have them collect from the merchant directly.

Identity verification keeps failing

Before you can pay, Alipay requires real-name identity verification. The Alipay+ traveler page confirms e-wallets "may ask for identity authentication" — in practice this means a passport scan plus a facial-recognition (liveness) check. It is the step foreign users most often get stuck on.

If it won't pass:

• Use your passport, not another ID, and make sure the passport is the one you'll actually travel on.
• Improve the scan conditions: flat surface, bright even light, no glare on the passport photo page, whole page in frame.
• Do the face check in good lighting, hold the phone steady, and remove glasses/hat if it keeps rejecting you.
• Don't hammer it. Trip.com reports that after roughly three to five failed verification attempts Alipay temporarily locks the flow for about 24 hours. If you hit a wall, stop, wait, and retry the next day rather than triggering a longer lock. (This lockout figure is reported, not officially published.)

Because verification can stall on arrival, do it at home before you fly, on stable wifi — it is the biggest reason to set Alipay up early.

Payment declined or over your limit

If the card is fine and verified but a specific payment won't go through, you may be hitting a limit or a fee threshold.

Transaction limits

Under the People's Bank of China's 2024 payment-service optimization, major platforms raised foreign visitors' mobile-payment limits to a single-transaction cap of US$5,000 and an annual cumulative cap of US$50,000 (the Shanghai municipal notice states the same figures). For ordinary meals, taxis, tickets, and shopping you will rarely approach these, but a single large purchase (electronics, luxury goods, a big hotel bill) can exceed the per-transaction cap. If it does, split the payment, pay part in another way, or use a physical card at the counter.

The service fee is normal, not an error

For foreign cards, transactions of ¥200 or less are fee-free, and amounts above ¥200 are charged about 3% (Alipay's foreign-card fee is aligned with WeChat Pay's). That fee is expected — it is not a failed payment. Alipay+ itself charges no additional fee on top; the exchange rate is set by your card network and issuing bank. If you want to avoid the 3%, keep individual charges at or under ¥200 where practical, or use an overseas UnionPay card (fee-free during the promotion period).

"Account restricted" or frozen

If Alipay says your account is restricted, limited, or under review, payments stop until Alipay lifts it. This can be triggered by risk-control checks, and there is no reliable self-service "unfreeze trick" — attempts to work around it can make things worse.

The one correct move is to contact Alipay's official support:

• Phone: +86-571-95188 (Alipay's official customer-service line).
• In-app / online: open the Alipay Service Center, choose the human-service option ("人工服务"), and connect to an online agent.

Have your passport and account details ready. Because a restriction can leave you unable to pay at all, this is exactly why you should always carry a backup — WeChat Pay, a second card, and some cash — so a restricted Alipay account is an inconvenience, not an emergency.

Transport and metro code errors

Paying for metros and buses uses a separate Transport Code (乘车码), not your normal Alipay payment QR — so a working Alipay doesn't automatically mean a working ride code.

Per Alipay+'s documentation, you enable it through the Alipay+ Cross-border Transport mini program: turn on the service and sign the auto-debit agreement. It then runs "ride first, pay later" — after you exit the station or leave the vehicle, the fare is calculated and deducted from your linked wallet. Two things that trip people up:

• If the gate won't scan your code, you probably haven't enabled the Transport Code service (or the auto-debit agreement) yet — the general payment QR won't open a metro gate.
• The code is personal-use only. Don't let a travel companion scan your code; each person needs their own, and you carry the financial risk if it's shared.

City coverage varies, so in a city where the ride code isn't supported, buy a single-journey ticket at the machine or use a transit card instead.

When to stop troubleshooting and switch

Set a limit on how long you'll fight a payment at a counter with a queue behind you. If Alipay won't work after a quick check, fall back:

• WeChat Pay — the same foreign-card setup and fee rules apply; a card or check that fails on one sometimes clears on the other.
• Cash — still legal and accepted; keep enough small notes for taxis, small shops, and any vendor whose scanner is down.
• A physical card at the counter — larger hotels, department stores, and some restaurants take Visa/Mastercard/UnionPay directly, which sidesteps app limits entirely.

Redundancy is the whole strategy: no single point of failure should be able to strand you.

Related setup guides

• How to use Alipay in China — the setup, verification, and card-linking walkthrough this guide troubleshoots.
• How to use WeChat Pay as a foreigner — your primary backup wallet.
• Carrying cash as a backup in China — how much to hold and where cash still matters.