Testowanie rejestracji w Sudanie Południowym bez karty SIM +211

Problem: wdrożenie w Sudanie Południowym i brak lokalnej karty SIM w zespole

Wyobraź sobie produkt, który już obsługuje Afrykę Wschodnią i dodaje Sudan Południowy do listy krajów. QA musi potwierdzić, że numer +211 przechodzi walidację, odbiera kod i prowadzi użytkownika na właściwy ekran. Nikt w zespole nie jest w Dżubie, roaming międzynarodowy trudno szybko załatwić, a pożyczanie prywatnego telefonu współpracownika na konta testowe to nawyk, który warto porzucić.

Zdalny numer weryfikacyjny z Sudanu Południowego rozwiązuje wąską część tego problemu: dostarczenie jednego prawdziwego kodu na linię +211, na żądanie, ze skryptu lub z przeglądarki. Szerszy proces opisuje nasza strona o testach QA.

Co OTP Route oferuje dla numerów +211?

OTP Gateway przydziela numer z Sudanu Południowego do jednej weryfikacji. Wybierasz usługę i kraj, używasz numeru w aplikacji, a kod trafia do panelu i do Twoich systemów. Aktywacja pozostaje otwarta przez 20 minut, a płacisz tylko wtedy, gdy SMS dotrze.

Bieżący zrzut pokazuje ponad 900 usług dla Sudanu Południowego, w tym WhatsApp, Facebook, imo, Telegram, Instagram, TikTok, Snapchat, Viber, Signal, Google (Gmail i YouTube), X (Twitter) i Uber. Zasoby zmieniają się w ciągu dnia, więc traktuj to jako wskazówkę i przed przebiegiem odpytaj aktualną listę.

Jak OTP API dla Sudanu Południowego działa w kodzie?

Skieruj klienta na https://otproute.com/api/v1 z kluczem Bearer (or_live_…) z konsoli deweloperskiej. Identyfikator kraju to ss.

• GET /api/v1/prices?country=ss&service=<id> zwraca dzisiejszą cenę dla pary.
• POST /api/v1/activations z {"service": "imo", "country": "ss"} rezerwuje numer.
• GET /api/v1/activations/{id} pozwala odpytywać o kod; POST /api/v1/activations/{id}/cancel zwalnia go wcześniej.

Dla równoległych zestawów webhook jest lepszy od odpytywania. Zasubskrybuj activation.sms_received i activation.expired, zweryfikuj X-OTPRoute-Signature (HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu), odrzucaj nieaktualne znaczniki czasu i uczyń handler idempotentnym względem identyfikatora aktywacji. Z tego korzystają zwłaszcza pipeline'y, jak opisano w artykule o testach SMS OTP w pipeline'ach CI. Każde konto może mieć 10 kluczy i 5 endpointów webhook, a przepustowość jest ograniczona do 300 żądań na minutę.

Brak dewelopera pod ręką? Użyj panelu

1. Zaloguj się i otwórz OTP Gateway.
2. Wybierz Sudan Południowy, a potem testowaną usługę.
3. Sprawdź wyświetloną cenę, potwierdź i skopiuj numer +211.
4. Wpisz go w aplikacji i poczekaj na tej samej stronie na kod.
5. Anuluj, jeśli test został odwołany; kwota wraca do portfela.

Format numeru, język i lokalny kontekst

Sudan Południowy otrzymał własny kod kraju, +211, po uzyskaniu niepodległości w 2011 roku, więc starsze dane kontaktowe i niektóre starsze biblioteki walidacji mogą nadal zachowywać się dziwnie. Numery komórkowe mają dziewięć cyfr po kodzie kraju. Zapisywane do wybierania lokalnego zwykle mają początkowe 0; usuń je przy konwersji do E.164 i zapisz +211 oraz dziewięć cyfr.

Językiem urzędowym jest angielski, a szeroko używany jest arabski z Dżuby, więc SMS-y weryfikacyjne mogą przychodzić po angielsku lub po arabsku, zależnie od ustawień regionalnych aplikacji. Rozsądnym dodatkiem jest przetestowanie obu szablonów oraz renderowania od prawej do lewej każdego tekstu arabskiego. Zespoły testują tu również na potrzeby operacji humanitarnych i logistycznych, regionalnych kont firmowych oraz użytkowników diaspory, którzy za granicą zachowują numer +211.

Co zrobić, gdy kod nie dociera?

• Zanim ponowisz, odczekaj 20-minutowe okno.
• Sprawdź, czy usługa akceptuje numery wirtualne; niektóre je odrzucają.
• Spróbuj później albo przełącz się na inną trasę usługi, zamiast składać zamówienia w szybkiej pętli.
• Upewnij się, że Twój endpoint webhook nie odrzuca poprawnych podpisów.

Wygasła lub anulowana aktywacja zwraca się sama; nie ma czego zgłaszać. Dalsze pomysły znajdziesz w tekście o ograniczaniu nieudanych dostaw OTP.

Linie długoterminowe, portfel i sandbox

Dla Sudanu Południowego w OTP Route nie ma samoobsługowego numeru długoterminowego. Numery dedykowane, od $1.95/miesiąc, są dostępne tylko w Stanach Zjednoczonych i Kanadzie. Jeśli potrzebujesz trwałej linii +211, napisz na [email protected]; to, czy da się ją załatwić, zależy od lokalnych przepisów.

Płatność odbywa się z przedpłaconego portfela w USD bez opłaty miesięcznej: zasil go kartą lub USDT/USDC, otrzymuj fakturę PDF za każde doładowanie, a aktualne stawki zobacz na stronie cennika. Do prac deweloperskich na życzenie można włączyć tryb sandbox, który zwraca symulowane numery i kody, aby sprawdzić integrację, zanim wydasz realne środki.

Najczęstsze pytania

Czy mogę odebrać SMS OTP z Sudanu Południowego, nie będąc w kraju?

Tak. OTP Gateway zdalnie daje numer +211, a kod pojawia się w panelu i przez API.

Jaki jest identyfikator kraju dla Sudanu Południowego w API?

Użyj ss przy tworzeniu aktywacji lub pytaniu o ceny.

Czy numery +211 zapisywać z początkowym zerem?

Nie. Usuń lokalne 0 i zapisz format E.164: +211 oraz dziewięć cyfr.

Ile usług działa z numerami z Sudanu Południowego?

Aktualna lista zawiera ponad 900 usług, choć dostępność zmienia się w ciągu dnia.

Czy mogę testować rejestrację w Sudanie Południowym z pipeline'u CI?

Tak. Utwórz aktywację z krajem ss w swoim zadaniu, odbierz activation.sms_received na podpisanym webhooku i wprowadź kod w tym samym kroku testu. Konto sandbox pozwala przećwiczyć to bez wydawania środków z portfela.

Co się dzieje, jeśli anuluję aktywację?

Cała kwota wraca do portfela automatycznie, tak samo jak wtedy, gdy 20-minutowe okno mija bez kodu.

Czy numer +211 do testów wolno używać do dowolnych celów?

Nie. Używaj go do testowania lub obsługi własnych, legalnych produktów, przestrzegaj regulaminu każdej usługi i trzymaj się Zasad dopuszczalnego użytkowania OTP Route.

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.