Wiederkehrende eSIM-Pakete verwalten

Nutzen Sie ein wiederkehrendes Abonnement, um Datenpakete nach einem Abrechnungsplan zu kaufen. Sie benötigen die Berechtigung zum Kauf von eSIM-Diensten, Guthaben im Organisations-Wallet und einen Subscriber für die Person, die die eSIM nutzt. Die Verfügbarkeit hängt vom gewählten Angebot und Profil ab.

Diese Anleitung behandelt Neukäufe und die Registrierung auf einer bestehenden eSIM. Die eSIM-API bietet keine Operation, um ein aktives Abonnement auf einen anderen Tarif umzustellen.

1. Verlängerungsbedingungen prüfen

Für eine neue eSIM rufen Sie die Checkout-Optionen ab. Bieten Sie die automatische Verlängerung an, wenn recurrence.available den Wert true hat, und verwenden Sie das zugehörige quote für die akzeptierten Bedingungen. Falls nicht verfügbar, prüfen Sie unavailable_reason und bieten Sie eine unterstützte Kaufoption an.

Für eine bestehende eSIM listen Sie kompatible Angebote auf mit recurring_only=true und rufen Sie dann die wiederkehrenden Bedingungen des gewählten Angebots ab. Die Registrierung prüft die Kompatibilität erneut, bevor sie den Kauf annimmt.

Zeigen Sie den wiederkehrenden Preis, die veröffentlichte Währung, den Abrechnungsrhythmus und den Liefermodus vor der Annahme an. Der Preis versteht sich vor Steuern; die Periodenhistorie erfasst den berechneten Gesamtbetrag und die Steuer. calendar_month folgt Kalendermonaten; fixed_days verwendet die angegebene Anzahl von 24-Stunden-Tagen. Das Organisations-Wallet bezahlt den Dienst; der Subscriber hat kein eigenes Wallet.

Prüfen Sie, ob das Paket das bezahlte Intervall abdeckt (exact_period) oder ob jede Verlängerung ein Standardpaket kauft (recurring_top_up). Bei wiederkehrenden Aufladungen richten sich Aktivierung und Ablauf nach den Paketbedingungen und können von den Abrechnungsgrenzen abweichen. Versprechen Sie keine unterbrechungsfreien Daten allein deshalb, weil eine Verlängerung geplant ist.

2. Teilnehmer zuweisen

Öffnen Sie im Dashboard das Profil über eSIMs, öffnen Sie More eSIM actions, wählen Sie Assign person, wählen Sie den Kontakt und bestätigen Sie mit Assign person. Die zugewiesene Person kann nachträglich nicht geändert werden.

Mit der API erstellen Sie einen Subscriber unter Verwendung der contact_id eines Kontakts in Ihrem Workspace. Dies erfordert email_marketing:read für Contacts und esim:write. Die Antwort gibt den bestehenden Subscriber zurück, wenn der Kontakt bereits einen hat.

Das Erstellen der Zuordnung verhindert das Löschen des Kontakts, auch nach Ablauf der eSIM. Subscriber-Zuordnungen können derzeit nicht entfernt, getrennt oder anonymisiert werden. Entscheiden Sie vor dem Erstellen, ob diese Datenhaltung zu Ihrem Kundenprozess passt.

Für ein bestehendes Profil weisen Sie die eSIM zu mit subscriber_id. Dieselbe Zuweisung erneut zu senden gibt den bestehenden Datensatz zurück; die Zuweisung einer anderen Person gibt 409 zurück. Für ein neues Profil fügen Sie subscriber_id in den Kauf ein, damit die Zuweisung zusammen mit der Lieferung abgeschlossen wird.

Die Zuweisung gewährt keinen Workspace-Zugang und keine Berechtigung zum Lesen von Installationsdaten. Führen Sie die Identitätsprüfung separat durch, unter Verwendung der Angebotsanforderungen und der Integrationsanleitung.

3. Registrieren und Zustellung verifizieren

Öffnen Sie für eine vorhandene zugewiesene eSIM im Dashboard Automatic renewal und wählen Sie Set up renewal. Wählen Sie ein Package, klicken Sie auf Check recurring price und prüfen Sie Preis, Kadenz und Paketlieferbedingungen. Wählen Sie Buy first package and renew, um den ersten Zeitraum zu kaufen und die Verlängerung zu aktivieren.

Für eine neue eSIM über die API erstellen Sie eine Bestellung mit dem gewählten offer_id, dem Workspace-subscriber_id und diesen akzeptierten Checkout-Bedingungen:

• Setzen Sie offer_revision auf recurrence.quote.offer_revision.
• Setzen Sie recurrence.recurrence_revision auf recurrence.quote.recurrence_revision.
• Setzen Sie recurrence.accepted_price auf das vollständige recurrence.quote.price-Objekt.

Senden Sie eine Idempotency-Key; lassen Sie esim_id und expected_price bei diesem Kauf weg. Speichern Sie die Bestell-ID und ihre recurring_subscription_id. Der erste Abrechnungszeitraum beginnt, wenn die Zahlung gedeckt ist. Verfolgen Sie die Bestellung, bis sie abgeschlossen ist oder fehlschlägt, und nutzen Sie bei Bedarf die Schritte zur Kaufwiederherstellung.

Für eine vorhandene zugewiesene eSIM erstellen Sie ein wiederkehrendes Abonnement mit esim_id, offer_id, der revision des Angebots als offer_revision und der revision der Verlängerungsbedingungen als recurrence_revision. Senden Sie die vollständige price der Verlängerungsbedingungen als accepted_price. Eine Idempotency-Key ist erforderlich; verwenden Sie sie mit derselben Anfrage erneut, um die Registrierung wiederherzustellen. Die Registrierung kauft den ersten Zeitraum sofort; sie wartet nicht, bis ein vorhandenes Paket aufgebraucht ist.

Rufen Sie das Abonnement ab und listen Sie dessen Zeiträume auf. Bestätigen Sie Zahlung und Paketlieferung getrennt. Für eine neue eSIM übermitteln Sie die Installationsdetails, nachdem deren Bestellung abgeschlossen ist.

4. Verlängerung überwachen

Öffnen Sie Subscriptions, um akzeptierte Bedingungen, Status und die nächste Verlängerung einzusehen. Lesen Sie in der API die Felder next_renewal_at, stop_reason und die Zeitraumhistorie. Ein geänderter veröffentlichter Preis erfordert eine neue Zustimmung; eine nicht gedeckte Verlängerung stoppt künftige Käufe.

Wenn status den Wert needs_attention hat, prüfen Sie den letzten Zeitraum und die zugehörige Bestellung. Eine ungelöste Lieferung kann zahlungspflichtig bleiben und blockiert eine Ersatzregistrierung. Kontaktieren Sie den Support mit diesen Referenzen, bevor Sie einen Ersatz kaufen.

5. Künftige Verlängerung stoppen

Wählen Sie im Bereich Automatic renewal der eSIM die Option Cancel renewal. Prüfen Sie das Ende des aktuellen bezahlten Zeitraums und bestätigen Sie dann Cancel renewal im Dialog. Überprüfen Sie das aktualisierte Abonnement auf sein Kündigungsdatum.

Mit der API kündigen Sie das Abonnement und lesen Sie es anschließend erneut. Prüfen Sie cancel_at_period_end, cancellation_effective_at und next_renewal_at, um zu bestätigen, wann die Verlängerung endet. Ein bereits gebuchter Zeitraum bleibt zahlungspflichtig. Gelieferte Pakete behalten ihre eigene Gültigkeit, und das installierte Profil bleibt erhalten.

Das Entfernen des Profils vom Telefon stoppt die Verlängerung nicht. Die Freigabe einer eSIM zieht sie dauerhaft aus dem Verkehr, verwirkt verbleibendes Datenvolumen und erstattet es nicht. Verwenden Sie Service-Aktionen, wenn Sie neben der Verlängerung auch die Konnektivität ändern möchten.

Fehlerbehebung

Das Aufladen des Wallets startet ein gestopptes Abonnement nicht automatisch neu. Prüfen Sie stop_reason und den Endstatus des vorherigen Dienstes, bevor Sie eine neue Registrierung akzeptieren. Eine fehlgeschlagene bezahlte Zustellung und deren Gutschrift haben unterschiedliche Ergebnisse: Prüfen Sie order_status und refund_transaction_id in der Periodenhistorie.

Kundenreise überprüfen

Stellen Sie sicher, dass der Kunde das gekaufte Datenvolumen, den Paketablauf, die nächste Verlängerung, das Kündigungsdatum und den Supportkontakt finden kann. Überprüfen Sie die Zustellung des ersten Pakets und testen Sie mobile Daten auf einem kompatiblen Gerät. Prüfen Sie Zahlung und Zustellung einer Folgeperiode getrennt vom geplanten Verlängerungsdatum.

Nächste Schritte

• Guthaben abrufen und einmalige Aufladung kaufen.
• Geräteinstallation vorbereiten.
• Zahlungs- oder Lieferprobleme untersuchen.