By Marcus Wright, Contributing Editor | Updated October 2026
"Payment declined." Two words you never want to see on a payment terminal in a foreign country — especially when the street behind you is crowded, the vendor is waiting, and the alternative is a large bundle of cash you may or may not have on hand. Declined Alipay and WeChat Pay payments are frustratingly common among first-time visitors, but almost every failure falls into one of a small number of predictable categories — and almost all of them have a fix, often in under five minutes if you know where to look.
This walkthrough covers the 11 most common decline scenarios we have documented in visitor feedback and on-the-ground reporting across Beijing, Shanghai, Chengdu, Xi'an and Guilin, with step-by-step fixes for each one. We assume you have already gone through the basic setup in our mobile payment setup guide — this is what comes after. We also include a quick pre-departure checklist at the end so you can head off many of these issues before you board your flight.
The Immediate First Step (Always)
Before you debug anything: quit the app, force-close it, and retry the payment. A surprising number of "declines" are actually transient glitches — the QR code scanner did not read correctly, the app crashed mid-checkout, or the connection to the wallet processor dropped for 20 seconds. If a payment fails once, close the app completely (on iOS: swipe it away; on Android: press Recent and swipe), reopen it, re-scan the QR code, and try again. This solves roughly one in four apparent declines immediately. Do not skip this — you can waste 15 minutes troubleshooting a card issue that was actually a single dropped packet.
Scenario 1: Foreign Card Not Supported at the Linking Step
How it looks: When you try to add a Visa or Mastercard to Alipay or WeChat Pay, you get a message in Chinese or English like "This card is not supported" or "Card issuer refused authorization."
What is happening: Alipay and WeChat Pay both accept Visa, Mastercard, JCB and Discover for tourist accounts, but the card issuer (your home bank) must allow international card-not-present transactions to be routed through these wallets. Some banks block all transactions to Chinese entities by default as a fraud precaution. Other times the card itself is on a restricted list — prepaid debit cards, some corporate cards and certain European Maestro cards are routinely rejected.
Step-by-step fix:
- Stop trying to add more cards to the same wallet for 30 minutes — repeated failed linking attempts can temporarily lock the wallet's card-linking functionality.
- Open the card issuer's mobile banking app or call their 24-hour international hotline. Explain that you are trying to link your card to Alipay or WeChat Pay for travel in China and need international card-not-present transactions enabled. Specific mention of "Alipay" and "WeChat Pay" matters — some banks have block rules that target these exact merchant codes.
- If your home bank says the card is unsuitable (common with prepaid or Maestro cards), pull out a different card. A primary credit card with a well-known issuer (Chase, Citi, HSBC, Royal Bank of Canada, ANZ, etc.) is far more likely to work than a secondary debit card from a small regional credit union.
- Retry the linking from a stable Wi-Fi or 4G connection.
Prevention: Test card linking from your home country before departure. A failed linking attempt in the privacy of your hotel room beats the same failure at a market stall in Guangzhou.
Scenario 2: Name Mismatch Between App and Passport
How it looks: Your payment is rejected with a message that mentions identity verification, or it works sometimes but declines on larger transactions.
What is happening: During tourist mode setup, both Alipay and WeChat Pay require you to enter the name exactly as it appears on your passport — middle names, hyphens, accents, apostrophes, everything. If you typed "John Smith" but your passport reads "John Michael Smith," or if you wrote "José García" as "Jose Garcia," the wallet's identity verification system sees two different names. Small transactions under a certain threshold (usually RMB 200–500) may still process, but larger ones trigger the mismatch check and fail.
Step-by-step fix:
- Open Alipay or WeChat Pay settings → personal information / identity verification.
- Compare every letter of your entered name with your passport exactly. Pay attention to hyphens, accents and whether the system asked for first+last vs full legal name.
- Correct the name and re-submit verification. This usually triggers a new review that takes 5–30 minutes.
- Re-add your linked cards after the name update goes through — the wallet's internal name change can sometimes break existing card links.
Prevention: When you first set up the app, type the name directly from your passport page — do not guess. Take a photo of your passport name page and type from that photo if you are unsure about any character.
Scenario 3: Expired or Pending Identity Verification
How it looks: Payments used to work but suddenly decline with a message about "account security check" or "please complete real-name verification."
What is happening: China's regulations require all payment accounts to undergo real-name identity verification. Tourist accounts are valid for a set period (usually 90 days from verification), after which the system forces a re-check — and if you cannot complete it (for example, because you already left China), it freezes outgoing payments. More rarely, the verification never completed properly because the photo you submitted was blurry or your passport had a glare.
Step-by-step fix for expired verification:
- Open the app and look for a red or orange notification banner that says "请完成实名认证" (Please complete real-name verification).
- Tap the banner and follow the photo prompts. You will need to take a clear photo of your passport's biometric page and a selfie matching the photo. Make sure there is no glare and the passport text is sharp.
- The re-verification is usually approved within 10 minutes; occasionally it takes up to 24 hours.
Step-by-step fix if verification never completed: You will need to delete the app entirely and reinstall it, then go through setup again from scratch. This is annoying but occasionally necessary if the system left your account in a half-verified state. Do this before you need the wallet for an urgent payment.
Scenario 4: Bank Fraud Block on a Single Transaction
How it looks: You have paid successfully five times that day, then the sixth payment at a small vendor is declined. Alipay/WeChat Pay show the decline as coming from the card issuer, not the wallet.
What is happening: Your home bank's fraud algorithm flagged one specific transaction — maybe the location changed suddenly, the amount was outside your usual pattern, or the vendor merchant code looked unusual. The wallet itself is fine; your card issuer blocked just this one.
Step-by-step fix:
- Do not keep retrying the same card at the same terminal — multiple fraud flags from the same merchant can get your card locked entirely.
- Use the other wallet (Alipay if you were on WeChat, or vice versa) or a different card.
- When you have a moment, call your home bank's international fraud line. Give them the approximate time and amount of the declined transaction. They will confirm it is you, remove the block, and sometimes offer to flag your account for "travel in China" so future transactions are smoother.
Prevention: Set a travel notice on your home bank's app before you fly. Specify "mainland China" and "mobile payments" if the app offers a category. This eliminates 60–70% of single-transaction fraud blocks.
Scenario 5: SMS Verification Code Not Arriving
How it looks: You are prompted to enter a 6-digit SMS code to verify a payment or update a card, but the text never comes — or it comes 10 minutes late.
What is happening: International SMS delivery is unreliable inside China. Your home carrier routes the SMS through a Chinese partner network, which adds latency. If you are on a temporary local SIM that is not fully registered (some visitor SIMs), you may not receive international SMS at all.
Step-by-step fix:
- Wait 2–3 minutes, then tap the "resend code" button once. Do not spam the button — that triggers a cooldown of 5–10 minutes.
- If using a local Chinese SIM, check with the SIM shop that international SMS is enabled.
- Switch to Wi-Fi. Some mobile carriers suppress SMS over roaming data connections.
- WeChat Pay sometimes lets you verify via voice call instead. Listen for an option that says "语音验证码" (voice verification code).
- As a fallback, use your second wallet or a card that does not require SMS verification for small transactions.
Scenario 6: Daily or Monthly Limit Hit
How it looks: The decline message specifically mentions "limit," "限额" or the RMB amount you tried to pay being over a threshold.
What is happening: Tourist accounts have different transaction limits depending on verification level. A minimally verified tourist account may cap at RMB 2,000–5,000 (USD 280–700) per transaction and RMB 20,000 (USD 2,800) per day. Fully verified tourist accounts go higher. If you are splitting bills, buying expensive electronics, or doing multiple transfers in one day, you can hit the ceiling quickly.
Step-by-step fix:
- Check your current limits in Alipay → Settings → Account Security → Limits, or WeChat Pay → Me → Services → Wallet → Limits.
- If a single purchase is over your per-transaction cap, ask if the store can split it into two separate payments — most will if you explain politely.
- Switch to a credit card or cash for larger items if the wallet cap is still too low.
- For WeChat Pay specifically, adding a second linked card can sometimes double the effective daily limit.
Scenario 7: Merchant Has a Problem, Not Your Wallet
How it looks: Every payment you try at this one store fails, but payments at other stores that same day work fine.
What is happening: The vendor's Alipay/WeChat Pay terminal or QR code is broken, expired, or set up incorrectly. This is far more common than most visitors realize — street vendors with cheap Android devices frequently drop their QR codes or have outdated terminals.
Step-by-step fix:
- Confirm with the vendor that their QR code page is active and showing the "请扫码付款" (Please scan to pay) prompt.
- Have them close the payment app on their end and reopen it — the merchant-side app can also crash.
- If all else fails, switch to another payment method. This is exactly why you carry cash and a backup card.
Scenario 8: DCC (Dynamic Currency Conversion) Refusal
How it looks: You are offered the choice to pay in USD or RMB. You tap USD, and the payment is immediately declined.
What is happening: When you use a foreign card, the wallet sometimes offers a DCC option to show you the charge in your home currency. Some card issuers automatically block DCC transactions to prevent the markup (usually 1.5–3%) that comes with them.
Step-by-step fix:
- Always pay in RMB when given the choice. That is both cheaper and less likely to trigger a block.
- If you accidentally selected USD, close the payment screen and re-scan the QR code to start fresh.
For more on how DCC and similar fees eat into your budget, see our foreign card fees guide.
Scenario 9: Wallet App Out of Date
How it looks: The app works for small transactions but shows an error message that partially translates to "incompatible version" or "please update."
What is happening: Alipay and WeChat Pay push updates regularly, and older versions sometimes stop accepting international card transactions first (domestic Chinese payments may still work). This catches travelers who installed the app three months before their trip and forgot to update it.
Step-by-step fix:
- Connect to Wi-Fi (roaming data may be slow for large updates).
- Open App Store (iOS) or Google Play (Android), search for Alipay or WeChat Pay, and update.
- Reopen the app and retry.
Scenario 10: Insufficient Foreign Card Balance / Credit Limit
How it looks: The decline message is generic — "insufficient funds" or "not enough balance" — even though you know the card has room.
What is happening: Foreign card balances in wallets are occasionally reported incorrectly due to a delayed network sync. The wallet thinks you have less available than the card issuer actually shows.
Step-by-step fix:
- Go to the card section of the wallet, tap the card, and select "refresh balance" if available.
- If that does not work, remove the card from the wallet and re-add it — this triggers a fresh balance check.
- If the card genuinely has insufficient funds, switch to your second card. Always have at least two cards linked.
Scenario 11: Network or Connection Problem
How it looks: The app keeps spinning on the "processing payment" screen and never confirms or declines.
What is happening: The payment is in an ambiguous state — your money may or may not have left the card, but the wallet lost the confirmation. This is the most stressful scenario because you can end up double-charged if you retry after the payment actually went through.
Step-by-step fix:
- Do not tap the retry button.
- Wait 60 seconds, then open the wallet's payment history (Alipay: "My → Payment Records"; WeChat Pay: "Me → Services → Wallet → Bills").
- If the payment shows as "successful," you are done — even if the terminal still looks stuck. Tell the vendor and they will receive a merchant-side confirmation.
- If it shows as "processing" or "failed," force-close the app and reopen it. The status will usually resolve on the second load.
- If 10 minutes pass and the status is still unclear, call your home bank and ask them to verify whether a pending charge exists. If yes, you are fine; if no, retry the payment.
Pre-Departure Checklist (Do This from Home)
- Install and verify both Alipay and WeChat Pay — do not rely on one.
- Link each wallet to at least one credit or debit card (preferably two cards, one per wallet).
- Set travel notices on all home bank cards specifying "mainland China" and international mobile payments.
- Test every wallet-card combination with a tiny purchase (your home country's equivalent of RMB 20) to confirm it works.
- Update both apps to the latest version.
- Have a backup plan: a small amount of local cash, and at least one physical card that works independently of the wallets.
- Save your home bank's international fraud line number in your phone before you leave.
Frequently Asked Questions
My card works in my home country but not on Alipay or WeChat Pay. Why?
Alipay and WeChat Pay use different card network APIs than your home bank's debit terminal or credit card gateway. A card that works fine with Visa or Mastercard in your home country may still be blocked by the wallet's merchant-side processor, especially if your bank has not explicitly enabled international card-not-present transactions with these specific Chinese entities.
Should I link both Alipay and WeChat Pay to the same card?
Yes — having both wallets installed and each linked to at least one card gives you redundancy. A payment that declines on Alipay may succeed on WeChat Pay because the two wallets have slightly different international card routing logic. Install both before departure, verify both, and link each to a separate card if possible.
Can I use a prepaid travel card with Alipay or WeChat Pay?
Results vary by provider. Most Visa- and Mastercard-branded prepaid travel cards work, but some are rejected during the card-linking step because the issuing bank does not allow card-not-present international transactions. Test the linking process from your home country before you leave and have a backup card ready.
How long does it take to resolve most payment declines?
Simple fixes — switching wallets, using a different card, or retrying after clearing the app cache — typically work in under five minutes. Fraud blocks from your home bank require a phone call that can take 10–20 minutes. Identity verification resets may take 24–72 hours, so these must be handled from your home country before departure.