Testowanie rejestracji w Mozambiku, gdy nikt w zespole nie ma karty SIM +258

Nasze wdrożenie w Mozambiku utknęło na weryfikacji telefonu. Od czego zacząć?

Znana historia: aplikacja jest przetłumaczona, ekrany płatności gotowe, a ostatnie otwarte zgłoszenie mówi, że ktoś musi potwierdzić, iż klient z Mozambiku faktycznie dokończy rejestrację. Nikt nie ma karty SIM +258, roaming trudno zorganizować, a prywatny telefon kolegi nie jest elementem środowiska testowego.

OTP Gateway usuwa tę zależność. Zamawiasz numer +258 do jednej konkretnej usługi, używasz go raz na testowanym ekranie, a przychodzący kod wraca do Ciebie. Sprawdza się w QA i automatyzacji testów, na listach kontrolnych przed startem oraz w zespołach wsparcia, które odtwarzają zgłoszenie klienta bez pożyczania cudzego telefonu.

Jak wygląda numer +258 i jak go przechowywać?

Numer kierunkowy Mozambiku to +258, a numery krajowe mają dziewięć cyfr i nie ma zera wiodącego do usunięcia, więc forma lokalna i międzynarodowa różnią się tylko kodem kraju. Numery komórkowe zaczynają się od 8. W praktyce oznacza to:

• Zapisuj formę E.164, czyli +258 i dziewięć cyfr, a formatuj ją do wyświetlenia osobno.
• Odrzucaj wpisy, w których ktoś dodał zero z przyzwyczajenia z innych rynków, albo po cichu usuwaj je przed walidacją.
• Zachowuj kod kraju nawet dla użytkowników, którzy wybierają tylko numery lokalne; nadawca SMS i każdy odbiorca webhooka go potrzebuje.

Językiem urzędowym jest portugalski, więc wiadomości mogą przychodzić po portugalsku lub po angielsku, w zależności od usługi i ustawień regionalnych konta. Jeśli Twoje szablony są po portugalsku, sprawdź, jak wyświetlają się znaki z akcentami, takie jak ç i ã, bo tekst spoza ASCII zmienia kodowanie SMS i może podzielić wiadomość na więcej części.

Które usługi mogą wysłać kod na numer weryfikacyjny z Mozambiku?

Zrzut dla Mozambiku liczy łącznie ponad 1600 usług. Często zamawiane to WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, Netflix, Airbnb, Discord i Claude.

Dostępność jest na żywo, a nie stała: ta sama usługa może o jednej godzinie być dobrze zaopatrzona, a później mieć braki. Odczytuj ją z API lub z panelu przed każdym zamówieniem, zamiast wpisywać listę na sztywno do planu testów.

Jak działa przepływ API OTP dla Mozambiku od początku do końca?

Dla programistów integracja to krótka sekwencja wywołań do https://otproute.com/api/v1, podpisanych kluczem Bearer zaczynającym się od or_live_:

1. Ustal identyfikator Mozambiku (mz) i identyfikator usługi z GET /api/v1/countries i GET /api/v1/services.
2. Sprawdź GET /api/v1/prices?country=mz&service=<id>, aby poznać aktualną cenę i to, czy numery są dostępne.
3. Wyślij POST /api/v1/activations z {"service": "telegram", "country": "mz"} i zachowaj zwrócony identyfikator aktywacji oraz numer.
4. Odbierz kod, gdy activation.sms_received trafi na Twój endpoint, albo odpytuj GET /api/v1/activations/{id} co kilka sekund.
5. Wywołaj POST /api/v1/activations/{id}/cancel, jeśli test zostanie porzucony.

Żądania webhooków niosą nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>), czyli HMAC-SHA256 z <t>.<raw body> z kluczem sekretu Twojego endpointu. Zweryfikuj go, odrzucaj stare znaczniki czasu i uczyń obsługę idempotentną względem identyfikatora aktywacji. Klucze tworzy się w konsoli deweloperskiej (do 10, plus 5 endpointów webhooków), a limit to 300 żądań na minutę. Przewodnik po integracji API OTP pokazuje ten sam przepływ API weryfikacji SMS wraz z obsługą błędów.

Czy osoba nietechniczna zamówi numer +258 z panelu?

Tak, i korzysta on z dokładnie tego samego routingu OTP co API. Po założeniu konta za pomocą e-maila i 6-cyfrowego kodu (lub Google) doładuj środki, otwórz OTP Gateway, wybierz Mozambik i usługę, a następnie potwierdź wyświetloną cenę. Numer pojawia się od razu; wklej go w aplikacji, a kod zostanie pokazany na tej samej stronie, gdy dotrze. Dla samego konta dostępne jest logowanie dwuskładnikowe z aplikacją uwierzytelniającą.

Dlaczego kod nie dotarł i co spróbować dalej?

Każda aktywacja ma 20-minutowe okno. Jeśli zamknie się bez SMS-a albo anulujesz zamówienie, cała kwota wraca automatycznie do portfela; płacisz tylko wtedy, gdy kod dotrze.

Jeśli kolejne próby wciąż kończą się pustym wynikiem:

• Daj oknu czas. Szybkość dotarcia kodu zależy od usługi i trasy.
• Sprawdź, czy ta usługa akceptuje numery wirtualne; niektóre odrzucają je od razu.
• Spróbuj ponownie po przerwie albo wybierz inną trasę, jeśli test nie wymaga akurat numeru z Mozambiku.
• Rozkładaj próby w czasie zamiast bombardować endpoint zamówień i zapisuj identyfikator każdej aktywacji, by móc porównywać niepowodzenia.

Czy istnieje stała linia mozambicka i jak się ją rozlicza?

Dla Mozambiku nie ma samoobsługowego numeru długoterminowego. Linie dedykowane sprzedajemy wyłącznie dla Stanów Zjednoczonych i Kanady, od $1.95/month. Zespoły potrzebujące stałej linii mozambickiej mogą napisać na [email protected]; możliwość zależy od lokalnych przepisów i może się okazać niemożliwa.

Płatności idą z jednego przedpłaconego portfela w USD, w modelu płatności za użycie, bez abonamentu. Akceptujemy doładowania kartą oraz stablecoinami USDT/USDC, a po każdym przychodzi faktura PDF e-mailem. Na czas budowy i debugowania konto deweloperskie można na życzenie przełączyć w tryb sandbox, aby symulowane numery i kody przepływały przez Twój kod bez wydawania środków. Jak pokazywane są stawki, opisuje cennik.

Najczęstsze pytania

Czy mogę przetestować rejestrację w Mozambiku spoza tego kraju?

Tak. Numer +258 pochodzi z OTP Gateway, więc zespół może przeprowadzić test z dowolnego miejsca i odczytać kod w panelu lub przez API.

Jaki jest identyfikator kraju dla Mozambiku w API?

Użyj mz w GET /api/v1/prices oraz w treści POST /api/v1/activations.

Czy numery mozambickie wymagają zera na początku?

Nie. Mozambik nie ma krajowego prefiksu, więc zapisywana forma to po prostu +258 i dziewięć cyfr.

Ile kosztuje odebranie kodu OTP SMS z Mozambiku?

Kody zaczynają się od $0.20 za kod, a dokładną cenę każdej usługi zwraca na żywo API i pokazuje panel przed zamówieniem.

Czy testowy numer +258 będzie działał do logowania w przyszłym tygodniu?

Lepiej zakładaj, że nie. Numer z OTP Gateway służy do jednego kodu, a długoterminowe numery dedykowane oferujemy tylko w USA i Kanadzie.

Czy obowiązują zasady dotyczące tego, co możemy weryfikować tymi numerami?

Tak. Używaj ich wyłącznie do testowania i obsługi własnych, legalnych produktów i kont, przestrzegaj regulaminów usług i Zasad Dozwolonego Użytku (Acceptable Use Policy) 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.