Mobile Daten in Ihre App integrieren.

Nutzen Sie die eSIM-API, um Datenangebote zu entdecken, Pakete zu kaufen und private Installationslinks aus Ihrer Anwendung zu versenden. Halten Sie Kunden in Ihrem eigenen Kontoerlebnis für gemeldete Guthaben, kompatible Aufladungen und wiederkehrende Käufe, sofern verfügbar.

Starten Sie mit den verfügbaren Angeboten.

Verwenden Sie einen serverseitigen API-Schlüssel mit eSIM-Leseberechtigung, um den Katalog zu durchsuchen. Dieses Beispiel listet Angebote auf, ohne ein Paket zu kaufen.

1
bird esim offers list

Vom Angebot zur Bestellung

Verwandeln Sie ein Angebot in einen wiederherstellbaren Kauf.

Lesen Sie Abdeckung, Volumen und Gültigkeit des Angebots und rufen Sie dann den aktuellen Checkout-Preis ab. Ihr Organisations-Wallet finanziert den Kauf. Speichern Sie die resultierende Bestellung, damit der Kunde darauf zurückkommen kann, während Bird die eSIM und das Datenpaket bereitstellt.

Akzeptierte Bedingungen anzeigen

Senden Sie die akzeptierte Angebotsrevision und den Preis mit der Bestellung. Wenn sich die Bedingungen vor dem Kauf ändern, zeigen Sie das aktualisierte Angebot zur Annahme an. Wiederkehrende Käufe haben eigene verfügbare Bedingungen und einen eigenen Zeitplan.

Wiederherstellen ohne erneuten Kauf

Speichern Sie einen Idempotency-Key, bevor Sie eine Bestellung erstellen, und verwenden Sie ihn mit derselben Anfrage erneut, wenn die Antwort unterbrochen wird. Wenn Sie die Bestell-ID haben, lesen Sie diese Bestellung zuerst, um festzustellen, ob sie abgeschlossen wurde.

Gehostete Installation

Senden Sie eine Einrichtung, die der Kunde öffnen kann.

Nach Abschluss der Bestellung erstellen Sie einen gehosteten Installationslink oder senden ihn per E-Mail oder SMS. Der Kunde öffnet gerätespezifische Anleitungen, ohne sich in einem Bird-Workspace anzumelden. Verfolgen Sie die Nachrichtenzustellung getrennt von der Installation und der ersten mobilen Datenverbindung.

Installationszugriff kontrollieren

Installationszugangsdaten verwenden separate API-Berechtigungen. Prüfen Sie das Ablaufdatum des gehosteten Links und widerrufen Sie ihn, wenn er die falsche Person erreicht. Das Widerrufen eines Links unterbindet künftigen Zugriff darüber; es deaktiviert kein bereits installiertes Profil.

Paketguthaben lesen

Zeigen Sie gekauftes Volumen, Ablaufdatum und gemeldeten Verbrauch mit dem Beobachtungszeitpunkt an. Wenn der Verbrauch nicht verfügbar ist, lassen Sie ihn als unbekannt, damit Kunden ihr Paketvolumen von einem gemessenen Restguthaben unterscheiden können.

Laufende Käufe

Ermöglichen Sie Kunden, Daten zur selben eSIM hinzuzufügen.

Listen Sie kompatible Angebote für eine bestehende eSIM auf, bevor Sie eine Aufladung anzeigen. Eine abgeschlossene Aufladung fügt dem installierten Profil ein Paket hinzu, sodass der Kunde diese eSIM ohne erneute Installation weiternutzen kann.

Wiederkehrende Pakete planen

Wenn ein Angebot Verlängerung unterstützt, weisen Sie die Person zu, die die eSIM nutzt, und akzeptieren Sie den wiederkehrenden Preis und Rhythmus. Verfolgen Sie Zahlung und Paketbereitstellung jeder Periode und ermöglichen Sie dem Kunden, künftige Verlängerungen zu stoppen.

Kundenzugriff in Ihrer App behalten

Authentifizieren Sie Ihre Kunden und autorisieren Sie den Zugriff auf deren eigene Bestellungen und eSIMs. Ein Workspace-API-Schlüssel kann auf Ressourcen mehrerer Kunden zugreifen – bewahren Sie ihn daher auf Ihrem Server auf und ordnen Sie jede Ressource dem richtigen Konto zu.

Fragen zur eSIM-API

Was kann ich mit der eSIM-API entwickeln?
Integrieren Sie Angebotserkennung, Datenpaket-Käufe, Installationsbereitstellung und laufende Paketverwaltung in Ihre App. Kunden können kompatible Aufladungen kaufen und sich für wiederkehrende Käufe registrieren, sofern verfügbar. Ihre Anwendung übernimmt die Kundenauthentifizierung und jede Zahlung, die sie von ihnen einzieht.
Was brauche ich für einen Kauf?
Verwenden Sie einen Bird-Workspace, einen serverseitigen API-Schlüssel mit den erforderlichen eSIM-Berechtigungen und Guthaben im Organisations-Wallet. Prüfen Sie vor dem Kauf das Angebot, die Checkout-Bedingungen und die Identifikationsanforderungen. Das Lesen von Zugangsdaten sowie das Erstellen oder Versenden von Installationslinks erfordern separate Berechtigungen.
Wie gehe ich mit einer unterbrochenen Kaufantwort um?
Lesen Sie die bestehende Bestellung, wenn Sie deren ID haben. Andernfalls wiederholen Sie die gespeicherte Erstellungsanfrage mit dem ursprünglichen Idempotency-Key. Warten Sie das Ergebnis dieser Bestellung ab, bevor Sie eine neue anlegen, die eine weitere Belastung verursachen könnte.
Bedeutet eine abgeschlossene Bestellung, dass der Kunde online ist?
Eine abgeschlossene Bestellung identifiziert die gekaufte eSIM und das Paket. Der Kunde muss das Profil noch auf einem kompatiblen Gerät installieren und mobile Daten an einem abgedeckten Zielort testen. Installations- und Guthabenberichte können nach dem Geräteergebnis eintreffen.

Skalieren, ohne
die Kontrolle zu verlieren.

Organisieren Sie Teams in Workspaces, steuern Sie den API-Zugriff und verfolgen Sie Änderungen über Audit-Logs.

BirdHarborOrganisation
ArbeitsbereicheProduktionSandbox

Zustellagent

API-Schlüssel · Team Kundenbetrieb
Aktiv
BerechtigungenZugriff
E-MailLesen und Schreiben
SMSLesen und Schreiben
ALAlex Lee AdministratorBerechtigungen aktualisiert

Audit-Protokoll

Produktion
Workspace
Produktion
Ressource
Zustellagent
WhatsApp
LesezugriffLesen und Schreiben
Erfolgreich

Starten Sie mit eSIM.
Kanalübergreifend entwickeln mit Bird.

Ihre nächste Idee. Bereit zur Verbindung.