Jak wprowadzić liberyjskie (+231) kody weryfikacyjne do swoich testów

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

Liberia to anglojęzyczny rynek Afryki Zachodniej, więc jest praktycznym pierwszym przystankiem dla firm rozwijających się wzdłuż wybrzeża: treści rzadko wymagają tłumaczenia, dzięki czemu wysiłek testowy idzie w sam proces weryfikacji. Zespoły zerkają też na +231, gdy obsługują liberyjską diasporę i chcą potwierdzić, że krewny w kraju naprawdę dokończy rejestrację. Zwłaszcza produkty fintechowe i marketplace'owe muszą przed startem zobaczyć, że lokalny numer przechodzi ich kontrole; szerszy wzorzec opisuje strona onboarding w fintechu.

Trzecią grupą są pracownicy operacyjni, którzy zarządzają kontami firmowymi dla liberyjskiego biura lub partnera. Numer z bramki do jednorazowej weryfikacji trzyma prywatne telefony pracowników z dala od profili firmowych, a kod trafia tam, gdzie widzi go cały zespół.

Co mogę zweryfikować na trasie +231?

Kraj obecnie obejmuje ponad 1,700 usług. Do częstych wyborów należą WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), Snapchat, imo, Viber, X (Twitter), LinkedIn oraz Microsoft & Outlook. Zasoby zmieniają się w ciągu dnia, dlatego API zwraca aktualną dostępność zamiast stałego katalogu.

W planie testów wypisz dwie lub trzy usługi, na których faktycznie polegają Twoi użytkownicy, a potem na początku przebiegu sprawdź każdą parę zapytaniem o cenę. Komunikator działający dziś rano na +231 po południu może być chwilowo niedostępny, a potok, który najpierw sprawdza, kończy się jasnym powodem zamiast przekroczeniem czasu.

Jakie endpointy wywołuje integracja dla Liberii?

Wszystko znajduje się pod https://otproute.com/api/v1 z kluczem Bearer z konsoli deweloperskiej.

• Identyfikatory znajdziesz przez GET /api/v1/services i GET /api/v1/countries; Liberia to lr.
• Wyceń parę przez GET /api/v1/prices?country=lr&service=<id>.
• Utwórz zamówienie przez POST /api/v1/activations z treścią {"service": "<id>", "country": "lr"}.
• Odbieraj activation.sms_received, activation.expired lub activation.cancelled na swoim webhooku, wiążąc je z identyfikatorem aktywacji, albo odpytuj GET /api/v1/activations/{id}.

Sprawdzaj X-OTPRoute-Signature przy każdym webhooku: oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu i odrzucaj stare znaczniki czasu. Szczegóły pokazuje wpis o bezpieczeństwie webhooków.

Czy mogę odebrać liberyjski SMS OTP bez pisania kodu?

Tak. W panelu wybierz Liberię, wybierz usługę, potwierdź wyświetloną cenę i złóż zamówienie. Wklej numer +231 do aplikacji; kod pojawi się obok zamówienia, gdy tylko zostanie dostarczony. Skopiuj go prosto do pola kodu w aplikacji, a jeśli zamówienie przestało być potrzebne, anuluj je z tego samego ekranu, aby saldo wróciło od razu.

Jak formatować i normalizować numery +231?

Numery liberyjskie zapisuje się lokalnie zwykle z początkowym prefiksem krajowym 0. Usuń to zero i dodaj +231, aby uzyskać postać E.164, którą powinna przechowywać Twoja baza danych. Numery komórkowe różnych lokalnych operatorów mają ten sam kod kraju +231, więc przy routingu OTP nie trzeba rozgałęziać logiki według operatora. Waliduj względem formy międzynarodowej, a nie lokalnej, i trzymaj osobny ciąg do wyświetlania, jeśli Twoje wsparcie woli znajomy lokalny układ. Językiem urzędowym jest angielski, więc większość szablonów usług przychodzi po angielsku. Upraszcza to wyciąganie kodu, ale nadal dopasowuj grupę cyfr, a nie stałe zdanie, bo usługi zmieniają brzmienie wiadomości bez ostrzeżenia.

Co pomaga, gdy liberyjski kod się spóźnia lub nie przychodzi?

Dostarczenie zależy od usługi i trasy. Jeśli nic się nie pojawia:

• Poczekaj na koniec 20-minutowego okna; anulowane lub wygasłe zamówienie jest zwracane w całości.
• Spróbuj później albo inną trasą usługi.
• Sprawdź, czy usługa akceptuje numery wirtualne; niektóre je odrzucają.
• Unikaj ponownego zamawiania w ciasnej pętli, bo to tylko zużywa próby.

Więcej na ten temat w artykule o ograniczaniu nieudanych dostaw OTP.

Czy jest długoterminowa linia liberyjska i jak się za nią płaci?

Dla Liberii nie ma samoobsługowego numeru długoterminowego. Linie dedykowane to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/miesiąc. Jeśli potrzebujesz trwałej linii liberyjskiej, napisz na [email protected]; to, czy jest możliwa, zależy od lokalnych przepisów i nie jest pewne. W większości liberyjskich planów testów wystarcza bramka, bo każdy krok rejestracji lub potwierdzenia potrzebuje tylko jednego kodu.

Rozliczenia działają z jednego przedpłaconego portfela w USD bez opłaty miesięcznej. Doładowuj kartą lub w USDT/USDC, odbieraj faktury PDF e-mailem i poproś o tryb sandbox na czas budowania. Zacznij od rejestracji.

Najczęstsze pytania

Czy mogę przetestować liberyjski proces rejestracji mojej aplikacji z zagranicy?

Tak. Zamów numer +231 w OTP Gateway i ukończ weryfikację zdalnie; nie jest potrzebna żadna lokalna karta SIM.

Jakiego identyfikatora kraju API używa dla Liberii?

Użyj lr w polu country w POST /api/v1/activations oraz w zapytaniach o ceny.

Ile kosztuje liberyjski kod?

Zamówienia z Liberii zaczynają się od $0.20 za kod, a kwota zależy od usługi. Dokładną wartość zwraca GET /api/v1/prices i jest ona wyświetlana przed zamówieniem.

Co dzieje się z moim saldem, jeśli liberyjski kod nie zostanie dostarczony?

Nic nie tracisz. Zamówienie +231, które nie otrzyma SMS-a w ciągu 20 minut albo które anulujesz, jest zwracane do portfela w całości i automatycznie.

Czy mogę użyć tego samego numeru +231 w przyszłym tygodniu?

Nie. Numer z bramki służy do jednego kodu weryfikacyjnego. Linie długoterminowe istnieją tylko w USA i Kanadzie.

Odpytywać czy używać webhooków?

Webhooki mniej obciążają Twoje systemy; odpytywanie wystarcza dla skryptów. Wiele zespołów używa webhooków i wraca do odpytywania, gdy handler nie działa.

Czy jest tryb testowy, który nie obciąża mojego portfela?

Tak, na życzenie konto deweloperskie można przełączyć na sandbox, który zwraca symulowane numery i kody.

Czy są ograniczenia tego, co wolno weryfikować?

Tak: obowiązują regulaminy docelowej aplikacji oraz Acceptable Use Policy OTP Route. Numery liberyjskie służą do testowania Twojego produktu i obsługi kont, których Twoja organizacja faktycznie jest właścicielem.

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.