Skip to main content
This guide explains how to build an eSIM purchase and setup flow that users can complete without support.
1

1) Let the user choose a destination

Show available destinations by country or region.
2

2) Show packages and help the user pick

Packages differ by:
  • data allowance (capped vs unlimited)
  • validity period (days)
  • price
3

3) Purchase the package

Store the returned eSIM identifier in your system.
4

4) Show installation instructions

Retrieve eSIM details, generate a QR code from the LPA string, and show clear steps the user can follow.
5

5) Show remaining data (optional)

You can refresh eSIM details to show remaining data usage over time.
The most important “success moment” is installation. Make the QR code easy to scan and keep the instructions short and device-friendly.

​
What to show in your UI

​
Coverage browsing

Let the user browse coverage by:
  • country
  • region (multi-country plans)

​
Package selection

When listing packages, show:
  • price and currency
  • validity (how long it lasts)
  • data allowance (capped vs unlimited)
  • whether it includes voice/SMS (many plans are data-only)

​
Package selection tips (for your UI)

If a plan is unlimited, the data quantity may be shown as 0 and the unlimited flag will be true. Make that obvious in your UI to avoid confusion.
Users expect validity to start at installation or first use. Communicate the exact rule your product uses based on what the API returns.

​
What to collect and store

After purchase, store:
  • the eSIM ID (your primary handle for support and “show details” screens)
  • package name/summary (so the user recognizes what they bought)
  • price and currency

​
What to show after purchase

Your “eSIM details” screen should show:
  • installation QR code (generated from the installation string)
  • a short “How to install” checklist (device settings path)
  • current status
  • remaining data (if available)

​
FAQ

How does the customer install the eSIM? Show a QR code and short installation steps. The customer scans the QR code in their device’s eSIM settings. Are these data-only plans? Most plans are data-only (voice and SMS quantities are 0). Customers can use VoIP apps (WhatsApp, Telegram, etc.) for calls. Can the customer check remaining data? Yes. Show the remaining data in your eSIM details screen when it’s available. Which devices support eSIM? Most smartphones from 2019+: iPhone XS and later, Samsung S20+, Google Pixel 3+, and other flagship devices. Some carrier-locked phones may not support eSIM. Can the customer install the eSIM before traveling? Yes, and this is recommended.