Odbieranie kodów SMS OTP z Nepalu: przygotowanie, kroki i poprawki dla testów +977

Przed startem: co trzeba mieć gotowe, zanim zamówisz numer z Nepalu?

Krótkie przygotowanie oszczędza później mnóstwo mylącego debugowania. Przed pierwszym zamówieniem upewnij się, że masz:

1. Dane uwierzytelniające. Wygeneruj klucz or_live_ w konsoli deweloperskiej i wysyłaj go jako token Bearer. Osobne klucze dla lokalnego rozwoju, CI i narzędzi produkcyjnych ułatwiają rotację.
2. Identyfikatory kraju i usługi. Nepal to np; identyfikator usługi znajdziesz przez GET /api/v1/services.
3. Środki lub sandbox. Sprawdź GET /api/v1/balance albo poproś o przełączenie konta deweloperskiego w tryb sandbox, aby symulowane numery i kody sprawdzały integrację za darmo.
4. Sposób dostarczania. Wybierz między endpointem webhooka a odpytywaniem, zanim napiszesz narzędzie testowe, a nie w jego połowie.
5. Podgląd skrzynki obsługujący Unicode. Kody z nepalskich szablonów przychodzą w dewanagari, a Twoje logi powinny wyświetlać je poprawnie.

Jeśli ten model jest dla Ciebie nowy, artykuł czym jest brama OTP wyjaśni tło w kilka minut.

Które aplikacje mogą dostarczać kody na linię +977?

Do Nepalu można obecnie kierować ponad 1700 usług. Wśród popularnych są Viber, WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, Signal, imo, Amazon i Claude.

Ta lista to zrzut, a nie obietnica. Dostępność zmienia się w ciągu dnia, dlatego GET /api/v1/prices?country=np&service=<id> zwraca aktualną cenę i dostępność dla dokładnie tej pary, której potrzebuje Twój test.

Krok po kroku: odbiór SMS OTP z Nepalu przez API

Po przygotowaniu wszystkiego z listy przepływ API OTP dla Nepalu zajmuje najwyżej pięć wywołań:

1. Potwierdź aktualną cenę dla np i Twojej usługi.
2. Utwórz aktywację przez POST /api/v1/activations z treścią {"service": "<id>", "country": "np"}. Zachowaj zwrócony identyfikator aktywacji; to on spina wszystko, co następuje dalej.
3. Wpisz numer +977 w testowanym przepływie i wywołaj wysłanie SMS-a.
4. Odbierz kod z webhooka activation.sms_received albo odpytuj GET /api/v1/activations/{id} z rozsądnym odstępem między wywołaniami.
5. Anuluj przez POST /api/v1/activations/{id}/cancel, jeśli test zostanie przerwany wcześniej.

Po stronie webhooka przed zaufaniem żądaniu zweryfikuj X-OTPRoute-Signature: zbuduj <t>.<raw body>, podpisz HMAC-SHA256 sekretem endpointu, porównaj z v1 i odrzucaj przestarzałe znaczniki czasu. Potem zapisuj wynik po identyfikatorze aktywacji, aby ponownie dostarczone zdarzenie nie wyrządziło szkody. Przechwytywanie OTP przez webhooki pokazuje pełny wzorzec.

Wolisz klikać niż kodować? W panelu OTP Route wybierz Nepal, wybierz usługę, zaakceptuj wyświetloną cenę, a numer pojawi się z licznikiem czasu; kod pokaże się na tym samym ekranie.

Kontrole formatu nepalskich numerów komórkowych

Nepalskie numery komórkowe mają dziesięć cyfr i zaczynają się od 9, najczęściej od 98 lub 97. W kraju numery stacjonarne wybiera się z prefiksem 0 i numerem strefy, ale to 0 nigdy nie należy do formatu międzynarodowego. Rekord testowy powinien więc wyglądać jak +97798xxxxxxxx.

Rzeczy warte sprawdzenia w testach walidacji:

• Użytkownik, który wpisze numer z wiodącym 0, ma po +977 zero usunięte.
• Dziesięciocyfrowy numer komórkowy bez żadnego prefiksu jest akceptowany i normalizowany do E.164.
• Spacje i myślniki wklejone z kart kontaktów są czyszczone przed zapisem.

Treść SMS-a też wymaga sprawdzenia. Nepalski zapisuje się w dewanagari, a wiadomość w dewanagari jest wysyłana jako Unicode, co pozwala na dużo mniej znaków w segmencie niż zwykły tekst łaciński. Jeśli Twój szablon weryfikacyjny jest zlokalizowany, upewnij się, że kod nadal mieści się w jednym segmencie i nie zostaje wypchnięty za podział przez otaczające słowa. Wiele usług wysyła po prostu szablony angielskie, więc testuj oba warianty.

Dlaczego zespoły budują i testują produkty na rynek nepalski

Nepal znaczy dla większej liczby produktów, niż sugeruje jego wielkość. Duża część nepalskich pracowników mieszka za granicą, więc produkty przekazów pieniężnych, portfeli i komunikatorów obsługujące Zatokę Perską, Malezję i inne korytarze często muszą weryfikować użytkowników, którzy nadal mają numer +977. Komunikatory, takie jak Viber i WhatsApp, są tam częścią codziennej komunikacji.

Zespoły zamawiają numer +977 do testów, gdy:

• Uruchamiają rejestrację dla użytkowników z Nepalu i muszą udowodnić, że kraj pojawia się na liście z właściwą maską.
• Sprawdzają nepalskie ciągi tekstowe na ekranach wdrożenia i odzyskiwania konta.
• Odtwarzają zgłoszenie klienta z diaspory, że kod logowania nigdy nie przyszedł.

Strona o weryfikacji aplikacji mobilnych pokazuje, jak zespoły aplikacji organizują takie pokrycie krajów.

Rozwiązywanie problemów: kod nie dotarł

Brakujące kody mają kilka typowych przyczyn, a rozwiązaniem rzadko jest natychmiastowe ponowne zamówienie.

• Najpierw cierpliwość. Daj aktywacji pełne 20 minut; wiadomości w kolejce potrafią dotrzeć z opóźnieniem.
• Zasady dotyczące numerów wirtualnych. Niektóre usługi odrzucają numery wirtualne. Wtedy aktywacja po prostu wygasa, a zwrot trafia do portfela.
• Wybór trasy. Spróbuj później albo użyj innej trasy dla tej samej usługi, zamiast bombardować jedną.
• Dyscyplina żądań. Zamawianie w ciasnej pętli zużywa limit 300 żądań na minutę i rzadko pomaga.
• Twoja własna aplikacja. Upewnij się, że żądanie wysłania SMS-a faktycznie wyszło; sprawdź wychodzące żądanie w logach.

Zdarzenie activation.expired to czysty sygnał, że nic nie przyszło i nic nie zostało naliczone.

Linie długoterminowe i płatności za trasy do Nepalu

OTP Route nie oferuje samoobsługowego numeru długoterminowego dla Nepalu. Numery Dedykowane istnieją tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/month. Jeśli Twój zespół potrzebuje trwałej linii +977, napisz na [email protected]; to, czy cokolwiek da się załatwić, zależy od lokalnych przepisów i nic nie jest pewne.

Płatności działają w modelu płatności za użycie z jednego przedpłaconego portfela w USD, doładowywanego kartą lub w USDT czy USDC, z fakturą PDF wysyłaną e-mailem za każde doładowanie i bez opłaty miesięcznej. Zobacz cennik, by poznać sposób prezentacji opłat, i załóż konto za pomocą kodu z e-maila lub Google.

Najczęstsze pytania

Czy mogę odebrać nepalski OTP bez nepalskiej karty SIM?

Tak. OTP Gateway wydaje numer +977 do pojedynczej weryfikacji, a kod odczytasz w panelu lub przez API.

Jakiego kodu kraju oczekuje API dla Nepalu?

Wysyłaj np jako kraj w zapytaniach o ceny i w żądaniach aktywacji.

Czy przy zapisie numeru z Nepalu zachować wiodące 0?

Nie. Odrzuć zero prefiksu krajowego i zapisz numer w E.164 po +977.

Czy kody z nepalskich szablonów wyświetlą się poprawnie w panelu?

Wiadomość jest pokazywana tak, jak została odebrana; upewnij się, że Twoje logi i asercje testowe obsługują tekst w dewanagari, aby kod dało się niezawodnie wyciągnąć.

Co dzieje się z moimi pieniędzmi, jeśli kod z Nepalu nie przyjdzie?

Nic nie jest pobierane: aktywacja, w której w ciągu 20 minut nie pojawi się SMS, albo anulowana przez Ciebie, jest w całości zwracana do portfela bez żadnego wniosku z Twojej strony.

Czy mogę użyć tego samego numeru +977 do późniejszego logowania?

Nie, każdy numer z OTP Gateway obsługuje jeden kod. Dla kont, które muszą logować się ponownie, odpowiedni jest Numer Dedykowany, ale takie oferujemy tylko w USA i Kanadzie.

Czy istnieją zasady korzystania z numerów weryfikacyjnych z Nepalu?

Tak. Przestrzegaj regulaminów usług i Zasad Dozwolonego Użytku (Acceptable Use Policy) oraz używaj numerów wyłącznie do testowania lub obsługi własnych, legalnych produktów i kont.

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.