eSIM-Konnektivität in Ihre App einbetten
Verwenden Sie diese Anleitung, um einen eSIM-Kauf mit einem Konto in Ihrer App zu verknüpfen. Sie benötigen einen Bird-Workspace, eine serverseitige API-Integration und eine Möglichkeit, Ihre Kunden zu authentifizieren. Folgen Sie der API-Anleitung für Berechtigungen und Anfragedetails.
1. Angebote anzeigen, die Ihr Kunde nutzen kann
Listen Sie Angebote auf für das Reiseziel des Kunden und zeigen Sie Abdeckung, Volumen, Gültigkeit und veröffentlichten Preis des ausgewählten Angebots an. Prüfen Sie vor dem Kauf die Gerätekompatibilität und Identifikationsanforderungen.
Verwenden Sie für automatische Verlängerung die Checkout-Optionen des Angebots, um die verfügbaren Kaufmodi und akzeptierten Bedingungen anzuzeigen. Speichern Sie die Angebotsrevision und den angebotenen Preis zusammen mit der Auswahl des Kunden. Wenn sich das Angebot ändert, zeigen Sie die neuen Bedingungen an und bitten Sie den Kunden, diese vor dem Kauf zu akzeptieren.
2. Den Kauf Ihrem Kunden zuordnen
Bewahren Sie Bird-API-Schlüssel auf Ihrem Server auf. Autorisieren Sie den Zugriff auf jede Bestellung und eSIM über das Kundenkonto Ihrer App; ein Workspace-API-Schlüssel kann auf Ressourcen mehrerer Kunden zugreifen.
Speichern Sie Ihre Kunden-ID zusammen mit der Bestell-ID und nach der Zustellung die eSIM- und Paket-IDs. Wenn Sie einen benannten Servicenutzer oder eine automatische Verlängerung benötigen, erstellen Sie einen Subscriber aus einem Workspace-Kontakt. Die Zuweisung erfasst, wer die eSIM nutzt; sie meldet diese Person nicht in Ihrer App an und gewährt keinen Zugriff auf Zugangsdaten.
Ihr Organisations-Wallet finanziert den Bird-Kauf. Wenn Sie Ihrem Kunden separat eine Zahlung berechnen, verfolgen Sie diese Zahlung getrennt von der eSIM-Bestellung, damit Sie einen Zahlungs- oder Zustellungsfehler lösen können.
3. Einen wiederherstellbaren Kauf erstellen
Generieren und speichern Sie einen Idempotency-Key, bevor Sie die Bestellung erstellen. Verwenden Sie denselben Schlüssel mit derselben Anfrage erneut, wenn die Antwort unterbrochen wird.
Zeigen Sie einen Verarbeitungsstatus an, bis die Bestellung ein endgültiges Ergebnis erreicht. Speichern Sie die Bestellung, bevor Sie den Kunden zur Installation weiterleiten, und ermöglichen Sie ihm, über sein Konto dorthin zurückzukehren. Verwenden Sie bei einer nicht finanzierten oder fehlgeschlagenen Bestellung die Schritte zur Kaufwiederherstellung.
4. Private Installationsanweisungen bereitstellen
Nachdem die Bestellung abgeschlossen ist, erstellen Sie einen gehosteten Installationslink für den vorgesehenen Kunden oder senden Sie den Link per E-Mail oder SMS. Folgen Sie der Installationsanleitung für Zustellung, Ablauf, Widerruf und Geräteeinrichtung.
Behandeln Sie den Link und die Aktivierungsdetails wie Zugangsdaten. Halten Sie sie aus Analysen, öffentlichen Logs und routinemäßigen Support-Notizen heraus. Erfassen Sie Kaufabschluss, Link-Zustellung und Geräteinstallation als separate Ergebnisse.
Wenn Sie einen bestehenden Konnektivitätsdienst ersetzen, planen Sie einen neuen Bird-eSIM-Kauf und eine neue Installation. Prüfen Sie das vorgesehene Gerät und das Paket, bevor der Kunde seinen bestehenden Dienst ändert. Die Bird eSIM API importiert kein bestehendes Profil und überträgt keine Mobilfunknummer.
5. Eine Kontoseite für die fortlaufende Nutzung hinzufügen
Ermöglichen Sie dem authentifizierten Kunden, seine bestehende eSIM erneut zu öffnen, gemeldete Paketguthaben und Ablaufdaten einzusehen und den Support zu erreichen. Zeigen Sie den Zeitstempel des Guthabens und unbekannte Werte korrekt an.
Verwenden Sie kompatible Angebote für Aufladungen und den available_actions der eSIM, um zu entscheiden, welche Steuerelemente angezeigt werden. Erklären Sie eine deaktivierte Aktion anhand des zurückgegebenen Grundes und behandeln Sie eine Ablehnung, wenn sich die Verfügbarkeit vor dem Absenden ändert. Folgen Sie der Anleitung für wiederkehrende Pakete für Verlängerung und Kündigung.
Unterbrechung und Wiederherstellung prüfen
Schließen Sie den Browser nach dem Kauf und öffnen Sie das Konto des Kunden erneut. Bestätigen Sie, dass es zur selben Bestellung und eSIM führt. Wiederholen Sie den Vorgang nach Beginn der Installation.
Prüfen Sie, dass eine verlorene Kaufantwort, ein abgelaufener Installationslink und ein unbekannter Nutzungswert jeweils zu einer geeigneten Wiederherstellungsaktion führen. Stellen Sie sicher, dass ein Kunde nicht über Ihre Kontoseite den Installationslink oder die eSIM eines anderen Kunden öffnen kann.
Nächste Schritte
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.