How to activate a travel eSIM (iPhone + Android): the 2026 troubleshooting guide
Install the QR before flying, on your home Wi-Fi. Display the QR on a laptop or second phone (not the phone you're installing to). On the iPhone: Settings → Cellular → Add eSIM → Use QR Code. Keep Cellular Data on your home line until you land. On landing: toggle Airplane Mode off/on, switch Cellular Data to the travel eSIM, open Google Maps to confirm. 96% of activations work first time. For the other 4%, this post covers the six common failure modes.
Buying a travel eSIM via an AI agent takes 60 seconds. Installing it takes another 90. The friction is entirely in the last mile — a QR-code flow that inherits none of the "buy" ergonomics that made agent commerce feel magical.
Here's the definitive install + troubleshoot, for both platforms.
iPhone (iOS 17+): step-by-step
- Order the eSIM. Whatever aggregator or agent you used, the confirmation email has a QR code as an image.
- Display the QR on a second device. A laptop, a tablet, a spouse's phone, or a printed page. You cannot scan an on-screen QR with the same iPhone that will install it.
- Open Settings → Cellular (or Settings → Mobile Data on non-US iOS).
- Add eSIM → Use QR Code. The camera opens.
- Scan the QR displayed on the second device. The plan downloads to the iPhone in a few seconds.
- Label the plan — call it "Japan travel" or the destination country. Helps when you have multiple eSIMs.
- Choose Default Line: keep your home carrier as default so iMessage/SMS still routes there.
- Cellular Data: pick your home carrier for now. Do NOT set it to the travel eSIM yet — it hasn't been activated and you don't want it starting the validity clock at home.
- Disable Data Roaming on the home line, if you don't already, to prevent accidental home-carrier roaming.
You're done installing. The eSIM sits idle in the device until you land.
Activating on landing (iPhone)
- Land. Wait until you're at the gate.
- Turn Airplane Mode on, then off. This forces a fresh network scan.
- Settings → Cellular → Cellular Data → [travel eSIM label].
- Wait ~30 seconds. The travel eSIM should show a network name (NTT Docomo, KT, Telcel, whatever the plan roams onto).
- Open Google Maps. If it loads, you're online.
Android: step-by-step
Menu paths differ by manufacturer, the underlying flow is the same.
| Device | Path |
|---|---|
| Google Pixel | Settings → Network & internet → SIMs → + → Download a SIM instead? → scan QR |
| Samsung Galaxy | Settings → Connections → SIM manager → Add mobile plan → Scan carrier QR code |
| OnePlus / OPPO | Settings → Wi-Fi & network → SIM & network → Add eSIM |
| Xiaomi | Settings → SIM cards & mobile networks → Add eSIM |
| Motorola | Settings → Network & internet → Mobile network → Add carrier → scan |
On landing: enable the travel eSIM as your data SIM, keep the home SIM for calls/SMS if you have it (dual-SIM Android devices support this natively).
The six failure modes and their fixes
1. "Unable to activate eSIM" on scan
Cause: the QR was already scanned on another device, or the aggregator's provisioning system hasn't finished readying the SIM (rare, first ~5 minutes after purchase).
Fix: contact the seller for a fresh QR. Most aggregators re-issue for free if the eSIM hasn't been redeemed by another device.
2. eSIM installed but "No Service" on landing
Cause: the phone hasn't found the roaming partner yet, or Data Roaming is disabled on the travel eSIM line.
Fix: Settings → Cellular → [travel eSIM] → Cellular Data → toggle Data Roaming ON. Toggle Airplane Mode off/on. Wait 60 seconds.
3. Signal but no data
Cause: APN not auto-configured (most common on Android or older iPhones).
Fix: the aggregator's activation email includes the correct APN string. Settings → Cellular → [travel eSIM] → Cellular Data Network → APN — paste it.
4. Phone locked to home carrier
Cause: US carrier-locked phones (T-Mobile financing plan, AT&T Next, Verizon Device Payment) sometimes reject foreign eSIM profiles.
Fix: request an unlock from your carrier before you travel. Most US carriers unlock after 60 days of on-time payments. There is no workaround if the phone is locked.
5. iPhone older than iOS 17
Cause: some newer eSIM profile formats require iOS 17+.
Fix: update iOS to the latest version before travel. If update isn't possible, contact seller for a legacy-format QR.
6. Country code mismatch
Cause: you bought a "Japan" eSIM but the plan is actually region-locked to Japan and you're activating it in a nearby country to test.
Fix: activate at destination. Don't test-activate in a country the plan doesn't cover — the eSIM will register but data won't flow, and depending on the provider, the plan may have started its validity clock.
What to test before your trip
- Install the eSIM.
- Confirm it appears in Settings → Cellular with a plan label.
- Do NOT enable Cellular Data on it (avoid starting the clock).
- If you can, borrow a travel eSIM from a friend who's tested it. Confirm your device is eSIM-capable and unlocked.
The two failure modes that will ruin your trip are (a) phone is carrier-locked and (b) eSIM QR is corrupted/re-used. Both are visible before you fly.
Buy an eSIM in one prompt
claude mcp add --transport http cartapi https://mcp.cartapi.io/mcp
using cartapi, cheapest 10GB Thailand eSIM for 10 days, email to [email protected].
QR arrives in your inbox. Use the install steps above.
Frequently asked questions
Do I need to activate the eSIM before I fly?
Install pre-flight. Don't activate cellular data on it until you land — most plans start their validity clock on first network attachment.
Why won't my eSIM activate on iPhone?
Six common causes: carrier-locked phone, QR already used, iOS too old, Airplane Mode misconfig, Cellular Data on wrong line, or carrier tower not yet reachable. This post covers the fix for each.
Can I scan an eSIM QR on the same phone I'm installing it to?
No. Display the QR on another device (laptop, second phone, printed page) and scan with the target iPhone's camera.
How do I install an eSIM on Android?
Menu paths vary by manufacturer. Pixel: Settings → Network → SIMs → + → scan QR. Samsung: Settings → Connections → SIM manager → Add mobile plan. Same rules as iPhone: install pre-flight, activate on landing.
My eSIM has signal but no data. What now?
APN misconfig. Enter the APN string from the aggregator's activation email under Cellular Data Network for that eSIM.