Integra la connettività eSIM nella tua app
Usa questa guida per collegare un acquisto eSIM a un account nella tua app. Ti servono uno spazio di lavoro Bird, un'integrazione API lato server e un modo per autenticare i tuoi clienti. Segui la guida API per permessi e dettagli delle richieste.
1. Mostra le offerte utilizzabili dal cliente
Elenca le offerte per la destinazione del cliente e mostra copertura, volume incluso, validità e prezzo pubblicato dell'offerta selezionata. Verifica compatibilità del dispositivo e requisiti di identificazione prima dell'acquisto.
Per il rinnovo automatico, usa le opzioni di checkout dell'offerta per mostrare le modalità di acquisto disponibili e i termini accettati. Conserva la revisione dell'offerta e il prezzo indicato insieme alla selezione del cliente. Se il prezzo cambia, mostra i nuovi termini e chiedi al cliente di accettarli prima di procedere all'acquisto.
2. Associa l'acquisto al tuo cliente
Conserva le chiavi Bird API sul tuo server. Autorizza l'accesso a ogni ordine ed eSIM tramite l'account cliente della tua app; una chiave API dello spazio di lavoro può accedere a risorse appartenenti a più clienti.
Salva l'ID del cliente insieme all'ID dell'ordine e, una volta consegnato, gli ID dell'eSIM e del pacchetto. Se ti serve un utente di servizio nominativo o il rinnovo automatico, crea un sottoscrittore da un contatto dello spazio di lavoro. L'assegnazione registra chi usa l'eSIM; non esegue l'accesso di quella persona alla tua app né concede l'accesso alle credenziali.
Il wallet della tua organizzazione finanzia l'acquisto Bird. Se addebiti il cliente separatamente, traccia quel pagamento separatamente dall'ordine eSIM in modo da poter risolvere un problema di pagamento o di consegna.
3. Crea un acquisto recuperabile
Genera e salva una Idempotency-Key prima di creare l'ordine. Riutilizza quella chiave con la stessa richiesta se la risposta viene interrotta.
Mostra uno stato di elaborazione finché l'ordine non raggiunge un esito finale. Salva l'ordine prima di indirizzare il cliente all'installazione e consentigli di tornare all'ordine dal proprio account. Per un ordine non finanziato o fallito, segui i passaggi di recupero dell'acquisto.
4. Consegna istruzioni di installazione riservate
Dopo il completamento dell'ordine, crea un link di installazione ospitato per il cliente destinatario oppure invia il link via email o SMS. Segui la guida all'installazione per consegna, scadenza, revoca e configurazione del dispositivo.
Tratta il link e i dettagli di attivazione come credenziali. Non includerli in strumenti di analisi, log pubblici e note di supporto ordinarie. Registra il completamento dell'acquisto, la consegna del link e l'installazione sul dispositivo come esiti separati.
Se stai sostituendo un servizio di connettività esistente, pianifica un nuovo acquisto e installazione di una eSIM Bird. Verifica il dispositivo e il pacchetto previsti prima che il cliente modifichi il proprio servizio esistente. L'eSIM Bird API non importa un profilo esistente né trasferisce un numero di telefono.
5. Aggiungi una pagina account per l'uso continuativo
Consenti al cliente autenticato di riaprire la propria eSIM esistente, visualizzare i saldi e la scadenza del pacchetto riportati e contattare il supporto. Mostra il timestamp del saldo e i valori sconosciuti in modo accurato.
Usa le offerte compatibili per le ricariche e il available_actions dell'eSIM per decidere quali controlli visualizzare. Spiega un'azione disabilitata usando il motivo restituito e gestisci un rifiuto se la disponibilità cambia prima dell'invio. Segui la guida ai pacchetti ricorrenti per rinnovo e cancellazione.
Verifica interruzione e recupero
Chiudi il browser dopo l'acquisto e riapri l'account del cliente. Conferma che porta allo stesso ordine e alla stessa eSIM. Ripeti dopo l'avvio dell'installazione.
Verifica che una risposta di acquisto persa, un link di installazione scaduto e un valore di utilizzo sconosciuto portino ciascuno a un'azione di recupero appropriata. Verifica che un cliente non possa aprire il link di installazione o l'eSIM di un altro cliente tramite la tua pagina account.
Passaggi successivi
Risorse correlate
Continua con la documentazione, le guide e gli esempi per questo argomento.