DEV Community: jun liu

How I Automated China High-Speed Rail Ticket Booking (And What I Learned)

jun liu — Tue, 20 Oct 2026 23:09:09 +0000

How I Automated China High-Speed Rail Ticket Booking (And What I Learned)

I needed to book a high-speed rail ticket from Beijing to Shanghai for a friend visiting from abroad. The official app (12306) is the only legal way to buy tickets, but the foreigner verification process is opaque and slow.

So I did what any ops engineer would do: automate the research, document the edge cases, and build a checklist.

Here's what I learned after booking 12+ tickets across 6 routes.

The Stack

12306 app (official railway booking app, "railway12306")
Passport (foreigner ID, not Chinese national ID)
Alipay or WeChat Pay (linked international card)
Time buffer: 1-7 days for verification clearance

Step 1: Registration (The Bottleneck)

Register → Enter passport → SMS verification → Identity check → Wait

Key insight: Foreign passport verification takes 1-7 days. Do NOT register on the day you want to travel.

Pro tip: Register the moment you know your travel dates. Even if you haven't picked a route yet.

Step 2: Booking (The Quick Part)

Search route → Select train → Pick seat class → Pay → Done

Seat classes (cheap to expensive):
| Class | Price multiplier | Best for |
|-------|-----------------|----------|
| Second class (二等座) | 1.0× | Most trips < 8 hours |
| First class (一等座) | ~1.6× | Long trips, extra legroom |
| Business class (商务座) | ~3.0× | Premium, priority boarding |

Booking window: Up to 15 days in advance.

Payment: Alipay, WeChat Pay, or linked international card (Visa/Mastercard).

Step 3: Day of Travel

Arrive 30-45 min early → Tap passport at gate → Find platform → Board

Three things that actually slow people down:

1. Verification delay

Foreign passports take up to a week to clear. Register early.

2. Getting the city wrong

Many cities have multiple stations:

Beijing: West (西), South (南), North (北) — 20+ km apart
Shanghai: Hongqiao (虹桥), South (南), Station (站)
Guangzhou: South (南), East (东), Station (站)

Check your ticket carefully. Going to the wrong station means missing your train.

3. Not knowing refund rules

Full refund: Up to 15 minutes before departure
Partial refund: 15 min - 24h before (varies by route)
No refund: < 15 min before departure

This is useful if your plans change last minute.

What It Feels Like Once You're On

The first thing that's different is the quiet. Second class is busy but not chaotic. Trains are genuinely on time to the minute.

A Beijing-to-Shanghai ride that older guides still quote as "a day trip" now takes about 4.5 hours on the fastest G-series.

The single best value transport upgrade in China.

The Automation Mindset

I approach travel planning like infrastructure:

Identify the bottleneck (verification delay)
Buffer for worst case (register 7 days early)
Document edge cases (multiple stations per city)
Build a checklist (this article)

Once the 12306 account is set up, the actual booking takes 7 minutes. The hard part is the prep.

TL;DR

Register 12306 7 days before you travel (verification delay)
Book up to 15 days in advance
Check which station your city has (many have multiple)
Arrive 30-45 min early
Refund is full up to 15 min before departure

Once set up, you'll move across China faster than you can book a hotel room.

Original article: https://jiunotes.top/en/articles/high-speed-rail-ticket-steps

Bullet Train vs Sleeper Train: Which Is Smarter for China?

jun liu — Tue, 20 Oct 2026 01:39:53 +0000

Bullet Train vs Sleeper Train: Which Is Smarter for China?

Original article: Bullet Train or Sleeper Train? Choosing a China Route

The Fork in the Road

Every long-distance trip in China ends at the same question: bullet train (高铁) or sleeper train (卧铺)?

The answer depends on one number: hours.

I've ridden both on Beijing-Shanghai more times than I can count. Here's my decision framework.

The Short Answer

Stay seated up to 6 hours. Sleep from 8 hours upward.

Between 6-8, you decide what to optimize for: daylight, money, or sleep.

What You're Actually Buying

Bullet Train Classes

Class	Layout	Price (Beijing-Shanghai)	Best For
二等座 (Second class)	3+2 seats, fold-down tray	¥553	Most trips < 8h
一等座 (First class)	2+2, wider, quieter	¥933	Long trips, extra space
商务座 (Business)	1+2, near-flat seat	¥1748	Premium experience

Sleeper Train Classes

Class	Setup	Price (Beijing-Shanghai)	Best For
硬卧 (Hard sleeper)	6 bunks, open bay, no door	¥318-¥407	Budget travelers
软卧 (Soft sleeper)	4 bunks, private room with door	¥477-¥660	Privacy, families
动卧 (EMU sleeper)	Faster than Z-train, pricier	¥500-¥800	Daytime overnight routes

Time Comparison: Beijing → Shanghai

Option	Journey Time	Can You Sleep?	Cost Range
G-train (fastest)	~4h 18m	No	¥553
G-train (with stops)	5.5-6h	No	¥553
Z-train (overnight)	~12h	Yes	¥318-¥660
D-train (daytime sleeper)	11-13h	Yes (if you want)	¥500-¥800

The hidden cost: G-trains arrive at distant stations. Beijing South to downtown = 40 min metro. Add that to your "4 hour" trip and it becomes 5.5 hours door-to-door.

A Night on Hard Sleeper: Hour by Hour

This is what convinced me:

20:10 — Depart Beijing, Carriage 12, middle bunk, ¥318
22:20 — Lights dim automatically. No announcement needed.
05:50 — Wake somewhere south of Nanjing. Sound of connecting doors between carriages.
06:40 — Attendant knocks, returns bunk card. Time to get off.
Breakfast: ¥10 instant noodles from the dining car (opens early, only hot food until arrival)

Pro tips I learned:

Earplugs are not luxury — they're necessity
Keep passport and phone in a zipped pocket inside the pillowcase
Middle bunks have ~70cm headroom (can't sit up straight). Lower bunks have more space but cost ~¥30 more

Decision Framework

Choose Bullet Train If...

Your route is ≤ 6 hours by rail
You value time over money
You want to arrive fresh and ready
You're traveling during daytime
You need reliable WiFi (available on most G-trains)

Choose Sleeper If...

Your route is 8+ hours
You want to save on one hotel night
You're on a tighter budget
You don't mind shared spaces
You prefer to "kill time" while traveling

The Hybrid Option: Daytime Sleeper EMU

Some routes run sleeper EMUs (动卧) during the day. This is 卧改坐 territory — the sleeper carriages convert to seated passengers because nobody wants to sleep during daylight.

If you see 卧改坐 on your ticket, you're getting a sleeper berth converted to a bench seat. Three people per lower berth instead of five in second class. Same price, more legroom. It's either the best value or the strangest experience in Chinese rail — often both at once.

Booking Rules That Matter

Advance booking: Up to 15 days before departure
Refund: Full refund up to 15 minutes before departure (varies by route)
Foreigner ID: Passport works for all trains, but verify 1-7 days before travel
Seat assignment: Random unless you pay extra for priority seat selection

TL;DR

≤6 hours → Bullet train. Time is money.
8+ hours → Sleeper. Save a hotel night.
6-8 hours → Depends on your priorities
Check the station — Beijing South ≠ Beijing Station, Shanghai Hongqiao ≠ Shanghai Station
Book early — 15 days max advance, seats sell out on popular routes

The best part about Chinese rail? Once you understand the system, it's cheaper, faster, and more reliable than flying domestically for most routes.

Original article: https://jiunotes.top/en/articles/bullet-vs-sleeper-train

Bullet Train vs Sleeper Train: Which Is Smarter for China?

jun liu — Mon, 19 Oct 2026 01:07:59 +0000

How I Automated China High-Speed Rail Ticket Booking (And What I Learned)

jun liu — Sun, 18 Oct 2026 06:28:32 +0000

DEV Community: jun liu

How I Automated China High-Speed Rail Ticket Booking (And What I Learned)

How I Automated China High-Speed Rail Ticket Booking (And What I Learned)

The Stack

Step 1: Registration (The Bottleneck)

Step 2: Booking (The Quick Part)

Step 3: Day of Travel

1. Verification delay

2. Getting the city wrong

3. Not knowing refund rules

What It Feels Like Once You're On

The Automation Mindset

Related Reading

TL;DR

Bullet Train vs Sleeper Train: Which Is Smarter for China?

Bullet Train vs Sleeper Train: Which Is Smarter for China?

The Fork in the Road

The Short Answer

What You're Actually Buying

Bullet Train Classes

Sleeper Train Classes

Time Comparison: Beijing → Shanghai

A Night on Hard Sleeper: Hour by Hour

Decision Framework

Choose Bullet Train If...

Choose Sleeper If...

The Hybrid Option: Daytime Sleeper EMU

Booking Rules That Matter

TL;DR

Bullet Train vs Sleeper Train: Which Is Smarter for China?

How I Automated China High-Speed Rail Ticket Booking (And What I Learned)