HarborOrganizzazioneWorkspaceProduzioneSandbox
Agente di invio
Chiave API · Team Operazioni clientiALAlex Lee AmministratoreAutorizzazioni aggiornate
Integra i dati mobili nella tua app.
Usa l'API eSIM per scoprire offerte dati, acquistare pacchetti e inviare link di installazione privati dalla tua applicazione. Mantieni i clienti nella tua esperienza account per saldi, ricariche compatibili e acquisti ricorrenti dove disponibili.
Inizia dalle offerte disponibili.
Usa una chiave API lato server con permesso di lettura eSIM per esplorare il catalogo. Questo esempio elenca le offerte senza acquistare un pacchetto.
1
bird esim offers listDall'offerta all'ordine
Trasforma un'offerta in un acquisto recuperabile.
Leggi copertura, quantità e validità dell'offerta, poi ottieni il prezzo di checkout corrente. Il wallet della tua organizzazione finanzia l'acquisto. Salva l'ordine risultante così il cliente può tornarci mentre Bird esegue il provisioning dell'eSIM e del pacchetto dati.
Presenta i termini accettati
Invia con l'ordine la revisione dell'offerta accettata e il prezzo. Se i termini cambiano prima dell'acquisto, mostra il preventivo aggiornato per l'accettazione. Gli acquisti ricorrenti hanno termini e cadenze propri.
Recupera senza un altro acquisto
Salva una chiave di idempotenza prima di creare un ordine e riutilizzala con la stessa richiesta se la risposta viene interrotta. Se hai l'ID dell'ordine, leggi prima quell'ordine per verificare se è stato completato.
Installazione ospitata
Invia istruzioni di configurazione che il cliente può aprire.
Dopo il completamento dell'ordine, crea un link di installazione ospitato oppure invialo via email o SMS. Il cliente apre istruzioni specifiche per il dispositivo senza accedere a uno spazio di lavoro Bird. Monitora la consegna del messaggio separatamente dall'installazione e dalla prima connessione dati mobile.
Controlla l'accesso all'installazione
Le credenziali di installazione usano permessi API separati. Verifica la scadenza del link ospitato e revocalo se raggiunge la persona sbagliata. Revocare un link blocca l'accesso futuro attraverso di esso; non disabilita un profilo già installato.
Leggi i saldi dei pacchetti
Mostra quantità acquistata, scadenza e consumo rilevato con il relativo orario di osservazione. Quando l'utilizzo non è disponibile, mantienilo sconosciuto così i clienti possono distinguere la quantità del pacchetto da un saldo residuo misurato.
Acquisti continuativi
Permetti ai clienti di aggiungere dati alla stessa eSIM.
Elenca le offerte compatibili per un'eSIM esistente prima di presentare una ricarica. Una ricarica completata aggiunge un pacchetto al profilo installato, così il cliente può continuare a usare quell'eSIM senza un'altra installazione.
Pianifica pacchetti ricorrenti
Dove un'offerta supporta il rinnovo, assegna la persona che usa l'eSIM e accetta il prezzo ricorrente e la cadenza. Segui il pagamento e la consegna del pacchetto per ogni periodo, e permetti al cliente di interrompere il rinnovo futuro.
Mantieni l'accesso dei clienti nella tua app
Autentica i tuoi clienti e autorizza l'accesso ai loro ordini e alle loro eSIM. Una chiave API dello spazio di lavoro può accedere a risorse di più clienti, quindi mantienila sul tuo server e collega ogni risorsa all'account corretto.
Domande sulla API eSIM
Cosa posso costruire con l'API eSIM?
Integra nella tua app la scoperta delle offerte, l'acquisto di pacchetti dati, la consegna dell'installazione e la gestione continuativa dei pacchetti. I clienti possono acquistare ricariche compatibili e iscriversi ad acquisti ricorrenti dove disponibili. La tua applicazione gestisce l'autenticazione dei clienti e qualsiasi pagamento raccolto da loro.
Di cosa ho bisogno per effettuare un acquisto?
Usa uno spazio di lavoro Bird, una chiave API lato server con i permessi eSIM necessari e fondi nel wallet dell'organizzazione. Verifica l'offerta, i termini di checkout e i requisiti di identificazione prima di acquistare. Leggere le credenziali e creare o inviare link di installazione richiede permessi separati sulle credenziali.
Come devo gestire una risposta di acquisto interrotta?
Leggi l'ordine esistente se hai il suo ID. Altrimenti, ripeti la richiesta di creazione salvata con la chiave di idempotenza originale. Segui quell'ordine fino al completamento o al fallimento prima di crearne uno sostitutivo che potrebbe generare un altro addebito.
Un ordine completato significa che il cliente è online?
Un ordine completato identifica l'eSIM e il pacchetto acquistati. Il cliente deve ancora installare il profilo su un dispositivo compatibile e verificare la connessione dati mobile in una destinazione coperta. I report di installazione e saldo possono arrivare dopo il risultato del dispositivo.
Collega il servizio completo
Installazione eSIMAiuta i clienti a installare sul proprio dispositivo e a connettersi con indicazioni chiare.Utilizzo e ricaricheMostra il credito disponibile e la scadenza, poi offri pacchetti dati aggiuntivi compatibili.Operazioni di connettivitàRisolvi problemi di acquisto, installazione e pacchetti con i record di servizio esistenti.Libreria di risorse eSIMConsulta guide pratiche, risposte esplicative e riferimenti tecnici.
Scala senza
perdere il controllo.
Organizza i team in spazi di lavoro, controlla l'accesso alle API e traccia le modifiche tramite log di audit.
HarborOrganizzazioneAttivo
Registro di audit
Produzione- Workspace
- Produzione
- Risorsa
- Agente di invio
- Accesso in letturaLettura e scrittura
Team Operazioni clientiRuolo dell’autore AmministratoreEsito RiuscitoOra 22 set., 09:42:18 UTC
Riuscito