Premiera w Japonii bez japońskiego telefonu: testowanie kodów +81

Dlaczego japońska premiera zatrzymuje się na kroku z numerem telefonu?

Zespoły przygotowujące japońskie wydanie mają zwykle gotowe tłumaczenie, podpięte metody płatności i szkic wpisu w App Store. Potem ktoś pyta, kto zweryfikuje proces rejestracji prawdziwym numerem +81, i w pokoju robi się cicho.

Ta luka ujawnia się w kilku przewidywalnych miejscach:

• QA lokalizacji musi potwierdzić, że pole telefonu akceptuje formaty, które japońscy użytkownicy faktycznie wpisują, w tym numery z łącznikami.
• Zespoły operacyjne regionu w Tokio lub Osace muszą odzyskać wspólne konto firmowe po zmianie urządzenia, a nikt nie chce podpinać do niego prywatnego numeru.
• Partnerzy i integracje z japońskimi platformami czasem wymagają lokalnego numeru podczas wdrażania profilu firmowego.

OTP Gateway usuwa zależność od fizycznej karty SIM. Daje numer +81 do jednej weryfikacji, zbiera SMS przez routing OTP u naszych partnerów operatorskich i przekazuje wynik do Twojego kodu lub przeglądarki.

Co mogę zweryfikować na numerze +81 do testów?

Japoński numer weryfikacyjny można obecnie zamówić dla ponad 1500 usług. Do popularnych tras w aktualnym zestawieniu należą LINE, X (Twitter), Amazon, Netflix, Google (Gmail & YouTube), Instagram, TikTok, Discord, Uber, Airbnb, Microsoft & Outlook, ChatGPT (OpenAI), Facebook i WhatsApp.

LINE zasługuje na osobną uwagę, bo to domyślny komunikator dla dużej części mieszkańców Japonii, więc produkt oferujący logowanie przez LINE lub powiadomienia LINE powinien mieć pokrytą także tę ścieżkę, a nie tylko zwykły SMS. Dostępność zmienia się w ciągu dnia, dlatego lista w Twoich narzędziach powinna pochodzić z API, a nie z tej strony.

Jak wpiąć Japan OTP API w narzędzie do testów?

API weryfikacji SMS działa pod adresem https://otproute.com/api/v1. Utwórz klucz w konsoli Developer (zaczynają się od or_live_), wysyłaj go jako token Bearer i trzymaj się poniżej 300 żądań na minutę. Jedno konto może mieć 10 kluczy i 5 endpointów webhooków.

Typowy przebieg wygląda tak:

1. Raz zamień nazwy na identyfikatory przez GET /api/v1/services i GET /api/v1/countries; Japonia to jp.
2. Pobierz aktualną stawkę przez GET /api/v1/prices?country=jp&service=<id> i zapisz ją razem z wynikiem testu.
3. Utwórz zamówienie przez POST /api/v1/activations z ciałem {"service": "<id>", "country": "jp"}.
4. Wpisz zwrócony numer w testowanej aplikacji i wywołaj wysłanie SMS-a.
5. Odbierz activation.sms_received na swoim webhooku albo odpytuj GET /api/v1/activations/{id}, jeśli runner znajduje się za zaporą.
6. Przy porządkowaniu wywołaj POST /api/v1/activations/{id}/cancel dla każdej aktywacji, której test już nie potrzebuje.

Żądania webhooków niosą X-OTPRoute-Signature: t=<unix>,v1=<hex>. Oblicz ponownie HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w bezpieczny sposób i odrzucaj stare znaczniki czasu. Traktuj zdarzenia jako identyfikowane przez identyfikator aktywacji, aby ponowienie było nieszkodliwe. Szczegóły dotyczące CI znajdziesz w testowaniu SMS OTP w potokach CI oraz w rozwiązaniu do testów QA.

Czy osoba nietechniczna z biura w Tokio zrobi to z przeglądarki?

Tak. W panelu OTP Route otwórz OTP Gateway, wybierz Japonię i usługę, sprawdź wyświetloną cenę i potwierdź. Numer pojawia się od razu; gdy nadejdzie wiadomość, kod pojawi się obok niego. Nic nie trzeba instalować, co sprawdza się u lidera supportu czy menedżera marketingu, który weryfikuje ścieżkę kampanii.

Jak formatuje się japońskie numery komórkowe i jak wyglądają wiadomości?

Japonia używa krajowego prefiksu 0. Numery komórkowe zapisuje się zazwyczaj jako 070, 080 lub 090 i osiem cyfr, często grupowanych łącznikami. W E.164 zero znika, więc 090 i reszta staje się +81 90 plus osiem cyfr. Zapisuj tylko wersję E.164, usuwaj łączniki i spacje, gdy użytkownicy je wpisują, i upewnij się, że walidator nie odrzuca zakresu 070.

Wiadomości weryfikacyjne często przychodzą po japońsku, mieszając kanji, hiraganę i katakanę, a niektóre zawierają cyfry pełnoszerokie zamiast zwykłych cyfr ASCII. Przed wyodrębnieniem kodu przepuść tekst przez normalizację Unicode NFKC, bo inaczej wyrażenie dla [0-9] może go po cichu przeoczyć. Japoński tekst oznacza też, że SMS jest wysyłany w kodowaniu Unicode, więc trzymaj logi w UTF-8, aby później odczytać błędy.

Kod się nie pojawił. Co spróbować?

Brak dostarczenia oznacza brak opłaty: gdy minie 20 minut bez SMS-a lub anulujesz zamówienie, cała kwota wraca automatycznie do portfela. Zanim zamówisz ponownie:

• Daj oknu czas; kod, który przychodzi z opóźnieniem, nadal zostanie przechwycony.
• Spróbuj po przerwie albo przełącz się na inną trasę dla tej samej usługi.
• Sprawdź, czy usługa w ogóle akceptuje numery wirtualne, bo niektóre je odrzucają.
• Unikaj ponownych zamówień w szybkiej pętli z automatu; rozstaw próby w czasie.

Artykuł o routingu krajowym dla OTP wyjaśnia, dlaczego trasy się różnią.

Czy jest długoterminowa japońska linia i jak rozlicza się portfel?

OTP Route nie oferuje samoobsługowego długoterminowego numeru japońskiego. Dedykowane Numery wirtualne to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/month; jeśli długoterminowa linia +81 jest niezbędna, napisz na [email protected], a zespół sprawdzi, na co pozwalają lokalne przepisy, bez obietnicy, że będzie to możliwe.

Płatności przechodzą przez jeden przedpłacony portfel w USD: bez abonamentu i bez planu. Doładuj kartą lub USDT/USDC, a faktura PDF przychodzi e-mailem po każdym doładowaniu. Na prośbę konto deweloperskie może działać w trybie sandbox z symulowanymi numerami i kodami. Aktualne stawki znajdziesz na stronie z cennikiem.

Najczęstsze pytania

Czy mogę odbierać japońskie kody SMS OTP bez japońskiej karty SIM?

Tak. OTP Gateway wydaje numer +81 do jednej weryfikacji i pokazuje kod w panelu albo wysyła go na Twój webhook.

Jaki identyfikator kraju wysyłać dla Japonii w wywołaniach API?

Użyj jp w ciele aktywacji i w zapytaniu o ceny.

Dlaczego mój parser pomija kody w japońskich wiadomościach?

Wiadomość może używać cyfr pełnoszerokich. Zastosuj normalizację NFKC przed dopasowaniem, a kod zostanie dopasowany zwykłym wzorcem cyfr.

Czy numery 090 zapisywać z początkowym zerem?

Nie. Zapisz +81 i numer bez zera prefiksu, na przykład +81 90 i pozostałe osiem cyfr.

Co dzieje się z moimi pieniędzmi, jeśli japoński kod weryfikacyjny nie dotrze?

Wracają automatycznie do portfela, gdy minie 20-minutowe okno albo anulujesz aktywację.

Czy możemy testować rejestracje przez LINE na rynek japoński?

LINE znajduje się wśród usług dostępnych dla Japonii, choć dostępność się zmienia. Sprawdź listę na żywo i przestrzegaj regulaminu LINE dla każdego zakładanego konta.

Czy są zasady dotyczące sposobu korzystania z tych numerów?

Tak. Używaj ich wyłącznie do własnych produktów i legalnych kont, przestrzegaj regulaminów usług i pamiętaj, że obowiązują Zasady dopuszczalnego użytkowania 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.