Weryfikacja SMS z Nikaragui (+505) dla zespołów QA i wdrożeniowych

Jak zbudowane są numery +505 i jak przechowywać je w bazie danych?

Numery nikaraguańskie mają osiem cyfr po kodzie kraju +505, a w wybieraniu krajowym nie ma prefiksu krajowego. Kanoniczna postać E.164 to więc +505 plus te osiem cyfr, nic więcej.

Subtelna pułapka ma charakter regionalny. Kostaryka (+506), Honduras (+504), Salwador (+503) i Gwatemala (+502) również używają ośmiocyfrowych numerów krajowych, więc sam ośmiocyfrowy ciąg nic nie mówi o tym, do jakiego kraju należy. Praktyczne zasady dla produktu w Ameryce Środkowej:

• Nigdy nie zapisuj numeru telefonu bez kodu kraju, nawet jeśli interfejs wstępnie go wybiera.
• Normalizuj po stronie serwera, a nie tylko w przeglądarce, aby importy i klienci API stosowali tę samą regułę.
• Dodaj numer +505 do danych testowych, aby regresja w selektorze kraju wychodziła jako nieudana asercja, a nie zgłoszenie do supportu.

W jakim języku przychodzą wiadomości weryfikacyjne w Nikaragui?

Językiem urzędowym i domyślnym dla większości użytkowników nikaraguańskich jest hiszpański, natomiast na wybrzeżu karaibskim mówi się kreolskim opartym na angielskim oraz językami rdzennymi, takimi jak miskito. Duże platformy wybierają język SMS-a na podstawie ustawień konta lub urządzenia, więc ta sama usługa może wysłać jednemu testerowi szablon hiszpański, a innemu angielski.

W lokalizacyjnym QA oznacza to sprawdzenie dwóch rzeczy: czy Twoje własne teksty hiszpańskie (latynoamerykańskie) wokół pola wpisywania kodu są poprawne oraz czy logika odczytu kodu, np. podpowiedzi autouzupełniania albo wyrażenia regularne w testach, nie zależy od angielskich słów w treści wiadomości.

Dlaczego zespoły testują lub działają na numerach z Nikaragui?

Niewiele firm startuje wyłącznie w Nikaragui; zwykle trafia ona do planu jako część wdrożenia w Ameryce Środkowej. Typowe powody, dla których zespół potrzebuje nikaraguańskiego numeru weryfikacyjnego:

• Regionalne kontrole premiery w całym przesmyku, gdzie w każdym kraju trzeba potwierdzić ścieżkę rejestracji, wyświetlanie waluty i kierowanie do wsparcia.
• Klienci mieszkający za granicą, którzy zachowują kartę SIM +505 dla rodziny i bankowości, pracując w sąsiednich krajach lub w Ameryce Północnej.
• Operacje nearshore, w których pracownicy wsparcia lub back office zarządzają kontami firmowymi, a firma woli nie wiązać tych kont z prywatnym telefonem nikogo z zespołu.
• Przeglądy onboardingu fintechów i marketplace'ów; zobacz onboarding fintech, jak zespoły organizują takie testy.

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

W OTP Gateway dla Nikaragui dostępnych jest ponad 1000 usług. Obecnie popularne to WhatsApp, Telegram, Google (Gmail i YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Uber i Discord.

Ta lista to zrzut chwilowy. Dostępność każdej pary zmienia się w ciągu dnia, dlatego API podaje ją na żywo, a nie w statycznej tabeli.

Jak wyglądają wywołania API dla kraju `ni`?

Uwierzytelniaj się w https://otproute.com/api/v1 kluczem Bearer zaczynającym się od or_live_; klucze wydaje konsola deweloperska, do 10 na konto. Identyfikator kraju dla Nikaragui to ni.

1. Raz ustal identyfikatory usług przez GET /api/v1/services i potwierdź kraj przez GET /api/v1/countries.
2. Odczytaj aktualną cenę przez GET /api/v1/prices?country=ni&service=<id> i pomiń zamówienie, jeśli usługa nie jest obecnie oferowana.
3. Złóż zamówienie: POST /api/v1/activations z {"service": "telegram", "country": "ni"}. Zachowaj zwrócony identyfikator aktywacji.
4. Przeprowadź krok weryfikacji w swojej aplikacji z numerem +505.
5. Poczekaj na zdarzenie activation.sms_received albo odpytuj GET /api/v1/activations/{id}. Niepotrzebny już test zwolnisz przez POST /api/v1/activations/{id}/cancel.

Każdy webhook zawiera X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>; zweryfikuj go jako HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu i odrzucaj żądania ze starymi znacznikami czasu. Traktuj zdarzenia jako powiązane z identyfikatorem aktywacji, aby ponowne dostarczenie było nieszkodliwe. Limit to 300 żądań na minutę i do 5 endpointów webhook. Więcej w dokumentacji deweloperskiej i w przewodniku integracji OTP API.

Test +505 z panelu i obsługa brakującego kodu

Osoby niebędące programistami zrobią to samo ręcznie: wybierz Nikaraguę i usługę, potwierdź wyświetloną cenę, skopiuj numer do aplikacji i czekaj, aż kod pojawi się na ekranie.

Aktywacja pozostaje otwarta przez 20 minut. Jeśli w tym czasie nie nadejdzie żaden SMS albo anulujesz zamówienie, cała kwota wraca na Twój portfel automatycznie; płacisz tylko za odebrane kody. Czas dostarczenia zależy od usługi i trasy. Jeśli nic się nie pojawi, poczekaj do końca okna, a potem spróbuj później lub przez inną trasę usługi, zamiast wysyłać kolejne zamówienia jedno po drugim. Sprawdź też, czy usługa akceptuje numery wirtualne w tym kroku, bo niektóre je odrzucają. Przestrzegaj regulaminu każdej usługi; obowiązuje Polityka Dopuszczalnego Użytkowania OTP Route.

Czy dostępny jest długoterminowy numer nikaraguański i jak działa płatność?

Dla Nikaragui nie istnieje samoobsługowa linia długoterminowa. Numery wirtualne dedykowane (Dedicated Virtual Numbers), od $1.95/month, są sprzedawane natychmiast wyłącznie dla Stanów Zjednoczonych i Kanady; szczegóły na stronie numerów wirtualnych. Jeśli potrzebujesz trwałej linii +505, napisz na [email protected], pamiętając, że o możliwości decydują lokalne przepisy.

Całość finansujesz z jednego przedpłaconego portfela w USD, bez planu i bez opłaty miesięcznej, doładowywanego kartą lub USDT/USDC, a po każdym doładowaniu wysyłamy e-mailem fakturę PDF. Tryb sandbox można włączyć na koncie deweloperskim na życzenie; zwraca symulowane numery i kody, dzięki czemu uruchomienia CI nie ruszają środków z portfela. Zacznij od rejestracji.

Najczęstsze pytania

Czy mogę odbierać kody SMS OTP z Nikaragui, nie będąc w Nikaragui?

Tak. OTP Gateway wydaje numer +505, z którego możesz korzystać z dowolnego miejsca, a kod pojawia się w panelu lub trafia na Twój webhook.

Jakiego identyfikatora kraju używa API dla Nikaragui?

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

Czy numer nikaraguański można pomylić z kostarykańskim lub honduraskim?

Można, jeśli przechowujesz tylko cyfry krajowe, bo sąsiednie kraje też używają numerów ośmiocyfrowych. Zawsze zapisuj pełną postać E.164 z +505.

Ile kosztuje numer weryfikacyjny z Nikaragui?

Od $0.20 za kod, w zależności od usługi. Zwrot następuje automatycznie, jeśli SMS nie dotrze w oknie 20 minut albo anulujesz zamówienie.

Czy kod przyjdzie po hiszpańsku?

Często tak, ale język wybiera usługa na podstawie ustawień konta lub urządzenia, więc testy nie powinny zakładać konkretnego brzmienia.

Czy mogę zatrzymać numer +505 na późniejsze logowania?

Nie jako produkt samoobsługowy. Dedykowane linie długoterminowe są tylko dla USA i Kanady; o Nikaraguę zapytaj, pisząc na [email protected].

Czy mogę używać OTP Route do zakładania wielu kont na jednej platformie?

Nie. Używaj go do testowania i obsługi własnych, legalnych produktów i kont, jedno na realną osobę lub firmę, zgodnie z regulaminem każdej platformy.

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.