Sprawdź zużycie i dodaj doładowanie
Użyj tego przewodnika, aby dodać dane do istniejącego eSIM. Potrzebujesz uprawnień do odczytu eSIM i zakupu pakietu oraz wystarczających środków w portfelu. Dostępność doładowania zależy od profilu, istniejących pakietów i wybranej oferty.
1. Sprawdź aktywne pakiety
Otwórz profil z sekcji eSIMs i przejrzyj Data packages. Za pomocą API wyświetl pakiety eSIM i sprawdź ich status, datę wygaśnięcia oraz saldo.
balance.total_bytes to zakupiony pakiet danych. Wartość null w used_bytes, remaining_bytes lub used_percent oznacza brak dostępnego pomiaru. Traktuj te wartości jako nieznane w swojej aplikacji.
Odczytaj pole balance_reporting karty eSIM, aby zdecydować, co wyświetlić. Jeśli ma wartość unavailable, pokaż zakupiony pakiet danych bez prezentowania go jako zmierzonego pozostałego transferu. Jeśli ma wartość available, zużycie może być nadal nieznane do momentu nadejścia raportu. Dzienna historia użycia jest osobna i jest obecnie niedostępna.
Użyj balance.as_of jako czasu ostatniej aktualizacji salda; przed zgłoszeniem zużycia może to być czas dostarczenia pakietu. balance.observed_at to czas pomiaru sieciowego, jeśli został podany. Wyświetlaj znacznik czasu wraz ze zmierzonym zużyciem, aby klient mógł rozpoznać opóźniony raport.
2. Wyświetl kompatybilne oferty
Wybierz Top up na eSIM lub wywołaj Wyświetl kompatybilne oferty dla tego profilu. Użyj zwróconej oferty zamiast wybierać z katalogu ogólnego. Zasięg w tym samym kraju nie oznacza kompatybilności.
Jeśli doładowanie jest niedostępne, odczytaj available_actions na karcie eSIM, aby poznać przyczynę. Niedokończone zamówienie lub limit pakietów może uniemożliwić kolejny zakup. Rozwiąż istniejące zamówienie przed ponowną próbą. Odśwież kompatybilne oferty przed wysłaniem: oferta może stać się niedostępna między wyborem a zakupem.
Karta eSIM w stanie expired jest uśpiona i może wrócić do active po ukończeniu kompatybilnego doładowania. Sprawdź dostępną akcję i kompatybilne oferty, zanim zdecydujesz, że zainstalowany profil wymaga wymiany.
3. Przejrzyj obowiązujące warunki
Wyświetl pakiet danych, zasięg, opublikowaną cenę z walutą oraz okres ważności wybranej oferty. Porównaj ważność nowego pakietu z granicą usługi active_until karty eSIM, jeśli jest obecna. Jeśli ta granica skróciłaby zakupiony okres ważności, zamówienie zwraca 409 z efektywnym okresem ważności. Wyświetl krótszy okres i uzyskaj akceptację przed ustawieniem acknowledge_shortened_validity: true.
Doładowanie tworzy nowy pakiet. Nie zmienia salda istniejącego pakietu ani nie przedłuża jego daty wygaśnięcia. Sprawdź aktywację i datę wygaśnięcia nowego pakietu po dostarczeniu.
4. Zatwierdź zamówienie i śledź jego realizację
Potwierdź zakup w panelu. Za pomocą API utwórz zamówienie, używając istniejącego esim_id, wybranego offer_id, revision oferty jako offer_revision oraz jej pricing.price jako expected_price. Pomiń subscriber_id; doładowanie zachowuje istniejące przypisanie. Zapisz identyfikator zamówienia i Idempotency-Key na potrzeby ponownych prób.
Jeśli zaakceptowana cena lub rewizja się zmieniła, pobierz bieżącą ofertę i potwierdź nowe warunki przed złożeniem kolejnego zakupu. Skopiuj zwróconą kwotę i walutę bez konwersji ani zaokrąglania.
Śledź zamówienie w sekcji Orders lub pobierz zamówienie przez API. Sprawdź status po otrzymaniu odpowiedzi 201 i 202. Jeśli odpowiedź została utracona, ponów to samo żądanie z tym samym kluczem; nie twórz nowego zakupu, dopóki wynik jest niepewny.
5. Sprawdź wynikowy pakiet
Gdy zamówienie ma status completed, użyj jego package_id, aby pobrać nowy pakiet. Sprawdź, czy docelowa karta eSIM, zasięg i pakiet danych odpowiadają zakupowi. Doładowanie korzysta z zainstalowanego profilu; nie musisz instalować nowej karty eSIM. Pakiet oczekujący na pierwsze użycie może nie mieć jeszcze znacznika czasu aktywacji ani wygaśnięcia.
Rozwiązywanie problemów
Jeśli zamówienie jest zakończone, ale saldo pozostaje nieznane, porównaj stan pakietu i znaczniki czasu raportów. Raportowanie może być opóźnione względem zużycia na urządzeniu; ponowne zamówienie nie rozwiąże tego opóźnienia. Jeśli zakup się nie powiódł, sprawdź szczegóły błędu i ewentualną referencję kredytową przed ponowną próbą.
Następne kroki
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.