Test and live environments

You build on test. Your customers run on live. Each has its own login, credentials, balance and eSIMs.

You don't need a sales call to move between them: signing the agreement opens your live account automatically. If a Firsty representative set up your account, they handle all this with you, so the steps here don't apply.

From signup to live

1. Create a test account at firsty.app/builders. It takes a few minutes, with no card and no approval.
2. Build on sandbox eSIMs. They're free, and the Quickstart walks you through your first.
3. Top up. €5 or more, on your card, unlocks real eSIMs and the agreement.
4. Sign the agreement. Your live account opens straight away, ready for your integration.

Side by side

Over HTTP, every order names its esimVariant. There's no default, and an order without one answers 400. The CLI picks sandbox if you leave it out.

A TEST ribbon marks the test partner area. No ribbon means you're on live. The API spec and the CLI's JSON output call the two environments staging and production.

Limits on test

• 25 eSIMs in all. Sandbox or real, terminated or not, and that includes the one from signup. There's no freeing one up. Past that, an order answers 403 with Profile limit reached (25/25), so order what you need, never in a loop.
• Sandbox eSIMs are mock data. They never install on a phone or connect to a network. Order, package and lifecycle webhooks fire. Installs, usage and renewals don't.
• Sandbox eSIMs take one plan, SG050GB030DGLN. The others in your test catalogue answer 400.
• Real eSIMs take a top-up. Your first, of €5 or more, unlocks them. They install on a phone and draw on your balance.

Going live

You decide when: once your integration works on test and you're ready for real customers. You'll need:

• A top-up that has settled, usually within a few minutes.
• Your company's registered details: name, legal form, jurisdiction, address, register and number. They lock once you've signed.
• The authority to sign for your company.

In the test partner area, open Overview and choose Read and sign under Go live. Type your full name, confirm you're authorised, and sign. Want your lawyers to read it first? The Go live button opens the agreement at any time, with an unsigned PDF to download.

That's the last step. We email you the signed PDF and open your live account automatically, usually within seconds. If it takes longer, the step reads Signed · setting up your live account, and we email you when it's ready.

Moving your integration

Your company details and signed agreement come with you. Balance, eSIMs, credentials and webhooks stay on test, so live starts clean:

1. Sign in. Set your live password from the "Set your Firsty password" email, whose link works once, for 24 hours. Google or Microsoft work too, on the same address. Your test password doesn't.
2. Create credentials. On the Integration page.
3. Top up. On the Billing page. Orders answer 402 when the balance runs short.
4. Point your backend at live. Swap the base URL and credentials, and order with travel_ota.
5. Read the live catalogue. Plan references differ, so take yours from GET /catalog/packages. Start with the global plans.
6. Add your webhook endpoints again. Each one gets a new signing secret.

Test stays open for your next feature, with its own login. Choose Test on the sign-in page to get back.

Beyond self-serve

Going live puts you on data plans at standard rates. Talk to sales for lower rates on a volume commitment, SMS and voice plans, CDR exports, or your network name on your customers' phones.