Testowanie przepływów weryfikacji +27: lista kontrolna przed wdrożeniem w RPA

Przed pierwszym zamówieniem +27: krótka lista gotowości

Odhacz te punkty, a pierwsza południowoafrykańska aktywacja powinna przejść bez niespodzianek:

1. Zasilony portfel. Jeden przedpłacony portfel w USD finansuje wszystko; zasil go kartą lub USDT/USDC. Żadna subskrypcja nie jest potrzebna.
2. Wystawiony klucz. Wygeneruj klucz Bearer w konsoli deweloperskiej (zaczyna się od or_live_). Trzymaj osobne klucze dla CI i dla stagingu, łącznie do 10.
3. Zarejestrowany webhook. Dodaj endpoint HTTPS i zapisz jego sekret do podpisów. Możesz zarejestrować do pięciu.
4. Przetestowany normalizator numerów. Podaj mu dane w stylu 082 123 4567 i sprawdź, że zwraca +2782... z usuniętym początkowym 0.
5. Potwierdzony identyfikator usługi. Pobierz katalog z GET /api/v1/services, zamiast zgadywać identyfikatory.
6. Sandbox opcjonalnie. Wsparcie może przełączyć konto deweloperskie w tryb sandbox, aby symulowane numery i kody przepłynęły przez Twój kod przed jakimikolwiek realnymi wydatkami.

Poradnik testów w CI pokazuje, jak wpiąć te elementy w pipeline.

Jak przechowywać i normalizować numery południowoafrykańskie?

RPA używa prefiksu krajowego 0. Numer komórkowy zapisany lokalnie ma dziesięć cyfr, np. 082 123 4567, a zakresy komórkowe w tej krajowej postaci zaczynają się zwykle od 06, 07 lub 08. W formacie międzynarodowym 0 znika: ta sama linia staje się +27 82 123 4567, a po usunięciu spacji +27821234567, czyli dziewięć cyfr po kodzie kraju.

Klasyczny błąd to zapisana wartość w rodzaju +270821234567, powstająca, gdy formularz dokleja kod kraju do numeru lokalnego bez usunięcia 0. Normalizuj przy wprowadzaniu, przechowuj tylko E.164, a lokalny format ze spacjami generuj wyłącznie do wyświetlania. Jeśli sam wysyłasz SMS-y wychodzące, ta sama zasada utrzymuje spójność raportów doręczeń i wyszukiwania użytkowników.

Które usługi mogą wysyłać kody na południowoafrykański numer weryfikacyjny?

Do popularnych tras dla za należą obecnie WhatsApp, Facebook, Instagram, TikTok, Google (Gmail i YouTube), Uber, Telegram, Microsoft i Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) i Discord. W całym katalogu kraj obsługuje ponad 1 700 usług, a ponieważ zasoby zmieniają się w ciągu dnia, aktualną dostępność należy odczytywać z API.

Dlaczego zespoły wybierają ten rynek? Johannesburg i Kapsztad to ugruntowane ośrodki technologii i finansów, a wiele firm traktuje RPA jako bazę szerszego wdrożenia w Afryce Południowej. Kraj ma kilka języków urzędowych, w tym angielski, isiZulu, isiXhosa i afrikaans, jednak większość wiadomości weryfikacyjnych przychodzi po angielsku, więc QA lokalizacji koncentruje się zwykle na otaczających ekranach, a nie na samym tekście SMS.

Kroki: wywoływanie OTP API dla RPA z Twojego środowiska testowego

Żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer, do 300 na minutę.

1. GET /api/v1/prices?country=za&service=<id> zwraca aktualną cenę dla wybranej pary.
2. POST /api/v1/activations z {"service": "<id>", "country": "za"} rezerwuje numer +27 i zwraca identyfikator aktywacji.
3. Twój test wpisuje numer w aplikacji i wyzwala SMS.
4. Zdarzenie activation.sms_received dociera na webhook. Zanim mu zaufasz, odtwórz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj z v1 w X-OTPRoute-Signature i odrzuć żądania ze zbyt starym znacznikiem czasu.
5. Wolisz odpytywanie? Odczytuj GET /api/v1/activations/{id} w spokojnym odstępie.
6. Porzucone przebiegi powinny wywołać POST /api/v1/activations/{id}/cancel, a GET /api/v1/balance pozwala zadaniu przerwać pracę wcześniej, gdy środków jest mało.

Więcej o wyborze tras znajdziesz w tekście o routingu krajów dla OTP.

Kroki dla pracowników operacyjnych korzystających z panelu

Kod nie jest potrzebny: otwórz OTP Gateway, wybierz RPA i usługę, sprawdź wyświetloną cenę, potwierdź i wklej numer +27 do aplikacji. SMS pojawia się na stronie aktywacji, gdy tylko dotrze, a 20-minutowe okno i automatyczny zwrot działają dokładnie tak samo jak w API.

Rozwiązywanie problemów z zawieszonymi kodami z RPA

Najpierw kwestia pieniędzy: jeśli SMS nie dotrze w ciągu 20 minut albo anulujesz zamówienie, cała kwota wraca do portfela automatycznie. Potem diagnozuj:

• Najpierw cierpliwość. Szybkość dostarczenia zależy od usługi i trasy, więc pozwól aktywacji dobiec końca.
• Polityka akceptacji. Niektóre usługi odrzucają numery wirtualne; zwrot w takim przypadku to oczekiwane zachowanie, nie usterka.
• Inna pora lub trasa. Spróbuj później albo użyj sąsiedniej trasy, takiej jak Namibia czy Botswana, jeśli pozwala na to przypadek testowy.
• Bez zasypywania. Anulowanie i ponowne zamawianie w ciasnej pętli rzadko pomaga, a zużywa limit żądań.

Używaj numerów wyłącznie do testowania własnego produktu lub obsługi własnych kont firmowych, przestrzegaj regulaminu każdej usługi i pamiętaj, że obowiązują Zasady dopuszczalnego użytkowania OTP Route.

Długoterminowe linie południowoafrykańskie i model rozliczeń

Samoobsługowego, długoterminowego numeru +27 nie ma. Numery dedykowane, od $1.95/miesiąc, są oferowane tylko w Stanach Zjednoczonych i Kanadzie; zespoły potrzebujące stałej linii południowoafrykańskiej mogą napisać na [email protected], a to, czy jest to możliwe, zależy od lokalnych przepisów. Rozliczenie działa w modelu pay as you go z przedpłaconego portfela, a po każdym doładowaniu wysyłamy e-mailem fakturę PDF. Pełny obraz znajdziesz w cenniku.

Najczęstsze pytania

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

Tak. Zamów numer +27 przez OTP Gateway i odczytaj kod w panelu lub przez API. Koszt to od $0.20 za kod i tylko wtedy, gdy kod dotrze.

Czy przy konwersji południowoafrykańskiego numeru do E.164 zachować początkowe 0?

Nie. Usuń prefiks krajowy 0 i dodaj +27, więc 082 123 4567 staje się +27821234567.

Jaki jest identyfikator kraju dla RPA w API?

To za; podajesz go w zapytaniu o cenę i w treści JSON przy tworzeniu aktywacji +27.

W jakim języku są południowoafrykańskie SMS-y weryfikacyjne?

Przeważnie po angielsku, mimo że kraj ma kilka języków urzędowych. Treść ustala usługa wysyłająca.

Czy dostanę zwrot, jeśli kod nigdy nie dotrze?

Tak. Aktywacja jest otwarta przez 20 minut, a jeśli nic nie dotrze lub anulujesz, cała kwota wraca do portfela automatycznie.

Czy mogę kupić południowoafrykański numer na kilka miesięcy?

Nie w trybie samoobsługowym. Numery dedykowane to produkt dla USA i Kanady; w sprawie RPA napisz do wsparcia, bez obietnicy dostępności.

Ile usług mogę zweryfikować numerem +27 w OTP Route?

Ponad 1 700 według najnowszego zrzutu. Sprawdzaj bieżący katalog przez API, bo dostępność zmienia się w ciągu dnia.

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.