Quick Answer

First identify whether the failure is a card link, an identity prompt, a merchant decline, or an account restriction. Keep the exact error and do not repeat random fixes. International cards are for merchant purchases, not transfers or red packets. Check the issuer or current app prompt first; for a restriction, use official Alipay support. Then switch to WeChat Pay or cash backup before a payment problem becomes a travel problem.

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 What If Alipay Risk Control Is Triggered?.
  • 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.

Use this as a short, ordered diagnosis rather than a list of tricks. First save the message, then check the one system named in it: your card issuer for a card-authorisation message, the passport/card details for a verification message, the amount and product terms for a limit or fee message, or Alipay support for an account-status message. Do not keep unlinking, re-linking, and changing several account details while standing at a counter: that makes it harder to tell support which step actually failed.

These branches cover the common searches Alipay not working with a foreign card, Alipay payment failed for a tourist, Alipay verification failed with a foreign passport, and what to do if Alipay risk control is triggered.

Alipay lists seven international card networks for visitors: Visa, Mastercard, American Express, JCB, Discover, Diners Club, and overseas UnionPay. An eligible network is not a promise that a particular issuer or account will approve the link.

If a card will not add, or it links but every payment fails, separate three possibilities: the issuer did not approve the verification, the app requests another account check, or the payment channel is restricted. Start with the precise message; the Alipay setup guide is the right place to check whether the account, card, and merchant-test checkpoints were ever completed.

Before retrying, compare the entered name, card number, expiry date, and the mobile number your issuer has on file with the card record. Keep the phone or issuer app that receives card-security prompts available. This is not a promise that any particular card will be accepted; it is a way to rule out a data-entry problem before changing cards or asking the bank to investigate.

Your bank is blocking the transaction

Ask the issuer whether it approved the attempted card verification or merchant authorization. The published official traveler guidance says card eligibility, limits, and channels can vary; it does not publish a universal decline reason. Trip.com reports 3-D Secure and first-use bank checks as possible friction, but that is a traveler reference, not an official Alipay rule.

Give the issuer the time, amount, merchant or wallet name shown in the error, and the last four digits of the card; ask whether it can see and approve the attempt. If it cannot see an attempt, return to the exact Alipay prompt rather than assuming a call to the bank has solved it. If it sees and refuses the transaction, a different eligible card or a different payment method is usually more useful than repeated retries on the same card.

The card type isn't accepted

If the issuer cannot approve the card or the app still rejects it, use another eligible card rather than repeatedly submitting the same details. Do not assume that card type, brand, or a community report guarantees an outcome for your account.

The relevant distinction is the current response from the issuer and wallet, not an internet ranking of card brands. Keep one second card ready before travel, and add it only after you have recorded the first card's error. That preserves a clean fallback without turning a single failure into several overlapping account changes.

Historical overseas UnionPay promotion

The November 2024 UnionPay International notice advertised zero domestic-payment service fees for overseas UnionPay cards during its promotion period. Treat that as a historical promotion, not a current or permanent price promise: check current app and card terms before choosing a card for fees.

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.

Why Did Identity Verification Fail?

The Alipay+ traveler page says an e-wallet may ask for identity authentication, set limits, or constrain channels. It does not promise the same exact verification sequence for every foreign account, so follow the current passport and face/ID prompt rather than a screenshot from another traveler.

If it won't pass:

  • Re-enter the passport details only after checking them against the document and the prompt.
  • Improve capture conditions before retrying a document or face step.
  • Stop if the same error recurs; preserve a screenshot and use the official support route instead of treating an unverified lockout story as a fixed rule.

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.

Treat an identity request and a card request as separate checkpoints. A passport prompt does not by itself prove the linked card is ready, and a linked card does not remove every account-specific identity or channel prompt. Follow the live language in the app, use the same passport that you will carry on the trip, and keep the resulting message if the flow stops. The public traveler page deliberately says that authentication, limits, and channels may vary, so screenshots from another account are poor evidence of what your account will be asked to do.

Verification checkpoints before you retry

When the app reports a failure, note which checkpoint failed instead of repeating the whole setup:

  1. Identity checkpoint: the passport/face step completes and the app stops sending you back to identity verification.
  2. Card checkpoint: the card appears under Bank Cards and the last four digits are correct. A successful card link does not guarantee that a merchant will approve the first payment.
  3. Merchant checkpoint: a small normal merchant QR payment succeeds. Do not use a person-to-person transfer as a test; foreign cards are intended for merchant payments.
  4. Transport checkpoint: a metro or bus Transport Code is a separate mini-program and auto-debit agreement. A normal payment QR working does not prove the ride code is enabled.

Save a screenshot of the exact error, the time, and the merchant or transport service. Stop after a small number of retries; if the same checkpoint fails again, use the official Alipay Service Center rather than changing several account details at once. This gives support something precise to investigate and reduces the chance of triggering another risk check.

Why Was My Payment Declined?

If the card is linked and a particular payment fails, first confirm that it is a merchant purchase. International cards do not support person-to-person transfers, red packets, wealth management, insurance, or similar financial services. Then compare the exact amount and error with the current in-app terms and issuer response.

Transaction limits

PBOC's 2024 optimization raised foreign-visitor mobile-payment platform caps to US$5,000 per transaction and US$50,000 annually, and the Shanghai notice states the same figures. These are platform caps, not an assurance that a particular card or account will clear every charge. For a material payment, use the current product prompt and ask the merchant about an alternate accepted method instead of attempting to defeat a limit by splitting transactions.

Those published platform figures are useful context, but they are not a travel budget or a guarantee. Your issuer can have its own authorisation rules, and the wallet can show a different account-specific prompt. For an expensive hotel bill, ticket, or purchase, confirm the amount, fee display, and merchant's fallback method before the final checkout step. If the message says a limit was reached, use the in-app explanation and official support; do not create a second account or try to bypass the restriction.

The service fee is normal, not an error

Do not rely on an old fee threshold or a screenshot from another account. A fee shown at the current Alipay confirmation screen is not, by itself, a payment failure: read the live amount and terms before approving a material purchase, then compare the issuer statement after the transaction if you need to query it. Alipay+ says it does not collect an additional fee for its cross-border payment service, while its traveler guidance says the card scheme and issuer determine the exchange rate for an international card. That Alipay+ statement is not a universal price promise for every card-linked Alipay path; use the current in-app confirmation and your issuer's terms for the charge in front of you.

"Account restricted" or frozen

What if Alipay risk control is triggered?

If Alipay shows risk control, restricted, limited, or under review, treat the visible wording as an account-status signal rather than a diagnosis. Stop repeated attempts, save a screenshot with the time and affected merchant or transport service, and do not assume that changing the card or opening another account will clear the review. The official traveler page says identity authentication, limits, and payment channels can vary by wallet and account; it does not publish a universal unlock time.

The official traveler page lists +86 571 2688 6000 for calls from overseas (08:00–24:00, GMT+8). Use its current in-app Customer Service option if the number or menu differs for your account.

Have your passport, the account phone number, the time and screenshot of the message, and the affected card's last four digits ready. Describe the exact visible status rather than diagnosing why it happened. The official traveler material provides a support route, but does not publish a fixed review or unlock time, so plan a backup instead of waiting for a particular number of hours. Because a restriction can leave you unable to pay, always carry a backup — WeChat Pay, a second card, and some cash — so it 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:

  • Start with the live-code checks. If the scanner says to refresh, refresh the Transport Code and try again. If it says the code cannot be used or identification failed, check that the code's named service area matches the place where you are boarding.
  • Check setup as a separate branch. If the Transport Code service or its auto-debit agreement was not completed, enable the service in the Cross-border Transport mini program before trying to use the ride code. A normal Alipay payment QR does not substitute for a ride code.
  • 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.

If you scan and the gate still does not open, go to the station customer-service centre rather than repeatedly scanning or sharing a screenshot. The official FAQ also directs riders to the code's Line Routes area for the supported routes; city and route coverage is therefore a live check, not an assumption based on another city.

If a previous entry or exit was not recorded, use the missing-ride record path in the Transport Code settings or ask station staff to correct the trip record. A delayed fare can reflect the documented ride-first, pay-later model, so check ride history before treating it as a duplicate charge. Where the code or route is unavailable, buy a single-journey ticket or use the local transit option offered by the operator.

When Should I 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 — a separate wallet to prepare and test, not a promise that the same card will clear.
  • Cash backup — carry a practical fallback for a wallet or merchant failure.
  • A physical card at the counter — ask the merchant what it accepts before attempting another app payment.

For a non-urgent setup problem, use a calmer recovery order: screenshot the message; identify whether it names the issuer, a card detail, identity, a limit, the account, or the transport code; make one correction or support contact for that named checkpoint; then test one small merchant purchase only after the message has changed or the issuer confirms action. If the error is unchanged, stop that path for the moment and use a prepared alternative. This avoids two bad outcomes: repeatedly attempting a payment while the merchant waits, and confusing a bank decision with an identity or transport-code issue.

For a larger purchase, ask before checkout whether the merchant can accept a physical card, another wallet, cash, or a payment link. Do not let a booking, a departure time, or a long queue force an untested wallet into being your only option. The sensible result of a failed app payment is a documented support case and a working backup, not an improvised workaround.

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

  • 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.

Sources & Verification

All factual claims in this guide are verified against the primary sources listed below. Official Chinese government sources take priority.

  • Pay in the Chinese mainland — Alipay+ — Alipay+ official traveler page, reviewed 2026-09-20, 官方指南; verifies the supported international card networks, that e-wallets "may ask for identity authentication, set payment limits or constrain payment channels," that "no extra fees will be charged by Alipay+," the current overseas support number, and that international bank cards "do not support person-to-person transfers, sending or receiving red packets, wealth management services, insurance services."
  • 外籍人员在沪扫码消费单笔限额升至5000美元 — Shanghai Municipal Government, 2024-03, 官方文件; verifies the single-transaction limit raised from US$1,000 to US$5,000 and the annual limit from US$10,000 to US$50,000 for foreign-card mobile payments.
  • 优化支付服务 提升支付便利性专题 — People's Bank of China (PBOC) official topic page, 2024, 官方文件; verifies that the PBOC guided major payment institutions to raise foreign visitors' single-transaction limit to US$5,000 and annual cumulative limit to US$50,000, and reports first-half-2024 "外卡内绑" (foreign-card binding) volume of 37.38 million transactions.
  • 境外银联卡全面支持绑定支付宝 — UnionPay International official news, 2024-11-06, 官方文件; verifies that overseas-issued UnionPay cards can be bound to Alipay and that cardholders pay "zero service fee for domestic payments" — stated explicitly as applying "during the promotion period" (推广期内), not as a permanent exemption.
  • Transport Code FAQs — Alipay+ Docs — Alipay+ official documentation, 官方指南; verifies that the Transport Code (乘车码) is enabled through the Alipay+ Cross-border Transport mini program by signing an auto-debit agreement, runs on a "ride first, pay later" deduction model, and is for personal use only.
  • Why Alipay Is Not Working in China and How to Fix It — Trip.com travel guide, updated 2026-07-02, 综合参考; used only for the reported card-decline mechanics (3-D Secure verification, banks flagging first China transactions, unsupported prepaid/business cards) and a reported 24-hour lockout after repeated failed verification — not an official source, and presented as reported rather than confirmed.