Lançando no Japão sem um celular japonês: como testar códigos +81

Por que um lançamento japonês trava na etapa do número de telefone?

As equipes que preparam uma versão japonesa costumam ter a tradução pronta, os meios de pagamento integrados e a ficha da App Store redigida. Aí alguém pergunta quem vai verificar o fluxo de cadastro com um número +81 de verdade, e a sala fica em silêncio.

A lacuna aparece em alguns pontos previsíveis:

• O QA de localização precisa confirmar que o campo de telefone aceita os formatos que os usuários japoneses realmente digitam, inclusive números escritos com hifens.
• A equipe de operações regionais em Tóquio ou Osaka precisa recuperar uma conta empresarial compartilhada depois de uma troca de aparelho, e ninguém quer colocar um número pessoal nela.
• Parceiros e integrações com plataformas japonesas às vezes exigem um número local no onboarding de um perfil empresarial.

O OTP Gateway elimina a dependência de um chip físico. Ele entrega um número +81 para uma verificação, coleta o SMS por meio do roteamento OTP dos nossos parceiros de operadora e passa o resultado ao seu código ou ao seu navegador.

O que posso verificar em um número +81 para testes?

Hoje é possível pedir um número de verificação do Japão para mais de 1.500 serviços. Entre as rotas populares no retrato atual estão LINE, X (Twitter), Amazon, Netflix, Google (Gmail & YouTube), Instagram, TikTok, Discord, Uber, Airbnb, Microsoft & Outlook, ChatGPT (OpenAI), Facebook e WhatsApp.

O LINE merece uma nota especial porque é o app de mensagens padrão de boa parte da população do Japão; por isso, um produto que oferece login ou notificações pelo LINE vai querer cobrir esse caminho além do SMS comum. A disponibilidade muda durante o dia, e é por isso que a lista nas suas ferramentas deve vir da API, e não desta página.

Como integro a API OTP do Japão a um test runner?

A API de verificação por SMS fica em https://otproute.com/api/v1. Crie uma chave no console de desenvolvedor (elas começam com or_live_), envie-a como token Bearer e fique abaixo de 300 requisições por minuto. Uma conta pode ter 10 chaves e 5 endpoints de webhook.

Uma execução típica é assim:

1. Resolva os ids uma vez com GET /api/v1/services e GET /api/v1/countries; o Japão é jp.
2. Busque a tarifa atual em GET /api/v1/prices?country=jp&service=<id> e guarde-a junto com o resultado do teste.
3. Crie o pedido com POST /api/v1/activations e o corpo {"service": "<id>", "country": "jp"}.
4. Digite o número retornado no app em teste e dispare o SMS.
5. Receba activation.sms_received no seu webhook, ou faça polling em GET /api/v1/activations/{id} se o runner estiver atrás de um firewall.
6. No teardown, chame POST /api/v1/activations/{id}/cancel para qualquer ativação que o teste não precise mais.

As requisições de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 sobre <t>.<raw body> usando o segredo do endpoint, compare com segurança e recuse timestamps antigos. Trate os eventos indexados pelo id da ativação para que uma nova tentativa seja inofensiva. Para detalhes de CI, veja testes de SMS OTP em pipelines de CI e a solução de testes de QA.

Alguém sem perfil técnico no escritório de Tóquio consegue fazer isso pelo navegador?

Sim. No painel da OTP Route, abra o OTP Gateway, selecione o Japão e o serviço, confira o preço exibido e confirme. O número aparece na hora; quando a mensagem chega, o código surge ao lado dele. Não é preciso instalar nada, o que torna a opção prática para um líder de suporte ou um gerente de marketing que confere o fluxo de uma landing page de campanha.

Como são formatados os celulares japoneses e como são as mensagens?

O Japão usa o prefixo de tronco 0 nas chamadas nacionais. Os celulares costumam ser escritos como 070, 080 ou 090 seguidos de oito dígitos, muitas vezes agrupados com hifens. Em E.164 o zero é removido, então 090 e o restante viram +81 90 mais oito dígitos. Salve apenas a versão E.164, remova hifens e espaços quando os usuários os digitarem e garanta que seu validador não rejeite a faixa 070.

As mensagens de verificação costumam chegar em japonês, misturando kanji, hiragana e katakana, e algumas trazem dígitos de largura total em vez de numerais ASCII comuns. Passe o texto por uma normalização Unicode NFKC antes de extrair o código; caso contrário, uma regex para [0-9] pode deixá-lo escapar em silêncio. Texto japonês também significa que o SMS é enviado em codificação Unicode, então mantenha seus logs em UTF-8 para ler as falhas depois.

O código não apareceu. O que podemos tentar?

Sem chegada, sem cobrança: quando 20 minutos passam sem um SMS, ou você cancela, o valor integral é reembolsado na carteira automaticamente. Antes de pedir de novo:

• Dê tempo à janela; um código que chega tarde ainda é capturado.
• Tente de novo após uma pausa, ou troque para outra rota do mesmo serviço.
• Verifique se o serviço aceita números virtuais, porque alguns os recusam.
• Evite refazer pedidos em um loop rápido na automação; espace as tentativas.

O artigo sobre roteamento de OTP por país explica por que as rotas diferem.

Existe uma linha japonesa de longo prazo e como a carteira é cobrada?

A OTP Route não oferece um número japonês de longo prazo em autoatendimento. Os Números Virtuais Dedicados são um produto dos Estados Unidos e do Canadá, a partir de $1.95/mês; se uma linha +81 de longo prazo for essencial, escreva para [email protected] e a equipe verificará o que as regras locais permitem, sem qualquer promessa de que seja possível.

O pagamento passa por uma única carteira pré-paga em USD: sem assinatura e sem plano. Recarregue com cartão ou com USDT/USDC, e uma fatura em PDF chega por e-mail a cada recarga. Sob solicitação, uma conta de desenvolvimento pode rodar em modo sandbox, com números e códigos simulados. Veja a página de preços para os valores atuais.

Perguntas frequentes

Posso receber códigos SMS OTP do Japão sem um chip japonês?

Sim. O OTP Gateway emite um número +81 para uma verificação e mostra o código no painel ou o envia ao seu webhook.

Qual id de país envio para o Japão nas chamadas de API?

Use jp no corpo da ativação e na consulta de preços.

Por que meu parser não encontra códigos em mensagens japonesas?

A mensagem pode usar dígitos de largura total. Aplique a normalização NFKC antes de comparar, e o código passará a casar com um padrão de dígitos comum.

Os números 090 devem ser armazenados com o zero inicial?

Não. Armazene +81 seguido do número sem o zero de tronco, por exemplo +81 90 e os oito dígitos restantes.

O que acontece com meu dinheiro se nenhum código de verificação japonês chegar?

Ele volta para a sua carteira automaticamente quando a janela de 20 minutos termina ou quando você cancela a ativação.

Podemos testar cadastros do LINE para o mercado japonês?

O LINE aparece entre os serviços disponíveis para o Japão, embora a disponibilidade mude. Consulte a lista em tempo real e siga os termos do LINE para qualquer conta que você criar.

Há alguma regra sobre como os números podem ser usados?

Sim. Use-os apenas para os seus próprios produtos e contas legítimas, respeite os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route se aplica.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.