Lanciare in Giappone senza un telefono giapponese: testare i codici +81

Perché un lancio in Giappone si blocca al passaggio del numero di telefono?

I team che preparano una release giapponese di solito hanno già finito la traduzione, collegato i metodi di pagamento e abbozzato la scheda sull'App Store. Poi qualcuno chiede chi verificherà il flusso di registrazione con un vero numero +81, e nella stanza cala il silenzio.

Il vuoto emerge in alcuni punti prevedibili:

• Il QA di localizzazione deve confermare che il campo telefono accetti i formati che gli utenti giapponesi digitano davvero, compresi i numeri scritti con i trattini.
• Il personale delle operazioni regionali a Tokyo o Osaka deve recuperare un account aziendale condiviso dopo un cambio di dispositivo, e nessuno vuole associarvi un numero personale.
• Partner e integrazioni con piattaforme giapponesi a volte richiedono un numero locale durante l'onboarding di un profilo aziendale.

L'OTP Gateway elimina la dipendenza da una SIM fisica. Ti dà un numero +81 per una verifica, raccoglie l'SMS tramite l'OTP routing sui nostri partner di rete e passa il risultato al tuo codice o al tuo browser.

Cosa posso verificare con un numero +81 per i test?

Un numero di verifica giapponese può attualmente essere ordinato per più di 1.500 servizi. Tra le rotte più scelte nell'istantanea in tempo reale ci sono LINE, X (Twitter), Amazon, Netflix, Google (Gmail & YouTube), Instagram, TikTok, Discord, Uber, Airbnb, Microsoft & Outlook, ChatGPT (OpenAI), Facebook e WhatsApp.

LINE merita una nota a parte perché è l'app di messaggistica predefinita per una larga parte della popolazione giapponese: un prodotto che offre l'accesso con LINE o le notifiche LINE vorrà coprire anche quel percorso, oltre al semplice SMS. La disponibilità cambia durante la giornata, ed è per questo che l'elenco nei tuoi strumenti dovrebbe arrivare dall'API e non da questa pagina.

Come collego l'API OTP per il Giappone a un test runner?

L'API di verifica SMS si trova su https://otproute.com/api/v1. Crea una chiave nella console Developer (inizia con or_live_), inviala come token Bearer e resta sotto le 300 richieste al minuto. Un account può avere 10 chiavi e 5 endpoint webhook.

Un'esecuzione tipica è questa:

1. Risolvi gli id una volta con GET /api/v1/services e GET /api/v1/countries; il Giappone è jp.
2. Recupera la tariffa corrente con GET /api/v1/prices?country=jp&service=<id> e salvala insieme al risultato del test.
3. Crea l'ordine con POST /api/v1/activations e il corpo {"service": "<id>", "country": "jp"}.
4. Digita il numero restituito nell'app sotto test e fai partire l'SMS.
5. Ricevi activation.sms_received sul tuo webhook, oppure fai polling su GET /api/v1/activations/{id} se il runner sta dietro un firewall.
6. Nel teardown, chiama POST /api/v1/activations/{id}/cancel per ogni attivazione che il test non richiede più.

Le richieste webhook portano X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint, confronta in modo sicuro e rifiuta i timestamp vecchi. Considera gli eventi indicizzati sull'id dell'attivazione, così un nuovo tentativo è innocuo. Per i dettagli sulla CI vedi test degli OTP SMS nelle pipeline CI e la soluzione per il QA testing.

Un non sviluppatore dell'ufficio di Tokyo può farlo da un browser?

Sì. Nella dashboard di OTP Route apri l'OTP Gateway, seleziona il Giappone e il servizio, controlla il prezzo mostrato e conferma. Il numero compare subito; quando arriva il messaggio, il codice appare accanto. Non occorre installare nulla, il che lo rende pratico per un responsabile del supporto o un marketing manager che controlla il flusso di una landing page di campagna.

Come sono formattati i cellulari giapponesi e che aspetto hanno i messaggi?

Il Giappone usa il prefisso di linea nazionale 0. I cellulari si scrivono in genere come 070, 080 o 090 seguiti da otto cifre, spesso raggruppate con trattini. In E.164 lo zero cade, quindi 090 e il resto diventano +81 90 più otto cifre. Salva solo la versione E.164, elimina trattini e spazi quando gli utenti li digitano e verifica che il tuo validatore non rifiuti la serie 070.

I messaggi di verifica arrivano spesso in giapponese, con un misto di kanji, hiragana e katakana, e alcuni contengono cifre a larghezza intera invece dei normali numeri ASCII. Passa il testo attraverso la normalizzazione Unicode NFKC prima di estrarre il codice, altrimenti un'espressione regolare per [0-9] può lasciarselo sfuggire. Il testo giapponese comporta anche che l'SMS venga inviato in una codifica Unicode, quindi tieni i log in UTF-8 per poter leggere gli errori in seguito.

Il codice non è arrivato. Cosa possiamo provare?

Nessun arrivo significa nessun addebito: quando passano 20 minuti senza SMS, o annulli, l'intero importo viene riaccreditato automaticamente sul portafoglio. Prima di ordinare di nuovo:

• Dai tempo alla finestra: un codice che arriva in ritardo viene comunque catturato.
• Riprova dopo una pausa, oppure passa a un'altra rotta per lo stesso servizio.
• Controlla se il servizio accetta numeri virtuali, perché alcuni li rifiutano.
• Evita di rifare l'ordine in un ciclo rapido dall'automazione; distanzia i tentativi.

L'articolo sul routing dei paesi per gli OTP spiega perché le rotte differiscono.

Esiste una linea giapponese a lungo termine e come si fattura il portafoglio?

OTP Route non offre un numero giapponese a lungo termine in self-service. I Dedicated Virtual Numbers sono un prodotto per Stati Uniti e Canada da $1.95/month; se una linea +81 duratura è essenziale, scrivi a [email protected] e il team verificherà cosa consentono le norme locali, senza alcuna promessa che sia possibile.

Il pagamento passa da un unico portafoglio prepagato in USD: nessun abbonamento e nessun piano. Ricarichi con carta o con USDT/USDC e per ogni ricarica arriva una fattura PDF via email. Su richiesta, un account di sviluppo può funzionare in modalità sandbox con numeri e codici simulati. Consulta la pagina dei prezzi per le cifre aggiornate.

Domande frequenti

Posso ricevere OTP SMS dal Giappone senza una SIM giapponese?

Sì. L'OTP Gateway assegna un numero +81 per una verifica e mostra il codice nella dashboard o lo invia al tuo webhook.

Quale id paese invio per il Giappone nelle chiamate API?

Usa jp nel corpo dell'attivazione e nella query dei prezzi.

Perché il mio parser non trova i codici nei messaggi giapponesi?

Il messaggio potrebbe usare cifre a larghezza intera. Applica la normalizzazione NFKC prima del confronto e il codice verrà riconosciuto da un normale schema di cifre.

I numeri 090 vanno salvati con lo zero iniziale?

No. Salva +81 seguito dal numero senza lo zero di linea, ad esempio +81 90 e le restanti otto cifre.

Che fine fa il mio denaro se non arriva nessun codice di verifica giapponese?

Torna automaticamente sul portafoglio quando termina la finestra di 20 minuti o quando annulli l'attivazione.

Possiamo testare le registrazioni LINE per il mercato giapponese?

LINE compare tra i servizi disponibili per il Giappone, anche se la disponibilità cambia. Controlla l'elenco in tempo reale e rispetta i termini di LINE per ogni account che crei.

Esiste una regola su come si possono usare i numeri?

Sì. Usali solo per i tuoi prodotti e account legittimi, rispetta i termini di ogni servizio e ricorda che si applica la Acceptable Use Policy di OTP Route.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.