The reality: “works in one city” doesn’t guarantee “works everywhere”

China’s local transit systems are city-run, and the payment layer changes fast. A setup that works in Shanghai might fail in another city due to:

  • Different supported payment methods (QR vs NFC vs in-app mini programs)
  • Different verification requirements
  • Different subway gate scanners (some read only certain QR formats)
  • Temporary outages (network, app service, bank verification)

The goal is not a perfect setup. The goal is a two-layer plan: primary method + boring fallback.

If you haven’t set up mobile payments yet, start here:

Primary options (ranked): QR, transport card, then “buy a ticket”

Option A: in-app transit QR code (fastest when it works)

Most visitors try a “Transit code” / “Metro code” QR inside Alipay or WeChat, then scan at the gate.

This is best when:

  • You’ll take multiple rides per day
  • You want the smoothest gate experience
  • You have stable mobile data

Common failure modes:

  • Code won’t generate (verification blocked, service down)
  • Code generates but gates don’t recognize it (wrong city/service)
  • Payment is declined at the moment of exit (insufficient funds / card issue)

Option B: transport card (often the most stable)

Many cities support a “transport card” mode (sometimes NFC-based) inside Alipay/WeChat, or a local transit card in-wallet.

This is best when:

  • You want fewer QR-scanner edge cases
  • You ride daily over multiple days
  • You want a backup that is less sensitive to camera/scanner issues

Option C: buy a single-journey ticket (your universal fallback)

If QR and cards fail, don’t spiral. Most metro systems still support single-journey tickets via:

  • Ticket machines (select destination station)
  • Staff window (show a station name screenshot)

This is slower, but it saves the day.

The setup checklist (do this before your first metro ride)

1) Ensure you have a “name match” profile on your payment apps

Most payment blocks for foreigners come from mismatched or incomplete identity details.

  • Make sure the name you used in the app matches your passport (spelling + order)
  • If a verification step appears, complete it when you have time—not at the subway gate

2) Add at least one working payment method

For transit QR codes, the app may require a funded balance or a linked card depending on city rules.

  • Add a card that consistently works for small transactions
  • Keep a second method ready (even if you rarely use it)

3) Confirm you have data where transit happens

You don’t need blazing speed, but you do need stability at gates and during transfers.

4) Save your hotel address in Chinese

When transit fails and you pivot to ride-hail, this matters immediately:

How to use transit QR codes (the workflow)

Step 1: select the correct city/service

Inside Alipay or WeChat, transit features can be city-specific. If you see multiple options:

  • Choose the city you’re currently in (not your next destination)
  • If the app offers “Metro” vs “Bus,” start with metro

If you can’t find the feature reliably, search inside the app for:

  • “Transport”
  • “Transit”
  • “Metro”
  • “Bus”

Step 2: generate the code before you’re at the gate

Generate the QR code while you’re still in the open concourse. If it fails, you have room to troubleshoot or switch methods.

Step 3: scan like you mean it

QR gates can be picky:

  • Clean your camera lens
  • Increase screen brightness (for showing QR on your phone)
  • Hold steady for 1–2 seconds; don’t “wave” the phone

Step 4: watch for the “exit gate payment” pattern

Some metro systems calculate fare at exit. A common failure:

  • Entry works
  • Exit fails because the payment method can’t finalize the fare

If you see this:

  • Move to the staffed exit lane
  • Show the last ride record in your payment app
  • Pay the fare using the staff’s instructed method (don’t spam retry)

When QR fails: quick diagnosis and the safe pivot

Failure type 1: code won’t generate

Likely causes: verification lock, payment method issue, app service outage, or network issues.

Safe actions:

  • Switch network: try cellular data (or toggle airplane mode briefly)
  • Open the payment app, not a browser view
  • If it still fails in 60–90 seconds: use a ticket machine or ride-hail

Failure type 2: code generates but gates reject it

Likely causes: wrong city/service, wrong QR format, scanner limitations.

Safe actions:

  • Confirm you selected the correct city transit service
  • Try a different gate scanner (some lanes behave differently)
  • If two tries fail: stop retrying and switch to ticket purchase

Failure type 3: payment is declined at exit

Likely causes: card/balance issue, bank verification triggers, daily limits.

Safe actions:

  • Go to staff lane and pay the fare
  • After the ride: fix your payment method while calm (not during a rush transfer)

Bus payments: what’s different

Bus networks can be more fragmented than metro.

  • Some buses support the same transit QR code
  • Others require a local transit mini program or local card
  • In smaller cities, drivers may accept only certain methods

Treat buses as “nice when it works.” For high-stakes trips (airport, train station), default to:

  • Metro (if possible), or
  • Ride-hail as a controlled option

Related planning: Getting around cities: metro vs DiDi vs tickets

The “do not get stuck” backup plan

Before you leave your hotel each day:

  • Screenshot your destination in Chinese (and the nearest metro station)
  • Screenshot your return plan (station name + line number)
  • Keep enough funds for a ride-hail pivot if you’re late or tired

If your transit setup breaks mid-trip, your decision rule is:

  • If you’re not late: buy a metro ticket and continue.
  • If you’re late or carrying luggage: pivot to ride-hail.

A final note on staying calm at gates

Transit failures feel high-pressure because other people are moving fast. Don’t let the environment force repeated retries.

When something fails:

  1. Pause.
  2. Switch to the staffed lane.
  3. Use the fallback method.

Transit systems and payment rules can change. Treat this as a planning guide and confirm the current flow from station signage and staff instructions when needed.

Last verified: 2026-06-12