The merchant’s QR code is on the screen. Your phone is out. You scan. Nothing. You try again. The app spins, then returns an error message in Chinese characters that offer you no comfort whatsoever. Behind you, a queue is forming. This moment — the Alipay failure in a cashless society — is among the most stressful a foreign user of China’s payment ecosystem can experience. This guide is the comprehensive resource for when Alipay stops working, covering every significant failure mode and its solution.
1. Alipay Payment Failed: Error Codes and What They Mean
Alipay displays error messages that are often in Chinese or in cryptic alphanumeric codes. Here are the most commonly encountered ones and their meanings:
“Payment failed, please try again later”: Generic error. Usually a temporary server-side issue or network timeout. Wait 2–3 minutes and retry. If persistent, check your internet connection.
“Insufficient account balance”: Your Alipay wallet balance is zero or below the payment amount. Solution: top up your wallet via a linked card before attempting payment.
“Daily/monthly limit reached”: You have hit Alipay’s spending limit for your account tier. Foreign-card-linked accounts have a ¥50,000 annual spending cap. You cannot exceed this without upgrading verification.
“Identity verification required”: The merchant or transaction type requires a higher verification tier than your current account holds. You must complete real-name verification (身份认证) before proceeding.
“Abnormal account activity detected”: A risk flag has been triggered — usually by an unusual pattern (new device, new location, large transaction). You may need to complete a security check via SMS or identity re-verification.
2. Alipay Won’t Open or Keeps Crashing
Fix 1 — Force close and restart: On iPhone, swipe up from the bottom and swipe away the Alipay card. On Android, use the recent apps button to clear it. Reopen from fresh.
Fix 2 — Check for app updates: An outdated version of Alipay frequently causes crashes. Open the App Store or Google Play and check for pending updates. Alipay updates frequently — sometimes weekly.
Fix 3 — Clear app cache: On Android, go to Settings → Apps → Alipay → Storage → Clear Cache. On iPhone, there is no direct cache clear — uninstall and reinstall the app if crashes persist.
Fix 4 — Check available phone storage: Alipay requires a minimum of ~200MB free storage to function. A full phone causes instability in payment apps. Delete unnecessary photos or apps.
Fix 5 — Reinstall the app: If none of the above works, uninstall Alipay completely and reinstall from the official source. Your account data is cloud-based and will be restored upon login — you will not lose your wallet balance or linked cards.
3. Alipay QR Code Not Scanning
The QR code payment flow can fail at either end — your scanner failing to read the merchant’s code, or the merchant’s device failing to read your payment code.
When scanning a merchant’s QR code:
- Ensure sufficient ambient lighting — QR codes need contrast to scan. In dim restaurants, ask the staff to add light or use your phone torch
- Hold the phone steady 15–30cm from the code — too close or too far both fail
- Clean your camera lens — a smudged lens prevents clean reads
- If the code is printed and laminated, glare can prevent scanning — shift your angle slightly
- Ask the merchant to show you the QR code in their app (dynamic code) rather than a printed static code — dynamic codes are more reliable and add fraud protection
When the merchant scans your payment code:
- Increase screen brightness to maximum — dim screens are the single most common cause of scanner failure
- Ensure the payment code is fully loaded (it has a rotating security refresh — wait for the full code to appear)
- If your Alipay is set to face unlock, ensure the face scan completes before presenting the code
- Try generating the code again if it has been on screen for more than 60 seconds (codes expire)
4. Alipay Linked Card Not Working
For foreign users, the most common payment failure point is the international card linked to Alipay International.
Card declined during top-up: Your card issuer may block international transactions by default, particularly for new merchants. Call your bank’s international line and authorise transactions from Alipay. Some banks require you to whitelist specific merchant category codes (MCC) for digital wallets.
Card expired: Check the expiry date on your linked card within Alipay’s card management section. If expired, remove the old card and add the replacement.
Insufficient credit/funds on the linked card: Alipay top-ups require your card to have sufficient funds plus any foreign transaction fee (typically 1–3% on credit cards). Ensure you have headroom.
Card not supported: Alipay International accepts Visa, Mastercard, JCB, American Express, and Discover in most regions. Some regional debit cards and prepaid cards are not accepted. If your card fails consistently, try a different card.
5. Alipay Account Frozen or Blocked
Account freezes are among the most alarming issues foreign users encounter. They occur when Alipay’s risk system flags unusual activity. Common triggers include:
- Logging in from a new device or country
- Multiple failed payment attempts in quick succession
- Large transactions that exceed your typical spending pattern
- Incomplete identity verification for account tier
- Reports from counterparties of disputed transactions
Resolution process:
Step 1: Open Alipay and tap the profile icon → Help Center → Security → Account Frozen.
Step 2: Alipay will prompt you through an identity verification flow. For International accounts, this typically involves re-submitting passport details and a selfie.
Step 3: If automated verification fails, contact Alipay International customer service via the in-app chat (Me → Help Center → Contact Us). Response times for international accounts are typically 24–72 hours.
Step 4: If you have an Alipay Plus account (business), contact your dedicated account manager — enterprise accounts receive priority unfreeze support.
6. Alipay Face Recognition / Fingerprint Not Working
Biometric authentication failures are common after phone updates or hardware changes.
Face ID failing on iPhone: If your iPhone’s Face ID was reset (e.g., after iOS update), Alipay may not recognise the new biometric profile. Go to Alipay Settings → Security → Biometric Authentication → Re-enable Face ID and re-confirm your Alipay payment password to re-link.
Fingerprint failing on Android: Same principle — after an OS update or fingerprint re-enrolment on the phone, Alipay needs to be re-authorised. Navigate to Alipay’s security settings and re-enable fingerprint payment.
Emergency fallback: If biometrics are temporarily unavailable, you can always pay using your 6-digit Alipay payment password. This password is set separately from your app login password. If you have forgotten it, reset via Alipay → Me → Settings → Security → Payment Password → Forgot Password.
7. Alipay Mini Programs Not Loading
Alipay hosts thousands of Mini Programs — lightweight apps for ordering food, booking transport, and accessing services. When they fail to load, the cause is almost always one of three things:
- Poor internet connection: Mini Programs are cloud-streamed and require a stable connection. Switch from mobile data to WiFi or vice versa
- Mini Program server outage: The third-party service hosting the Mini Program may be temporarily down — this is outside Alipay’s control
- Alipay version incompatibility: Some newer Mini Programs require the latest Alipay version. Update the app and retry
8. Alipay Not Working Abroad (Outside China)
Alipay’s coverage outside China is expanding but remains patchy. Key facts for international use:
Countries with Alipay acceptance: Japan, South Korea, Singapore, Malaysia, Thailand, UAE, France, Germany, UK, Australia — all have merchant acceptance, particularly in tourist areas and duty-free shops. Acceptance is not universal; look for the Alipay logo or the Alipay+ network mark.
If payment is declined abroad: Ensure your Alipay account has sufficient balance (international payments draw from wallet balance, not linked card in some regions). Check that your account is not restricted to China-only payments — in Alipay settings under “International Payments,” confirm overseas use is enabled.
Currency conversion abroad: Alipay converts at its internal rate when you spend in foreign currencies. The rate is generally competitive but check your account statement to confirm the actual rate applied.
9. Alipay Verification Rejected
Real-name verification rejection is a frustrating but solvable problem for foreign users. Common rejection reasons:
- Passport photo is blurry or partially obscured — reshoot in natural light, ensure all four corners of the document are visible
- Name entered does not exactly match passport (middle names omitted, initials vs full name) — use exactly the name as printed on the passport document
- Expired passport submitted — use a valid document with at least 6 months remaining validity
- Selfie does not match ID photo — ensure consistent lighting, remove glasses, look directly at the camera
- Nationality restrictions — a small number of nationalities face enhanced checks; allow 48–72 hours for manual review before assuming rejection is final
10. Internet Connection Issues
In China specifically, internet connectivity affects Alipay differently than abroad. The Great Firewall does not block Alipay itself, but VPN usage can interfere with Alipay’s security systems — some users find their accounts flagged when a VPN is active. If you are in China and experiencing unexplained Alipay failures, disable your VPN and retry.
Outside China, Alipay functions on any internet connection. If payments are failing despite good connectivity, the issue is account-level rather than network-level.
11. When to Contact Alipay Support
If the above steps have not resolved your issue, escalate to Alipay’s support channels:
- In-app chat: Me → Help → Customer Service → Chat Now. Available in English for International accounts
- International helpline: Available in select countries via the Help Center’s contact options
- Social media: Alipay’s official Twitter/X and Facebook pages respond to public support queries, often faster than formal channels
When contacting support, have ready: your registered phone number, the last 4 digits of your linked card, approximate time of the failed transaction, and any error message text or screenshots.
12. Prevention: Setting Up Alipay for Reliability
The best troubleshooting is prevention. These setup steps reduce failure probability significantly:
- Complete real-name verification with your passport before you need to use Alipay urgently — verification takes 24 hours and cannot be rushed
- Link two cards to your account so one acts as backup
- Enable and memorise your 6-digit payment password — biometrics can fail; the password is your guaranteed fallback
- Keep the app updated to the latest version
- Maintain a small float balance in your Alipay wallet (¥100–200) so small payments clear instantly without card authorisation
Frequently Asked Questions
Q: Why does Alipay say “service unavailable” at certain times?
A: Alipay performs scheduled maintenance, typically between 2 AM and 6 AM Beijing time. If you encounter this message during these hours, wait and retry. Unscheduled outages are rare but do occur — check Alipay’s status page or social media for acknowledgements.
Q: My Alipay balance shows zero but I topped up — where is my money?
A: Top-ups from international cards can take up to 24 hours to process and reflect. Check your card statement to confirm the charge went through. If charged but not reflected after 24 hours, contact support with your card transaction reference number.
Q: Can I use Alipay without a phone number?
A: No. A verified phone number is mandatory for Alipay registration and cannot be bypassed. You can use a foreign phone number for the International version.
Q: Is there a way to pay offline with Alipay?
A: Not in the standard consumer app. For offline payment capability, consider the Digital Yuan (e-CNY) hardware wallet, which operates without internet connection.
Conclusion: Systematic Troubleshooting Always Finds the Fix
Alipay failures, when they occur, feel catastrophic in the moment — particularly when you are standing at a counter in a cashless city with no alternative. But every failure mode has a diagnosis and a resolution. The pattern is consistent: check connectivity, check balance, check account status, check card status, check app version. Nine times out of ten, the problem is one of these five things. For the remaining one-in-ten, Alipay’s support infrastructure — however bureaucratic — will ultimately resolve it. What the panic in the moment rarely permits you to see is this: the system is fixable, every time. Step back, work through the checklist, and the queue behind you will wait.
