Verbruik bekijken en een top-up toevoegen
Gebruik deze handleiding om data toe te voegen aan een bestaande eSIM. Je hebt toestemming nodig om de eSIM te lezen en een pakket te kopen, plus voldoende walletsaldo. De beschikbaarheid van top-ups hangt af van het profiel, bestaande pakketten en de geselecteerde aanbieding.
1. Bekijk de actieve pakketten
Open het profiel vanuit eSIMs en bekijk Data packages. Met de API kun je de pakketten van de eSIM opvragen en hun status, vervaldatum en saldo bekijken.
balance.total_bytes is de gekochte databundel. Een null-waarde voor used_bytes, remaining_bytes of used_percent betekent dat er geen meting beschikbaar is. Houd die waarden als onbekend in je applicatie.
Lees het balance_reporting-veld van de eSIM om te bepalen wat je toont. Als het unavailable is, toon dan de gekochte databundel zonder die te presenteren als gemeten resterende data. Als het available is, kan het verbruik nog onbekend zijn totdat er een rapport binnenkomt. Dagelijkse gebruikshistorie is apart en is momenteel niet beschikbaar.
Gebruik balance.as_of voor het tijdstip van de laatste balansupdate; voordat verbruik wordt gerapporteerd, kan dit het levermoment van het pakket zijn. balance.observed_at is het meettijdstip van het netwerk wanneer dat is meegegeven. Toon het tijdstip samen met het gemeten verbruik zodat de klant een vertraagd rapport kan herkennen.
2. Toon compatibele aanbiedingen
Selecteer Top up op de eSIM, of roep Compatibele aanbiedingen opvragen aan voor dat profiel. Gebruik een geretourneerde aanbieding in plaats van er een uit de algemene catalogus te kiezen. Dekking in hetzelfde land garandeert geen compatibiliteit.
Als een top-up niet beschikbaar is, lees dan available_actions op de eSIM voor de reden. Een onafgeronde bestelling of de pakketlimiet kan een nieuwe aankoop blokkeren. Los de bestaande bestelling op voordat je het opnieuw probeert. Vernieuw de compatibele aanbiedingen voordat je indient: een aanbieding kan tussen selectie en aankoop onbeschikbaar worden.
Een eSIM in expired is inactief en kan terugkeren naar active nadat een compatibele top-up is voltooid. Controleer de beschikbare actie en compatibele aanbiedingen voordat je besluit dat het geïnstalleerde profiel vervangen moet worden.
3. Controleer de geldende voorwaarden
Toon de databundel, dekking, gepubliceerde prijs en valuta, en geldigheid van de geselecteerde aanbieding. Vergelijk de geldigheid van het nieuwe pakket met de active_until-servicegrens van de eSIM indien aanwezig. Als die grens de gekochte geldigheid zou inkorten, retourneert de bestelling 409 met de effectieve geldigheid. Toon de kortere periode en verkrijg acceptatie voordat je acknowledge_shortened_validity: true instelt.
Een top-up maakt een nieuw pakket aan. Het wijzigt het saldo van een bestaand pakket niet en verlengt de vervaldatum van dat pakket niet. Controleer de activering en vervaldatum van het nieuwe pakket na levering.
4. Keur goed en volg de bestelling
Bevestig de aankoop in het dashboard. Maak met de API een bestelling aan met de bestaande esim_id, geselecteerde offer_id, de revision van de aanbieding als offer_revision, en de pricing.price als expected_price. Laat subscriber_id weg; een top-up behoudt de bestaande toewijzing. Sla het bestel-ID en een Idempotency-Key op voor nieuwe pogingen.
Als de geaccepteerde prijs of revisie is gewijzigd, haal dan de huidige aanbieding op en bevestig de nieuwe voorwaarden voordat je nog een aankoop indient. Kopieer het geretourneerde prijsbedrag en de valuta zonder conversie of afronding.
Volg de bestelling in Orders, of haal de bestelling op via de API. Controleer status na zowel de 201- als de 202-respons. Als de respons verloren gaat, herhaal dan hetzelfde verzoek met dezelfde sleutel; maak geen vervangende aankoop aan zolang de uitkomst onzeker is.
5. Controleer het resulterende pakket
Wanneer de bestelling completed is, gebruik dan de package_id om het nieuwe pakket op te halen. Controleer of de doel-eSIM, dekking en databundel overeenkomen met de aankoop. De top-up gebruikt het geïnstalleerde profiel; je hoeft geen nieuwe eSIM te installeren. Een pakket dat wacht op eerste gebruik kan nog geen activerings- of vervaltijdstip hebben.
Probleemoplossing
Als de bestelling voltooid is maar een saldo onbekend blijft, vergelijk dan de pakketstatus en de rapporttijdstempels. Rapportage kan achterlopen op het apparaatverbruik; opnieuw bestellen lost die vertraging niet op. Als een aankoop mislukt, bekijk dan de foutdetails en een eventuele creditreferentie voordat je het opnieuw probeert.
Vervolgstappen
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.