eSIM-connectiviteit inbouwen in je app
Gebruik deze handleiding om een eSIM-aankoop te koppelen aan een account in je app. Je hebt een Bird-werkruimte, een serverside API-integratie en een manier om je klanten te authenticeren nodig. Volg de API-handleiding voor machtigingen en requestdetails.
1. Toon aanbiedingen die je klant kan gebruiken
Lijst aanbiedingen op voor de bestemming van de klant en toon de dekking, bundel, geldigheid en gepubliceerde prijs van de geselecteerde aanbieding. Controleer apparaatcompatibiliteit en identificatievereisten vóór de aankoop.
Gebruik voor automatische verlenging de checkout-opties van de aanbieding om de beschikbare aankoopmodi en geaccepteerde voorwaarden te tonen. Bewaar de aanbiedingsrevisie en de opgegeven prijs bij de selectie van de klant. Als de offerte wijzigt, toon je de nieuwe voorwaarden en vraag je de klant deze te accepteren voordat je koopt.
2. Koppel de aankoop aan je klant
Bewaar Bird API-sleutels op je server. Autoriseer toegang tot elke bestelling en eSIM via het klantaccount van je app; een werkruimte-API-sleutel kan resources van meerdere klanten benaderen.
Sla je klant-ID op bij de bestelling-ID en, na levering, de eSIM- en pakket-ID's. Als je een benoemde servicegebruiker of automatische verlenging nodig hebt, maak dan een abonnee aan vanuit een werkruimtecontact. Toewijzing registreert wie de eSIM gebruikt; het logt die persoon niet in bij je app en verleent geen toegang tot inloggegevens.
De wallet van je organisatie financiert de Bird-aankoop. Als je de klant apart in rekening brengt, volg die betaling dan apart van de eSIM-bestelling zodat je een betalings- of leveringsprobleem kunt oplossen.
3. Maak één herstelbare aankoop
Genereer en sla een Idempotency-Key op voordat je de bestelling aanmaakt. Hergebruik die sleutel met hetzelfde verzoek als het antwoord wordt onderbroken.
Toon een verwerkingsstatus totdat de bestelling een definitieve uitkomst bereikt. Sla de bestelling op voordat je de klant naar de installatie stuurt, en laat ze er vanuit hun account naar terugkeren. Gebruik voor een niet-gefinancierde of mislukte bestelling de herstelstappen voor aankopen.
4. Lever privé-installatie-instructies
Nadat de bestelling is voltooid, maak je een gehoste installatielink voor de beoogde klant of verstuur je de link per e-mail of SMS. Volg de installatiegids voor levering, verloopdatum, intrekking en apparaatconfiguratie.
Behandel de link en activatiegegevens als inloggegevens. Houd ze uit analytics, openbare logs en routinematige supportnotities. Registreer voltooiing van de aankoop, levering van de link en installatie op het apparaat als afzonderlijke uitkomsten.
Als je een bestaande connectiviteitsdienst vervangt, plan dan een nieuwe Bird eSIM-aankoop en -installatie. Controleer het beoogde apparaat en pakket voordat de klant de bestaande dienst wijzigt. De Bird eSIM API importeert geen bestaand profiel en draagt geen mobiel nummer over.
5. Voeg een accountpagina toe voor doorlopend gebruik
Laat de geauthenticeerde klant de bestaande eSIM heropenen, gerapporteerde pakketsaldi en verloopdatum bekijken, en support bereiken. Toon de saldotijdstempel en onbekende waarden nauwkeurig.
Gebruik compatibele aanbiedingen voor opwaarderingen en de available_actions van de eSIM om te bepalen welke besturingselementen je toont. Leg een uitgeschakelde actie uit aan de hand van de geretourneerde reden, en verwerk een weigering als de beschikbaarheid verandert vóór verzending. Volg de gids voor terugkerende pakketten voor verlenging en annulering.
Verifieer onderbreking en herstel
Sluit de browser na de aankoop en open het account van de klant opnieuw. Bevestig dat het naar dezelfde bestelling en eSIM leidt. Herhaal dit nadat de installatie is gestart.
Controleer of een verloren aankoopantwoord, een verlopen installatielink en een onbekende gebruikswaarde elk tot een passende herstelactie leiden. Verifieer dat een klant de installatielink of eSIM van een andere klant niet kan openen via je accountpagina.
Volgende stappen
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.