Weryfikacja SMS w Nigerii (+234) przez API dla zespołów QA, fintechu i wdrożeń rynkowych

Jakie endpointy wywołać, aby odebrać nigeryjski kod OTP?

Wszystko działa pod adresem https://otproute.com/api/v1 i uwierzytelnia się kluczem Bearer zaczynającym się od or_live_. Identyfikator kraju dla Nigerii to ng. Typowa integracja wykonuje cztery wywołania:

1. GET /api/v1/prices?country=ng&service=<id>, aby przed zamówieniem potwierdzić aktualną cenę.
2. POST /api/v1/activations z {"service": "<id>", "country": "ng"}, aby zarezerwować numer +234. Zachowaj zwrócony identyfikator aktywacji; każde kolejne wywołanie i każde zdarzenie webhooka są do niego przypisane.
3. GET /api/v1/activations/{id}, aby odczytać status i, po dostarczeniu, kod.
4. POST /api/v1/activations/{id}/cancel, jeśli test zawiedzie wcześniej i numer nie jest już potrzebny.

GET /api/v1/balance przydaje się jako kontrola przed startem w CI, dzięki czemu nocny zestaw testów szybko się zatrzyma, gdy portfel jest prawie pusty. Przewodnik integracji API OTP pokazuje tę samą sekwencję razem z obsługą błędów.

Czy zestaw testów z Lagos powinien odpytywać API, czy korzystać z webhooków?

Polling wystarczy przy kilku ręcznych uruchomieniach. Gdy pipeline zamawia równolegle kilka numerów +234, czystszym rozwiązaniem są webhooki. Zarejestruj jeden z pięciu dostępnych endpointów w konsoli deweloperskiej i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Każde żądanie niesie nagłówek X-OTPRoute-Signature: t=<unix>,v1=<hex>. Oblicz ponownie HMAC-SHA256 z znacznika czasu, kropki i surowej treści żądania przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzuć żądanie ze starym znacznikiem czasu. Zapisuj przetworzone identyfikatory aktywacji, aby ponowione zdarzenie nie uruchomiło testu dwa razy. Wpis o zabezpieczaniu webhooków OTP przez HMAC zawiera pełniejszą listę kontrolną. Cały ruch utrzymuj poniżej 300 żądań na minutę na konto, co jest wartością z zapasem, jeśli opierasz się na zdarzeniach, a nie na gęstym odpytywaniu.

Jakie usługi są dostępne na trasach +234?

Trasa ng obejmuje obecnie ponad 2 700 usług. Do często wybieranych należą WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon i ChatGPT (OpenAI). Zasób zmienia się w ciągu dnia, gdy nasi partnerzy operatorscy aktualizują dostępność, więc sprawdzaj dostępność na żywo, zamiast zakładać, że usługa widoczna wczoraj nadal jest na liście.

Dlaczego zespoły w ogóle potrzebują nigeryjskiego numeru weryfikacyjnego?

Nigeria to jeden z najbardziej ruchliwych rynków fintechu i aplikacji konsumenckich w Afryce, a wiele produktów traktuje numer telefonu jako główną tożsamość. Dlatego krok z SMS-em jest kluczową częścią onboardingu portfeli, aplikacji pożyczkowych, przewozów, dostaw i produktów społecznościowych. Zespoły spoza kraju używają numeru +234 do testów, aby sprawdzić, czy formularz rejestracji, licznik ponownej wysyłki i komunikaty o błędach zachowują się tak, jak dla lokalnego użytkownika.

Językiem urzędowym jest angielski, więc SMS-y weryfikacyjne zwykle przychodzą po angielsku, co upraszcza logikę asercji w testach automatycznych. Zespoły fintechowe powinny zajrzeć na stronę o onboardingu fintech, gdzie opisano, jak to współgra z kontrolami tożsamości, których OTP Route nie zastępuje.

Jak zapisywane są nigeryjskie numery komórkowe?

Kod kraju to +234, a prefiks krajowy to 0. Nigeryjczycy zwykle zapisują numer komórkowy jako jedenaście cyfr zaczynających się od zera, na przykład 0803 123 4567; w formie międzynarodowej zero znika i otrzymujesz +234 803 123 4567. Zapisuj wartość w formacie E.164 (+234803...), przyjmuj lokalny format jedenastocyfrowy na wejściu i usuwaj wiodące 0 przed zapisem. Walidator, który sprawdza tylko łączną długość, chętnie zaakceptuje +2340803..., a to częsta przyczyna nieudanych wysyłek na produkcji.

Czy nigeryjski numer mogę zamówić z panelu?

Tak. Załóż konto za pomocą kodu e-mail lub Google, zasil portfel, otwórz OTP Gateway, wybierz Nigerię i usługę, a następnie potwierdź wyświetloną cenę. Numer jest gotowy od razu, a kod pojawia się obok zamówienia, gdy dotrze.

Jeśli nie dotrze, pozwól upłynąć 20-minutowemu oknu; płacisz tylko wtedy, gdy kod dotrze, a wygasłe lub anulowane zamówienia są zwracane automatycznie. Potem spróbuj złożyć nowe zamówienie nieco później, wypróbuj inną trasę, na przykład Ghanę, jeśli test na to pozwala, i sprawdź, czy usługa nie odrzuca numerów wirtualnych. Unikaj składania nowych zamówień w szybkiej pętli.

A co z długoterminowymi nigeryjskimi numerami, rozliczeniami i sandboxem?

OTP Route nie oferuje samoobsługowego długoterminowego numeru w Nigerii. Numery dedykowane są sprzedawane wyłącznie dla Stanów Zjednoczonych i Kanady, od $1.95/miesiąc. W sprawie trwałej linii +234 napisz na [email protected]; to, czy da się ją zapewnić, zależy od lokalnych przepisów.

Wydatki pochodzą z jednego przedpłaconego portfela w USD, bez planu i bez opłaty miesięcznej. Doładowujesz kartą lub stablecoinami USDT/USDC i dostajesz fakturę PDF za każde doładowanie. Poproś wsparcie o przełączenie konta deweloperskiego w tryb sandbox, a integracja otrzyma symulowane numery i kody, dzięki czemu przetestujesz całą ścieżkę webhooka bez wydawania środków z portfela.

Najczęstsze pytania

Czy mogę przetestować nigeryjską rejestrację w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +234 w OTP Gateway i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator Nigerii w API OTP Route?

Użyj ng jako wartości country w zapytaniach o cenę i w żądaniach aktywacji.

Ile kosztuje odebranie SMS-a OTP z Nigerii?

Od $0.20 za kod, przy czym dokładna kwota zależy od usługi i jest zwracana przez endpoint cen.

Czy płacę, jeśli SMS nie dotrze?

Nie. Jeśli nic nie dotrze w ciągu 20 minut albo anulujesz zamówienie, cała kwota wraca do portfela.

Jak zapisać numer taki jak 0803 123 4567?

Usuń wiodące zero i zapisz go jako +2348031234567, czyli w formacie E.164 bez spacji.

Czy mogę używać tych numerów do dowolnego konta?

Tylko do własnych, legalnych produktów i kont. Przestrzegaj regulaminu każdej usługi oraz Zasad dopuszczalnego użytkowania OTP Route; niektóre usługi całkowicie odrzucają numery wirtualne.

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.