Bouw mobiele data in je app.
Gebruik de eSIM-API om data-aanbiedingen te ontdekken, pakketten aan te schaffen en privé-installatielinks vanuit je applicatie te versturen. Houd klanten in je eigen accountervaring voor gerapporteerde balansen, compatibele opwaarderingen en terugkerende aankopen waar beschikbaar.
Begin met de beschikbare aanbiedingen.
Gebruik een server-side API-sleutel met eSIM-leesrechten om de catalogus te verkennen. Dit voorbeeld toont aanbiedingen zonder een pakket te kopen.
bird esim offers listVan aanbieding naar bestelling
Zet een aanbieding om in een herstelbare aankoop.
Lees de dekking, het tegoed en de geldigheid van de aanbieding en haal vervolgens de actuele afrekenprijs op. Je organisatiewallet financiert de aankoop. Sla de resulterende bestelling op zodat de klant ernaar kan terugkeren terwijl Bird de eSIM en het datapakket inricht.
Toon de geaccepteerde voorwaarden
Stuur de geaccepteerde aanbiedingsrevisie en prijs mee met de bestelling. Als de voorwaarden vóór aankoop veranderen, toon dan de bijgewerkte offerte ter acceptatie. Terugkerende aankopen hebben eigen beschikbare voorwaarden en schema.
Herstel zonder extra aankoop
Sla een idempotency-sleutel op voordat je een bestelling aanmaakt en hergebruik deze met hetzelfde verzoek als de respons wordt onderbroken. Als je het bestelling-ID hebt, lees dan eerst die bestelling om te zien of deze is voltooid.
Gehoste installatie
Stuur setup die de klant kan openen.
Maak na voltooiing van de bestelling een gehoste installatielink aan of verstuur deze per e-mail of SMS. De klant opent apparaatspecifieke instructies zonder in te loggen bij een Bird-werkruimte. Volg berichtaflevering apart van installatie en de eerste mobiele-dataverbinding.
Beheer installatietoegang
Installatiecredentials gebruiken aparte API-rechten. Controleer de verloopdatum van de gehoste link en trek deze in als de verkeerde persoon hem ontvangt. Het intrekken van een link blokkeert toekomstige toegang via die link; het deactiveert geen profiel dat al is geïnstalleerd.
Lees pakketbalansen
Toon gekocht tegoed, verloopdatum en gerapporteerd verbruik met het observatietijdstip. Wanneer verbruik niet beschikbaar is, houd het dan onbekend zodat klanten hun pakkettegoed kunnen onderscheiden van een gemeten resterend saldo.
Doorlopende aankopen
Laat klanten data toevoegen aan dezelfde eSIM.
Toon compatibele aanbiedingen voor een bestaande eSIM voordat je een opwaardering presenteert. Een voltooide opwaardering voegt een pakket toe aan het geïnstalleerde profiel, zodat de klant die eSIM kan blijven gebruiken zonder nieuwe installatie.
Plan terugkerende pakketten
Wijs, waar een aanbieding verlenging ondersteunt, de persoon toe die de eSIM gebruikt en accepteer de terugkerende prijs en frequentie. Volg de betaling en pakketlevering van elke periode en laat de klant toekomstige verlenging stopzetten.
Houd klanttoegang in je app
Authenticeer je klanten en autoriseer toegang tot hun eigen bestellingen en eSIM's. Een werkruimte-API-sleutel heeft toegang tot resources van meerdere klanten, dus bewaar deze op je server en koppel elke resource aan het juiste account.
Vragen over de eSIM-API
Wat kan ik bouwen met de eSIM-API?
Wat heb ik nodig om een aankoop te doen?
Hoe ga ik om met een onderbroken aankooprespons?
Betekent een voltooide bestelling dat de klant online is?
Verbind de volledige dienst
Schaal op zonder
controle te verliezen.
Organiseer teams in werkruimtes, beheer API-toegang en traceer wijzigingen via auditlogs.
Auditlog
Productie- Werkruimte
- Productie
- Resource
- Verzendagent
- LeestoegangLezen en schrijven