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.

1
bird esim offers list

Van 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?
Bouw aanbodontdekking, aankoop van datapakketten, installatielevering en doorlopend pakketbeheer in je app. Klanten kunnen compatibele opwaarderingen kopen en zich waar beschikbaar inschrijven voor terugkerende aankopen. Jouw applicatie beheert klantauthenticatie en alle betalingen die je van hen int.
Wat heb ik nodig om een aankoop te doen?
Gebruik een Bird-werkruimte, een server-side API-sleutel met de vereiste eSIM-rechten en organisatiewallettegoed. Controleer het aanbod, de afrekenvoorwaarden en identificatievereisten voordat je koopt. Het lezen van credentials en het aanmaken of verzenden van installatielinks vereisen aparte credentialrechten.
Hoe ga ik om met een onderbroken aankooprespons?
Lees de bestaande bestelling als je het ID hebt. Herhaal anders het opgeslagen aanmaakverzoek met de originele idempotency-sleutel. Volg die bestelling tot voltooiing of falen voordat je een vervanging aanmaakt die een extra afschrijving kan veroorzaken.
Betekent een voltooide bestelling dat de klant online is?
Een voltooide bestelling identificeert de gekochte eSIM en het pakket. De klant moet het profiel nog op een compatibel apparaat installeren en mobiele data testen op een gedekte bestemming. Installatie- en balansrapporten kunnen na het apparaatresultaat binnenkomen.

Schaal op zonder
controle te verliezen.

Organiseer teams in werkruimtes, beheer API-toegang en traceer wijzigingen via auditlogs.

BirdHarborOrganisatie
WerkruimtesProductieSandbox

Verzendagent

API-sleutel · Team Klantoperaties
Actief
MachtigingenToegang
EmailLezen en schrijven
SMSLezen en schrijven
ALAlex Lee BeheerderMachtigingen bijgewerkt

Auditlog

Productie
Werkruimte
Productie
Resource
Verzendagent
WhatsApp
LeestoegangLezen en schrijven
Geslaagd

Begin met eSIM.
Bouw over kanalen heen met Bird.

Jouw volgende idee. Klaar om te verbinden.