TL;DR: If the eSIM QR will not scan, improve lighting, open the QR on another screen, use manual SM-DP+ entry, and confirm the code was never installed before.
Scan tips that work
- Increase screen brightness; avoid reflections.
- Display the QR on a laptop or second phone - do not scan the same device’s screen.
- Hold steady 15-25 cm away.
- Use the Camera / Cellular “Use QR Code” flow, not a random QR app.
Manual installation
Your RoameSIM delivery email and track page include SM-DP+ and activation code. Enter them under Add eSIM → Enter Details Manually. Guides: iPhone · Android.
Errors to recognize
- Unable to activate / add cellular plan: unable to activate
- QR already used: QR already used
- Stuck activating: stuck on activating
Device and network checks
Stable Wi‑Fi required. VPN off. Phone unlocked and eSIM-capable. See compatible phones.
Support
Email info@roamesim.io with the QR screenshot (blur personal data if needed) and error message.
Shop
Buy a RoameSIM plan and receive a fresh QR instantly by email.
Frequently Asked Questions
Why will my phone not scan the eSIM QR?
Glare, low brightness, a damaged screenshot, or scanning from the same phone screen can fail. Print or open the QR on another device.
Can I enter details manually instead?
Yes. Use SM-DP+ address and activation code from your RoameSIM email / track page.
Does “Unable to add eSIM” mean a bad QR?
Not always - it can mean Wi‑Fi issues, a used QR, or an unsupported device. Check the specific error text.
Should I request a new QR immediately?
First try manual entry and another network. If the QR was already consumed, contact support - see our already-used guide.