Doorlopende eSIM-pakketten beheren

Gebruik een terugkerend abonnement om datapakketten aan te schaffen op een facturatieschema. Je hebt toestemming nodig om eSIM-service aan te schaffen, organisatiewallet-tegoed en een abonnee voor de persoon die de eSIM gebruikt. Beschikbaarheid hangt af van het geselecteerde aanbod en profiel.

Deze handleiding behandelt nieuwe aankopen en inschrijving op een bestaande eSIM. De eSIM API biedt geen bewerking om een actief abonnement naar een ander plan om te zetten.

1. Bekijk de doorlopende voorwaarden

Voor een nieuwe eSIM, haal afrekenopties op. Bied automatische verlenging aan wanneer recurrence.available true is en gebruik de bijbehorende quote voor de geaccepteerde voorwaarden. Als deze niet beschikbaar is, bekijk unavailable_reason en bied een ondersteunde aankoopoptie aan.

Voor een bestaande eSIM, toon compatibele aanbiedingen met recurring_only=true en haal de terugkerende voorwaarden van het geselecteerde aanbod op. Inschrijving controleert de compatibiliteit opnieuw voordat de aankoop wordt geaccepteerd.

Toon de terugkerende prijs, gepubliceerde valuta, cadans en leveringsmodus vóór acceptatie. Het bedrag is exclusief belasting; de periodehistorie registreert het in rekening gebrachte totaal en de belasting. calendar_month volgt kalendermaanden; fixed_days gebruikt het opgegeven aantal dagen van 24 uur. De organisatiewallet betaalt voor de service; de abonnee heeft geen eigen wallet.

Controleer of het pakket het betaalde interval dekt (exact_period) of dat elke verlenging een standaardpakket koopt (recurring_top_up). Bij terugkerende opwaarderingen volgen activering en vervaldatum de pakketvoorwaarden en kunnen deze afwijken van factureringsgrenzen. Beloof geen ononderbroken data alleen omdat verlenging is gepland.

2. Wijs de abonnee toe

Open in het dashboard het profiel vanuit eSIMs, open More eSIM actions, selecteer Assign person, kies het contact en bevestig Assign person. Je kunt de toegewezen persoon later niet meer wijzigen.

Met de API, maak een abonnee aan met de contact_id van een contact in je werkruimte. Dit vereist email_marketing:read voor Contacts en esim:write. Het antwoord retourneert de bestaande abonnee wanneer het contact er al een heeft.

Het aanmaken van de koppeling voorkomt het verwijderen van het contact, ook nadat de eSIM is beëindigd. Abonneekoppelingen kunnen momenteel niet worden verwijderd, losgekoppeld of geanonimiseerd. Bepaal of die bewaring past bij je klantproces voordat je er een aanmaakt.

Voor een bestaand profiel, wijs de eSIM toe met subscriber_id. Dezelfde toewijzing herhalen retourneert het bestaande record; een andere persoon toewijzen retourneert 409. Voor een nieuw profiel, neem subscriber_id op in de aankoop zodat toewijzing samen met levering wordt voltooid.

Toewijzing verleent geen toegang tot de werkruimte of toestemming om installatiegegevens te lezen. Verwerk identificatieverzameling apart via de aanbodvereisten en de integratiehandleiding.

3. Schrijf in en verifieer de levering

Open voor een bestaande toegewezen eSIM in het dashboard Automatic renewal en selecteer Set up renewal. Kies een Package, selecteer Check recurring price en bekijk de prijs, cadans en leveringsvoorwaarden van het pakket. Selecteer Buy first package and renew om de eerste periode aan te schaffen en verlenging in te schakelen.

Voor een nieuwe eSIM via de API, maak een bestelling aan met de geselecteerde offer_id, werkruimte-subscriber_id en deze geaccepteerde afrekenvoorwaarden:

• Stel offer_revision in op recurrence.quote.offer_revision.
• Stel recurrence.recurrence_revision in op recurrence.quote.recurrence_revision.
• Stel recurrence.accepted_price in op het volledige recurrence.quote.price-object.

Stuur een Idempotency-Key; laat esim_id en expected_price weg voor deze aankoop. Sla het bestelling-ID en de bijbehorende recurring_subscription_id op. De eerste factureringsperiode begint wanneer de betaling gefinancierd is. Volg de bestelling totdat deze voltooid of mislukt is, en gebruik indien nodig de herstelstappen voor aankopen.

Voor een bestaande toegewezen eSIM, maak een terugkerend abonnement aan met esim_id, offer_id, de revision van het aanbod als offer_revision, en de revision van de terugkerende voorwaarden als recurrence_revision. Stuur de volledige price van de terugkerende voorwaarden als accepted_price. Een Idempotency-Key is vereist; hergebruik deze met hetzelfde verzoek om de inschrijving te herstellen. Inschrijving koopt de eerste periode direct aan; het wacht niet tot een bestaand pakket op is.

Haal het abonnement op en bekijk de periodes. Bevestig betaling en pakketlevering apart. Voor een nieuwe eSIM, lever installatiegegevens nadat de bestelling is voltooid.

4. Verlenging bewaken

Open Subscriptions om geaccepteerde voorwaarden, status en de volgende verlenging te bekijken. Lees in de API de next_renewal_at, stop_reason en periodegeschiedenis. Een gewijzigde gepubliceerde prijs vereist nieuwe acceptatie; een niet-gefinancierde verlenging stopt toekomstige aankopen.

Als status gelijk is aan needs_attention, bekijk dan de laatste periode en de bijbehorende bestelling. Bij een onopgeloste levering kunnen de kosten nog steeds verschuldigd zijn. De onopgeloste levering blokkeert een vervangende inschrijving. Neem contact op met support met deze referenties voordat je een vervanging aanschaft.

5. Toekomstige verlenging stoppen

Selecteer in het gedeelte Automatic renewal van de eSIM de optie Cancel renewal. Bekijk het einde van de huidige betaalde periode en bevestig vervolgens Cancel renewal in het dialoogvenster. Controleer het bijgewerkte abonnement op de annuleringsdatum.

Met de API, annuleer het abonnement en lees het opnieuw. Controleer cancel_at_period_end, cancellation_effective_at en next_renewal_at om te bevestigen wanneer de verlenging stopt. De kosten voor een al vastgelegde periode blijven verschuldigd. Geleverde pakketten behouden hun eigen geldigheid en het geïnstalleerde profiel blijft bewaard.

Het verwijderen van het profiel van de telefoon annuleert de verlenging niet. Het vrijgeven van een eSIM trekt deze definitief uit dienst, verbeurt resterende data en restitueert deze niet. Gebruik serviceacties als je zowel de connectiviteit als de verlenging wilt wijzigen.

Probleemoplossing

Het toevoegen van walletfondsen herstart een gestopte subscription niet automatisch. Controleer stop_reason en de eindstatus van de vorige service voordat je een nieuwe enrollment accepteert. Een mislukte betaalde levering en het bijbehorende tegoed hebben afzonderlijke uitkomsten: bekijk order_status en refund_transaction_id in de periodegeschiedenis.

Verifieer het klanttraject

Bevestig dat de klant de gekochte bundel, pakketvervaldatum, volgende verlenging, annuleringsdatum en het supportcontact kan vinden. Verifieer de levering van het eerste pakket en test mobiele data op een compatibel apparaat. Controleer de betaling en levering van een volgende periode apart van de geplande verlengingsdatum.

Volgende stappen

• Saldo's uitlezen en een eenmalige opwaardering kopen.
• Apparaatinstallatie voorbereiden.
• Betalings- of leveringsproblemen onderzoeken.