Ambiente test e live

Sterna ti permette di sviluppare e provare l'intera integrazione senza alcun costo, grazie all'ambiente di test. Solo quando l'integrazione è pronta passerai all'ambiente reale.

Due ambienti, due tipi di chiave

L'ambiente in cui operi è determinato dalla API key che usi. Non esistono indirizzi diversi: l'endpoint è sempre lo stesso, cambia solo la chiave.

• Ambiente test — Si usa con una chiave dal prefisso stk_test_.... Ogni ordine creato viene simulato: l'ordine viene registrato e passa allo stato processing, ma non viene generato alcun eSIM reale e non viene addebitato alcun costo. È l'ambiente corretto per sviluppare e collaudare l'integrazione.
• Ambiente live — Si usa con una chiave dal prefisso stk_live_.... Ogni ordine creato è reale: genera un eSIM reale e consuma il tuo plafond.

Cosa cambia in pratica

Il comportamento dell'API è identico nei due ambienti: stessi endpoint, stessi formati di richiesta e risposta, stessi stati dell'ordine. Questo ti permette di sviluppare con la chiave test sapendo che, una volta passato alla chiave live, tutto funzionerà allo stesso modo.

Le differenze sono due soltanto:

• Gli eSIM — In test gli eSIM sono simulati e non installabili. In live sono profili reali, consegnati con ICCID, codice di attivazione e QR code validi.
• Il costo — In test nessun ordine ha costo. In live ogni ordine consuma il plafond del tuo account.

Come riconoscere l'ambiente

Puoi sempre verificare in quale ambiente stai operando in due modi:

• Dal prefisso della tua API key: stk_test_... oppure stk_live_....
• Dalla risposta della chiamata di identità (GET /v1/me), nel campo api_key.environment, che vale test o live. Anche ogni ordine, nella sua risposta, riporta il campo environment.