Wybór trasy +55 do weryfikacji SMS w Brazylii

Czy test dla Brazylii powinien używać OTP Gateway, czy linii długoterminowej?

Zacznij od charakteru zadania, bo to ono rozstrzyga o produkcie. Brazylijski test weryfikacji zwykle potrzebuje jednego kodu, jednorazowo: ekran rejestracji po portugalsku, wyzwanie logowania, krok zmiany telefonu. Do tego właśnie służy OTP Gateway. Wybierasz usługę i Brazylię, dostajesz numer +55 na jeden kod, a aktywacja zamyka się po 20 minutach albo gdy nadejdzie SMS.

Linia długoterminowa to zupełnie inna historia. Numery Dedykowane to produkt dla Stanów Zjednoczonych i Kanady, sprzedawany natychmiast z panelu od $1.95/month, z przychodzącymi i wychodzącymi SMS-ami oraz dzwonieniem z przeglądarki. Nie ma samoobsługowego, długoterminowego numeru +55. Jeśli zespół naprawdę potrzebuje brazylijskiej linii na stałe, napisz na [email protected] i opisz przypadek użycia; to, czy cokolwiek jest możliwe, zależy od lokalnych przepisów i niczego nie obiecujemy.

Szybka reguła kciuka:

• Jeden kod na przypadek testowy, świeży stan przy każdym przebiegu: OTP Gateway z br.
• Konto stagingowe, na które trzeba zalogować się za miesiąc: numer dedykowany z USA lub Kanady, jeśli usługa go akceptuje.
• Masz wątpliwości: przeczytaj numery tymczasowe a dedykowane, zanim cokolwiek kupisz.

Jakie aplikacje mogą teraz wysyłać kody na numer brazylijski?

Trasa brazylijska obejmuje obecnie ponad 2900 usług, a do popularnych w bieżącym zrzucie należą WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee i AliExpress.

Traktuj tę listę jako zrzut stanu, a nie umowę. Dostępność zmienia się w ciągu dnia, gdy nasi partnerzy operatorscy dodają i rotują trasy, więc pipeline powinien pytać API, a nie ufać liście wpisanej na stałe. Katalog krajów pokazuje te same dane na żywo dla osób, które wolą przeglądarkę.

Jak wygląda sekwencja API OTP dla Brazylii w praktyce?

Każde wywołanie trafia na https://otproute.com/api/v1 z kluczem Bearer o prefiksie or_live_, wygenerowanym w konsoli deweloperskiej. Identyfikator kraju Brazylii to br.

1. Jednorazowo pobierz identyfikatory usług przez GET /api/v1/services i trzymaj je w konfiguracji.
2. Przed zamówieniem wywołaj GET /api/v1/prices?country=br&service=whatsapp (lub identyfikator Twojej usługi). Odpowiedź zawiera aktualną cenę i dostępność dla tej pary.
3. Utwórz aktywację przez POST /api/v1/activations z treścią {"service": "whatsapp", "country": "br"}. Zapisz identyfikator aktywacji obok przebiegu testu.
4. Wpisz numer +55 w testowanym procesie.
5. Nasłuchuj zdarzenia activation.sms_received na webhooku; jako rezerwę sprawdzaj GET /api/v1/activations/{id} co kilka sekund.
6. Jeśli test zostanie przerwany, zwolnij numer przez POST /api/v1/activations/{id}/cancel, aby środki wróciły natychmiast.

Dostawy webhooków są podpisane w X-OTPRoute-Signature jako t=<unix>,v1=<hex>: HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu. Zweryfikuj go, odrzucaj przeterminowane znaczniki czasu i uczyń obsługę idempotentną względem identyfikatora aktywacji. Pełna dokumentacja jest w dokumentacji API.

Czy osoba z zespołu growth może to zrobić bez kodu?

Tak. Panel realizuje ten sam routing OTP bez żadnych skryptów:

1. Załóż konto za pomocą e-maila i 6-cyfrowego kodu e-mail albo logowania Google.
2. Dodaj środki do portfela w USD.
3. Wybierz Brazylię i usługę, sprawdź pokazaną cenę i zamów.
4. Wklej numer +55 do aplikacji i obserwuj, jak kod pojawia się na karcie aktywacji.

Osoby z marketingu, supportu i weryfikacji lokalizacji często korzystają z tej ścieżki, by przed wydaniem potwierdzić, że portugalski ekran wdrożenia działa, podczas gdy inżynierowie zostawiają API do przebiegów automatycznych.

Jak przechowywać i normalizować numery +55?

Brazylijskie numery mają dwucyfrowy numer kierunkowy (DDD), po którym następuje numer abonenta, a numery komórkowe mają dziewięć cyfr zaczynających się od 9. W Brazylii przy połączeniach międzymiastowych wybiera się początkowe 0 oraz kod wyboru operatora, dlatego dane wpisane przez użytkownika często zawierają dodatkowe cyfry, które nie należą do zapisu.

Przechowuj wszystko w E.164: +55, numer kierunkowy, a potem numer abonenta, bez spacji, bez początkowego 0 i bez kodu operatora. Normalizuj przy wprowadzaniu, porównuj wartość znormalizowaną, a formatuj tylko do wyświetlania. Kody od brazylijskich nadawców zwykle przychodzą po portugalsku, czasem po angielsku, więc analizuj cyfry, zamiast dopasowywać stałe zdanie.

Zespoły testują ten rynek przy starcie w Brazylii, testach lokalizacji na portugalski i procesach wdrożeniowych, które idą w parze z obowiązkami wynikającymi z brazylijskiej ustawy o ochronie danych, LGPD. Strona o onboardingu fintech omawia weryfikacyjną część tej pracy.

Co zrobić, gdy brazylijski kod się nie pojawia?

Najpierw pozwól oknu 20 minut dobiec końca; niektórzy nadawcy są wolniejsi, a dostawa zależy od usługi i trasy. Jeśli okno wygaśnie, opłata jest cofana automatycznie i możesz spróbować ponownie nieco później albo inną trasą z listy API.

• Sprawdź, czy usługa w ogóle akceptuje numery wirtualne. Niektóre nie, i właśnie dlatego istnieje reguła zwrotu.
• Nie zamawiaj ponownie w ciasnej pętli. Rób przerwy między próbami i loguj każdy identyfikator aktywacji.
• Upewnij się, że aplikacja wysłała numer w pełnej formie międzynarodowej, a nie w formacie lokalnym z cyframi prefiksu.

Poradnik o ograniczaniu nieudanych dostaw OTP zawiera więcej wskazówek diagnostycznych.

Jak współgrają portfel, faktury i sandbox?

OTP Route rozlicza się z jednego przedpłaconego portfela w USD: pay as you go, bez opłaty miesięcznej i bez wyboru planu. Zasilisz go kartą lub USDT albo USDC, a każde doładowanie przychodzi z fakturą PDF e-mailem. Pełne stawki znajdziesz na stronie cennika i w API.

Do prac integracyjnych poproś support o przełączenie konta deweloperskiego w tryb sandbox. Zwraca on symulowane numery i kody, więc możesz przećwiczyć ścieżkę aktywacji i webhooków od początku do końca bez dotykania środków portfela. Używaj go wyłącznie do własnych produktów, przestrzegaj regulaminów poszczególnych usług i pamiętaj, że do każdego konta stosują się Zasady dopuszczalnego użytku.

Najczęstsze pytania

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

Tak. Zamów numer +55 w OTP Gateway dla własnej aplikacji lub obsługiwanej usługi, wpisz go w procesie i odczytaj kod w panelu lub przez API.

Jaki jest identyfikator kraju Brazylii w API OTP Route?

To br. Podaj go jako pole country przy tworzeniu aktywacji albo jako parametr zapytania country w endpointcie cen.

Czy zapłacę, jeśli WhatsApp nigdy nie wyśle kodu na mój numer +55?

Nie. Jeśli w ciągu 20 minut żaden SMS nie dotrze na numer albo wcześniej anulujesz, pełna kwota automatycznie wraca na portfel.

Czy mogę kupić numer brazylijski i zatrzymać go na miesiące?

Nie jako produkt samoobsługowy. Długoterminowe Numery Dedykowane są sprzedawane tylko dla Stanów Zjednoczonych i Kanady; w sprawie Brazylii możesz napisać na [email protected], bez obietnicy dostępności.

Czy zapisywać początkowe zero z numeru brazylijskiego?

Nie. Usuń prefiks 0 i ewentualny kod wyboru operatora, a potem zapisz numer w formacie E.164 zaczynającym się od +55 i dwucyfrowego numeru kierunkowego.

W jakim języku są brazylijskie wiadomości weryfikacyjne?

Większość przychodzi po portugalsku, a niektóre globalne usługi wysyłają tekst po angielsku. Wyciągaj kod liczbowy, zamiast polegać na brzmieniu.

Czy mogę wypróbować API, zanim zasilę portfel?

Poproś o tryb sandbox na koncie deweloperskim. Symuluje numery i kody, więc całą integrację można przetestować bez wydawania środków z portfela.

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.