eSIM Profiles

An eSIM profile allows access to the mobile data network. The user can install an eSIM using different methods on an eSIM-capable smartphone:

  • Scan the Activation Code

  • Direct Installation (without a QR code)

To use the Direct Installation, please integrate our SDKs, see SDK Integration.

eSIM API Object

Each eSIM profile comes with

  • uid - internal identitier

  • ICCID - main identifier for end-user support

  • activationCode - used to install the eSIM

  • IMSI, lastSeen, activatedAt - additional identifiers for support

  • state - current state (e.g. INSTALLED)

{
    "iccid": "89972123300991848961",
    "imsi": "260060145143896",
    "activationCode": "LPA:1$domain.tld$1234567890ABCDEF123456",
    "installationUrl": "https://dent.giga.store#/esim/profile?token=eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI4OTk3MjEyMzMwMDk5MTg0ODk2MSJ9.V34vHdqG6QD9iyCLjIfh2zxsv5MUUjEaOkSw3EY_RVJAxhQQfTeZBfEL_EYwAS9TMNi_Rn6L2Q2cuuI8Ve9zmQ",
    "lastSeen": null,
    "activatedAt": null,
    "state": "RELEASED",
    "uid": "7555cab8-72bc-4e85-b56a-6cdf60e2d6e4",
    "active": true
}

Providing QR code for installation

Once the First Package is activated, the returned eSIM can be used to provide a QR code for installing the eSIM.

You can use any QR code renderer to generate a QR code using the activationCode and provide it to your user via email or through other channels.

The QR code must be scanned with an eSIM-capable device, like an iPhone 14.

eSIM States

An eSIM can have different states. You can use the eSIM state to guide the user during your user journey.

To receive status updates, use the eSIM Status webhook. The webhook is triggered within a few seconds after the user interaction.

PreviousFirst PackageNextTop-up

Last updated