Osadź łączność eSIM w swojej aplikacji
Skorzystaj z tego przewodnika, aby powiązać zakup eSIM z kontem w swojej aplikacji. Potrzebujesz obszaru roboczego Bird, integracji API po stronie serwera oraz sposobu uwierzytelniania klientów. Postępuj zgodnie z przewodnikiem API, aby poznać uprawnienia i szczegóły żądań.
1. Pokaż oferty, z których klient może skorzystać
Wyświetl oferty dla miejsca docelowego klienta i pokaż zasięg, limit, ważność oraz opublikowaną cenę wybranej oferty. Sprawdź kompatybilność urządzenia i wymagania identyfikacyjne przed zakupem.
W przypadku automatycznego odnawiania użyj opcji zakupu oferty, aby wyświetlić dostępne tryby zakupu i zaakceptowane warunki. Zachowaj rewizję oferty i podaną cenę wraz z wyborem klienta. Jeśli wycena się zmieni, pokaż nowe warunki i poproś klienta o ich zaakceptowanie przed zakupem.
2. Powiąż zakup z klientem
Przechowuj klucze Bird API na swoim serwerze. Autoryzuj dostęp do każdego zamówienia i eSIM za pomocą konta klienta w aplikacji; klucz API obszaru roboczego może uzyskać dostęp do zasobów należących do wielu klientów.
Zapisz identyfikator klienta razem z identyfikatorem zamówienia, a po dostarczeniu także identyfikatory eSIM i pakietu. Jeśli potrzebujesz nazwanego użytkownika usługi lub automatycznego odnawiania, utwórz subskrybenta z kontaktu w obszarze roboczym. Przypisanie rejestruje, kto używa eSIM; nie loguje tej osoby do Twojej aplikacji ani nie daje dostępu do poświadczeń.
Portfel Twojej organizacji finansuje zakup Bird. Jeśli pobierasz opłatę od klienta osobno, śledź tę płatność niezależnie od zamówienia eSIM, aby móc rozwiązać problem z płatnością lub dostawą.
3. Utwórz jeden odzyskiwalny zakup
Wygeneruj i zapisz Idempotency-Key przed utworzeniem zamówienia. Użyj tego samego klucza z tym samym żądaniem, jeśli odpowiedź zostanie przerwana.
Wyświetlaj stan przetwarzania, dopóki zamówienie nie osiągnie końcowego wyniku. Zapisz zamówienie przed przekierowaniem klienta do instalacji i pozwól mu wrócić do niego z poziomu konta. W przypadku nieopłaconego lub nieudanego zamówienia skorzystaj z kroków odzyskiwania zakupu.
4. Dostarczaj prywatne instrukcje instalacji
Po zakończeniu zamówienia utwórz hostowany link instalacyjny dla wskazanego klienta lub wyślij link e-mailem albo przez SMS. Postępuj zgodnie z przewodnikiem instalacji w kwestii dostarczania, wygasania, unieważniania i konfiguracji urządzenia.
Traktuj link i dane aktywacyjne jak poświadczenia. Nie umieszczaj ich w analityce, publicznych logach ani rutynowych notatkach wsparcia. Rejestruj zakończenie zakupu, dostarczenie linku i instalację na urządzeniu jako oddzielne wyniki.
Jeśli zastępujesz istniejącą usługę łączności, zaplanuj nowy zakup i instalację eSIM Bird. Sprawdź docelowe urządzenie i pakiet, zanim klient zmieni swoją obecną usługę. Bird eSIM API nie importuje istniejącego profilu ani nie przenosi numeru telefonu.
5. Dodaj stronę konta do bieżącego użytkowania
Pozwól uwierzytelnionemu klientowi ponownie otworzyć jego istniejącą kartę eSIM, zobaczyć raportowane salda pakietów i datę wygaśnięcia oraz skontaktować się ze wsparciem. Wyświetlaj znacznik czasu salda i nieznane wartości dokładnie.
Użyj kompatybilnych ofert do doładowań oraz available_actions karty eSIM, aby zdecydować, które kontrolki wyświetlić. Wyjaśnij wyłączoną akcję, podając zwrócony powód, i obsłuż odmowę, jeśli dostępność zmieni się przed wysłaniem. Postępuj zgodnie z przewodnikiem pakietów cyklicznych w kwestii odnawiania i anulowania.
Zweryfikuj przerwanie i odzyskiwanie
Zamknij przeglądarkę po zakupie i ponownie otwórz konto klienta. Potwierdź, że prowadzi ono do tego samego zamówienia i karty eSIM. Powtórz po rozpoczęciu instalacji.
Sprawdź, czy utracona odpowiedź zakupu, wygasły link instalacyjny i nieznana wartość zużycia prowadzą do odpowiedniej akcji odzyskiwania. Zweryfikuj, że jeden klient nie może otworzyć linku instalacyjnego ani karty eSIM innego klienta przez swoją stronę konta.
Następne kroki
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.