Firsty BuildersHelpHow do I test eSIM activation without a real device?
Integration

How do I test eSIM activation without a real device?

Sandbox returns a real LPA activation string and QR. Decode the QR with any LPA-format reader to confirm shape. Use the simulate-activation endpoint to flip state.

The short answer

Sandbox eSIMs come with a real LPA activation string and a scannable QR code. You cannot install them on a real device (they map to a test profile), but you can:

  1. Decode the QR to verify the LPA format
  2. Call the simulate-activation endpoint to flip the eSIM into
    active
    state
  3. Trigger usage events to test your dashboard

Verifying the QR

Try it yourself

Free sandbox. Real Tier-1 carriers. 60 seconds from signup to credentials.

Get started →

Any LPA-format QR decoder works. The string looks like:

LPA:1$rsp.test.firsty.app$ACTIVATION_TOKEN

If you get this shape back from the API, your QR generation is correct.

Simulating activation

bash
curl -X POST https://connect.test.firsty.app/api/v3/sandbox/simulate-activation \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"esimReference":"esim_abc123"}'

This fires the

esim.activated
webhook just like a real activation would. Use it in your test suite to validate the end-to-end flow.

What you cannot test in sandbox

  • Real carrier signal strength or roaming behavior
  • Real LPA installation on iOS/Android (use a production test eSIM for that, ask support)
  • Real billing reconciliation
Was this helpful?