Zarządzanie cyklicznymi pakietami eSIM

Użyj cyklicznej subskrypcji, aby kupować pakiety danych zgodnie z harmonogramem rozliczeniowym. Potrzebujesz uprawnień do zakupu usługi eSIM, środków w portfelu organizacji oraz subskrybenta przypisanego do osoby korzystającej z eSIM. Dostępność zależy od wybranej oferty i profilu.

Ten przewodnik obejmuje nowe zakupy i rejestrację na istniejącej karcie eSIM. API eSIM nie udostępnia operacji przełączenia aktywnej subskrypcji na inny plan.

1. Przejrzyj warunki cykliczne

Dla nowej karty eSIM pobierz opcje zakupu. Zaproponuj automatyczne odnowienie, gdy recurrence.available ma wartość true, i użyj jego quote jako zaakceptowanych warunków. Jeśli jest niedostępne, sprawdź unavailable_reason i zaproponuj obsługiwaną opcję zakupu.

Dla istniejącej karty eSIM wyświetl kompatybilne oferty z recurring_only=true, a następnie pobierz warunki cykliczne wybranej oferty. Rejestracja ponownie sprawdza kompatybilność przed zaakceptowaniem zakupu.

Wyświetl cenę cykliczną, opublikowaną walutę, częstotliwość i tryb dostawy przed akceptacją. Kwota jest podana przed opodatkowaniem; historia okresów rejestruje naliczoną sumę i podatek. calendar_month stosuje miesiące kalendarzowe; fixed_days używa podanej liczby 24-godzinnych dni. Portfel organizacji opłaca usługę; subskrybent nie ma osobnego portfela.

Sprawdź, czy pakiet pokrywa opłacony interwał (exact_period), czy każde odnowienie kupuje standardowy pakiet (recurring_top_up). Przy cyklicznych doładowaniach aktywacja i wygaśnięcie podlegają warunkom pakietu i mogą różnić się od granic rozliczeniowych. Nie obiecuj nieprzerwanego dostępu do danych tylko dlatego, że odnowienie jest zaplanowane.

2. Przypisz abonenta

W panelu otwórz profil z sekcji eSIMs, otwórz More eSIM actions, wybierz Assign person, wybierz kontakt i potwierdź Assign person. Przypisanej osoby nie można później zmienić.

Za pomocą API utwórz subskrybenta, używając contact_id kontaktu w Twoim obszarze roboczym. Wymaga to email_marketing:read dla Contacts oraz esim:write. Odpowiedź zwraca istniejącego subskrybenta, gdy kontakt już go posiada.

Utworzenie powiązania uniemożliwia usunięcie kontaktu, również po zakończeniu eSIM. Powiązań subskrybenta nie można obecnie usunąć, odłączyć ani zanonimizować. Zdecyduj, czy taka retencja pasuje do Twojego procesu obsługi klienta, zanim utworzysz powiązanie.

Dla istniejącego profilu przypisz eSIM za pomocą subscriber_id. Powtórzenie tego samego przypisania zwraca istniejący rekord; przypisanie innej osoby zwraca 409. Dla nowego profilu dodaj subscriber_id do zakupu, aby przypisanie zakończyło się wraz z dostarczeniem.

Przypisanie nie przyznaje dostępu do obszaru roboczego ani uprawnień do odczytu danych instalacyjnych. Zbieranie danych identyfikacyjnych obsłuż osobno, korzystając z wymagań oferty i przewodnika integracji.

3. Zarejestruj i zweryfikuj dostarczanie

W przypadku istniejącej przypisanej karty eSIM w panelu otwórz Automatic renewal i wybierz Set up renewal. Wybierz Package, kliknij Check recurring price i sprawdź cenę, kadencję oraz warunki dostarczenia pakietu. Wybierz Buy first package and renew, aby zakupić pierwszy okres i włączyć odnawianie.

W przypadku nowej karty eSIM przez API utwórz zamówienie z wybraną offer_id, subscriber_id obszaru roboczego i następującymi zaakceptowanymi warunkami zakupu:

• Ustaw offer_revision na recurrence.quote.offer_revision.
• Ustaw recurrence.recurrence_revision na recurrence.quote.recurrence_revision.
• Ustaw recurrence.accepted_price na kompletny obiekt recurrence.quote.price.

Wyślij Idempotency-Key; pomiń esim_id i expected_price dla tego zakupu. Zapisz identyfikator zamówienia i jego recurring_subscription_id. Pierwszy okres rozliczeniowy rozpoczyna się po sfinansowaniu płatności. Śledź zamówienie do momentu zakończenia lub niepowodzenia, korzystając w razie potrzeby z kroków odzyskiwania zakupu.

W przypadku istniejącej przypisanej karty eSIM utwórz cykliczną subskrypcję z esim_id, offer_id, revision oferty jako offer_revision oraz revision warunków cyklicznych jako recurrence_revision. Wyślij kompletny price warunków cyklicznych jako accepted_price. Idempotency-Key jest wymagany; użyj go ponownie z tym samym żądaniem, aby odzyskać rejestrację. Rejestracja natychmiast kupuje pierwszy okres; nie czeka na wyczerpanie istniejącego pakietu.

Pobierz subskrypcję i wyświetl jej okresy. Potwierdź płatność i dostarczenie pakietu oddzielnie. W przypadku nowej karty eSIM dostarcz dane instalacyjne po zakończeniu zamówienia.

4. Monitoruj odnowienie

Otwórz Subscriptions, aby sprawdzić zaakceptowane warunki, status i następne odnowienie. W API odczytaj next_renewal_at, stop_reason oraz historię okresów. Zmieniona opublikowana cena wymaga ponownej akceptacji; niesfinansowane odnowienie wstrzymuje przyszłe zakupy.

Jeśli status ma wartość needs_attention, sprawdź ostatni okres i powiązane zamówienie. Nierozwiązane dostarczenie może pozostać do zapłaty i blokuje zastępczą rejestrację. Skontaktuj się ze wsparciem, podając te referencje, zanim zakupisz zamiennik.

5. Zatrzymaj przyszłe odnowienia

W sekcji Automatic renewal karty eSIM wybierz Cancel renewal. Sprawdź koniec bieżącego opłaconego okresu, a następnie potwierdź Cancel renewal w oknie dialogowym. Sprawdź zaktualizowaną subskrypcję pod kątem daty anulowania.

Za pomocą API anuluj subskrypcję, a następnie odczytaj ją ponownie. Sprawdź cancel_at_period_end, cancellation_effective_at i next_renewal_at, aby potwierdzić, kiedy odnowienie się kończy. Okres już zatwierdzony pozostaje do zapłaty. Dostarczone pakiety zachowują własną ważność, a zainstalowany profil jest zachowany.

Usunięcie profilu z telefonu nie anuluje odnowienia. Zwolnienie eSIM trwale wycofuje kartę, powoduje utratę pozostałych danych i nie podlega zwrotowi. Użyj akcji serwisowych, gdy chcesz zmienić łączność, a nie tylko odnowienie.

Rozwiązywanie problemów

Doładowanie portfela nie powoduje automatycznego wznowienia zatrzymanej subskrypcji. Sprawdź stop_reason i stan końcowy poprzedniej usługi przed zaakceptowaniem nowej rejestracji. Nieudana opłacona dostawa i jej zwrot mają oddzielne wyniki: sprawdź order_status i refund_transaction_id w historii okresów.

Zweryfikuj ścieżkę klienta

Potwierdź, że klient może znaleźć zakupiony limit danych, datę wygaśnięcia pakietu, termin następnego odnowienia, datę anulowania oraz kontakt do wsparcia. Zweryfikuj dostarczenie pierwszego pakietu i przetestuj dane mobilne na kompatybilnym urządzeniu. Sprawdź płatność i dostarczenie kolejnego okresu oddzielnie od zaplanowanej daty odnowienia.

Następne kroki

• Sprawdź salda i kup jednorazowe doładowanie.
• Przygotuj instalację na urządzeniu.
• Zbadaj problemy z płatnością lub dostarczeniem.