Testowanie rejestracji z numerem +93, gdy nikt w zespole nie ma afgańskiej karty SIM

Nasi użytkownicy rejestrują się numerami +93, ale QA nie może tego odtworzyć. Co robić?

To częsta luka w aplikacjach do przelewów, narzędziach logistyki humanitarnej, komunikatorach i marketplace'ach z dużą afgańską diasporą. Zgłoszenia do supportu wspominają o kodach, które nie docierają, lub numerach odrzucanych przez formularz, a zespół testowy siedzi w Berlinie, Dubaju lub Toronto i nie ma jak włożyć afgańskiej karty SIM do urządzenia.

Numer weryfikacyjny z Afganistanu z OTP Gateway zamyka tę lukę. Zamawiasz tymczasową linię +93 dla jednej usługi, wpisujesz ją w testowany przepływ, a kod pojawia się tam, gdzie pracują Twoi inżynierowie. Nic nie trzeba wysyłać, uruchamiać w roamingu ani rejestrować lokalnie, a po użyciu kodu numer jest wycofywany.

To samo podejście sprawdza się u product managerów, którzy chcą przed wydaniem obejrzeć od początku do końca zlokalizowany lejek onboardingowy, lub w zespole operacyjnym, który potrzebuje numeru +93 do testów integracji z partnerem.

Jak pobierać afgańskie kody OTP do środowiska testowego przez API?

API OTP dla Afganistanu korzysta z tych samych wywołań co każda inna trasa; zmienia się tylko identyfikator kraju. Dla Afganistanu to af.

1. Utwórz klucz Bearer z prefiksem or_live_ w konsoli deweloperskiej. Konto może mieć do 10 kluczy i 5 endpointów webhooków, przy limicie 300 żądań na minutę.
2. Wywołaj GET /api/v1/services, aby znaleźć identyfikator usługi, a następnie GET /api/v1/prices?country=af&service=<id>, by zobaczyć, ile ta trasa kosztuje w tej chwili.
3. Wyślij POST /api/v1/activations z treścią JSON wskazującą usługę i af. Odpowiedź zawiera identyfikator aktywacji i numer +93.
4. Albo odpytuj GET /api/v1/activations/{id}, albo czekaj na zdarzenie activation.sms_received na webhooku. Sprawdź nagłówek X-OTPRoute-Signature, czyli HMAC-SHA256 z znacznika czasu i surowej treści, i odrzucaj żądania z nieaktualnym znacznikiem czasu.
5. Jeśli test zostanie porzucony, POST /api/v1/activations/{id}/cancel zwalnia numer i zwraca zablokowaną kwotę.

Dokumentacja API opisuje każdy endpoint, a przewodnik o przechwytywaniu OTP przez webhooki pokazuje, jak kluczować zdarzenia według identyfikatora aktywacji, aby ponowienia były idempotentne.

Które aplikacje mogą dziś wysyłać kody na numer afgański?

Bieżący zrzut dla af wymienia ponad 1700 usług. Do najczęściej wybieranych przez zespoły należą WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, imo, Viber, Signal, TikTok, Microsoft & Outlook, LinkedIn, Discord i ChatGPT (OpenAI).

Na tej liście dominują komunikatory z konkretnego powodu: aplikacje głosowe i czatowe są dla wielu afgańskich rodzin za granicą głównym sposobem kontaktu, więc produkty integrujące się z nimi generują duży ruch +93. Dostępność zmienia się w ciągu dnia, gdy nasi partnerzy operatorscy rotują zasoby, dlatego API zwraca to, co można zamówić w chwili zapytania, zamiast stałego katalogu.

A co z osobami, które nigdy nie dotykają API?

Agenci supportu i product ownerzy mogą wykonać całość w przeglądarce. Zarejestruj się adresem e-mail i 6-cyfrowym kodem (lub przez Google), doładuj konto, otwórz OTP Gateway, wybierz Afganistan i usługę, a następnie potwierdź wyświetloną cenę. Numer +93 pojawia się od razu; wklej go do testowanej aplikacji i zostaw kartę otwartą. Gdy SMS dotrze, kod wyświetla się obok zamówienia.

Włączenie uwierzytelniania dwuskładnikowego (TOTP) w panelu to rozsądny krok dla każdego konta, z którego korzysta kilku współpracowników.

Jak przechowywać i normalizować afgańskie numery telefonów?

Afganistan używa kodu kraju +93 i prefiksu krajowego 0. Lokalnie numer komórkowy zapisuje się z tym zerem na początku, na przykład 07X XXX XXXX, a w formie międzynarodowej zero znika: +93 7X XXX XXXX. Zapisuj w bazie wersję E.164 (+937...) i usuwaj początkowe 0, gdy użytkownik wpisze format lokalny obok selektora +93, w przeciwnym razie walidator naliczy o jedną cyfrę za dużo.

Językami urzędowymi są dari i paszto, ale duże globalne usługi zwykle wysyłają treść kodu po angielsku lub w języku ustawionym na koncie czy urządzeniu. Przetestuj zarówno ustawienia regionalne pisane od prawej do lewej, jak i angielskie, jeśli Twoja aplikacja gdziekolwiek wyświetla treść SMS-a, na przykład jako podpowiedź autouzupełniania.

Kod się nie pojawił. Co powinien spróbować zespół?

Trasy do Afganistanu bywają nierówne, więc zaplanuj sporadyczne braki:

• Poczekaj do końca 20-minutowego okna. Wolny SMS nadal się liczy, jeśli dotrze przed wygaśnięciem.
• Pamiętaj o zasadzie zwrotu. Płacisz tylko wtedy, gdy kod dotrze; wygasła lub anulowana aktywacja automatycznie zwraca całą kwotę.
• Spróbuj później albo inną trasą. Nowe zamówienie nieco później albo ta sama usługa w pobliskim kraju, takim jak Pakistan, często się udaje.
• Sprawdź, czy usługa akceptuje numery wirtualne. Niektóre je odrzucają z zasady i żadna trasa tego nie zmieni.
• Nie zasypuj endpointu. Ponowne zamawianie w ciasnej pętli zużywa limit żądań bez poprawy dostarczania; rób przerwy między próbami.

Artykuł o ograniczaniu nieudanych dostaw OTP szerzej omawia projektowanie ponowień.

Czy możemy zachować linię +93 na logowania w przyszłym miesiącu i jak wygląda rozliczanie?

Nie ma samoobsługowej długoterminowej linii afgańskiej. Numery dedykowane to osobny produkt sprzedawany wyłącznie dla Stanów Zjednoczonych i Kanady, od $1.95/month, z SMS-ami przychodzącymi i wychodzącymi oraz połączeniami w przeglądarce. Jeśli zespół naprawdę potrzebuje trwałej linii +93, napisz na [email protected]; to, czy da się ją załatwić, zależy od lokalnych przepisów, a odpowiedź może być odmowna.

Rozliczenia OTP Gateway odbywają się przez jeden przedpłacony portfel w USD, bez opłaty miesięcznej i bez wyboru planu. Doładuj go kartą lub USDT/USDC, a każde doładowanie generuje fakturę PDF wysyłaną e-mailem. Do prac integracyjnych poproś support o przełączenie konta deweloperskiego w tryb sandbox, który zwraca symulowane numery i kody bez ruszania salda. Pełny cennik znajdziesz na stronie z cennikiem.

Najczęstsze pytania

Czy mogę przetestować afgański proces rejestracji w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +93 dla odpowiedniej usługi w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator Afganistanu w API OTP Route?

To af. Podaj go jako wartość country przy tworzeniu aktywacji lub sprawdzaniu cen.

Ile kosztuje odebranie SMS-a OTP z Afganistanu?

Kody kosztują od $0.20 za kod. Dokładna kwota zależy od usługi i jest zwracana przez GET /api/v1/prices przed zamówieniem.

Czy zapłacę, jeśli SMS weryfikacyjny nigdy nie dotrze?

Nie. Jeśli kod nie dotrze w 20-minutowym oknie albo wcześniej anulujesz zamówienie, cała kwota automatycznie wraca do portfela.

Czy afgańskie numery zapisywać z początkowym zerem?

Zapisuj je w formacie E.164 zaczynającym się od +93 i bez prefiksu krajowego 0; akceptuj format lokalny na wejściu i normalizuj go przed zapisem.

Czy każda usługa akceptuje numer +93 z OTP Route?

Niekoniecznie, bo niektóre usługi odrzucają numery wirtualne. Przestrzegaj regulaminu każdej usługi oraz naszego Regulaminu dopuszczalnego użytkowania, który ogranicza korzystanie do własnych, legalnych kont i produktów.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.