Receba códigos OTP por SMS da Nova Zelândia via API ou painel

Número +64 temporário ou linha de longo prazo: qual eu preciso?

Escolher o produto certo logo no início evita retrabalho depois.

Escolha o OTP Gateway quando um teste ou uma etapa de onboarding precisa de exatamente um código: uma conta de QA nova, um smoke test da sua tela de cadastro para a Nova Zelândia, a verificação de que o fluxo de um cliente neozelandês funciona de ponta a ponta. Você recebe um número, um código, e a sessão se encerra.

Escolha um Número Dedicado quando a mesma conta precisa voltar a fazer login semanas depois ou quando uma equipe compartilha um número de recuperação. Essas linhas de longo prazo são oferecidas apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com os SMS recebidos encaminhados como eventos number.sms_received.

Para a própria Nova Zelândia não existe número de longo prazo em autoatendimento. Escreva para [email protected] se o seu caso exigir um; a resposta depende das regras locais e pode ser negativa. Chamadas, SMS de saída e condições de renovação dessas linhas norte-americanas estão na página de números virtuais.

Por que equipes de produto testam cadastros na Nova Zelândia?

A Nova Zelândia é um mercado muito usado para soft launch de apps em inglês: um público menor, um idioma familiar e um fuso horário bem adiantado fazem dela um lugar prático para observar um onboarding real antes de um lançamento mais amplo. Isso significa que a etapa de verificação por +64 costuma ser o primeiro caminho de produção que um novo mercado enfrenta, e ela merece casos de teste próprios.

Vale cobrir alguns pontos:

• Idioma. Inglês, te reo māori e a Língua de Sinais da Nova Zelândia são oficiais. A maioria dos serviços envia os códigos em inglês, mas, se os seus próprios templates usarem palavras māori com macron (ā, ō, ū), esses caracteres ficam fora do GSM-7 e levam o SMS para UCS-2, o que encurta cada segmento.
• Viradas de relógio. A Nova Zelândia está entre os primeiros lugares a entrar em um novo dia do calendário, então lógicas de expiração e de limite de taxa baseadas em datas podem se comportar de forma diferente para usuários locais.
• Aderência ao mercado. Uma conta de QA verificada com um número local exercita a mesma lógica de país que seus usuários neozelandeses vão encontrar.

Para um padrão de release gate construído em torno de verificações como essas, veja nossas notas sobre testes de QA.

Como armazenar e normalizar números móveis +64?

A Nova Zelândia usa o prefixo de tronco 0. Um celular escrito no formato nacional como 021 123 4567 vira +64211234567 em E.164: remova o 0 inicial e acrescente +64. As faixas de celular começam com 2 depois de tirado o zero, e o comprimento varia, então nunca fixe uma quantidade única de dígitos no código.

Regras práticas para o seu esquema:

• Armazene uma única string E.164 canônica; formate apenas na hora de exibir.
• Aceite entradas com espaços, hífens ou o zero do tronco e normalize com uma biblioteca de análise de telefones mantida ativamente.
• Adicione fixtures de teste para as grafias nacional e internacional, além de um número que o usuário colou com +64 e com o 0 ainda no lugar.

Quais apps enviam códigos para números da Nova Zelândia na OTP Route?

A rota +64 atende mais de 800 serviços. No levantamento atual, entre os mais usados estão Google (Gmail e YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft e Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber e Netflix.

Como a disponibilidade é em tempo real, consulte GET /api/v1/countries e GET /api/v1/services no início de cada execução, em vez de guardar uma lista em cache por semanas. Se um serviço estiver fraco no +64, a rota vizinha da Austrália costuma ser a alternativa para uma comparação em inglês.

Como é a sequência da API de OTP da Nova Zelândia?

Toda chamada +64 vai para https://otproute.com/api/v1 com uma chave Bearer or_live_ emitida no Developer console. A sequência:

1. Leia o preço em tempo real com GET /api/v1/prices?country=nz&service=uber.
2. Crie a ativação com POST /api/v1/activations e o corpo {"service": "uber", "country": "nz"}.
3. Obtenha o código fazendo polling em GET /api/v1/activations/{id}, ou deixe o activation.sms_received chegar ao seu webhook. activation.expired e activation.cancelled avisam quando limpar o estado.
4. Cancele pedidos não usados com POST /api/v1/activations/{id}/cancel e acompanhe o saldo com GET /api/v1/balance.

Nos webhooks, verifique o X-OTPRoute-Signature calculando o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, rejeite timestamps antigos e torne o handler idempotente pelo id da ativação, para que uma entrega repetida não cause problemas. O guia de integração traz um passo a passo mais completo; o limite é de 300 requisições por minuto por conta.

Quem não é desenvolvedor consegue pedir um número de verificação da Nova Zelândia?

Com certeza. No painel, escolha Nova Zelândia, selecione o serviço, confira o preço exibido e confirme. O número +64 aparece no pedido; digite-o no app, solicite o SMS e o código aparece no mesmo cartão assim que chegar. Tudo acontece dentro da janela de 20 minutos, então deixe o app de destino aberto antes de fazer o pedido.

E se o código +64 nunca chegar?

Primeiro, dê à janela os 20 minutos completos, pois alguns remetentes atrasam ou agrupam seus SMS. Se continuar vazio, o serviço pode recusar números virtuais ou aquela rota pode estar ocupada; tente de novo mais tarde ou teste com a rota de outro serviço, em vez de disparar pedidos novos em sequência. Pedidos sem resposta, e os que você cancela, são reembolsados na carteira automaticamente. A cobrança é pré-paga em uma carteira em USD, pague conforme o uso: recarga por cartão ou USDT/USDC, uma fatura em PDF para cada uma, sem mensalidade, e modo sandbox sob solicitação para ensaios. A OTP Route é para suas próprias contas e produtos legítimos, dentro dos termos de cada serviço e da nossa Política de Uso Aceitável.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app na Nova Zelândia sem um chip local?

Sim. Peça um número +64 no OTP Gateway, use-o no seu formulário de cadastro e leia o código no painel ou pela API.

Mantenho o 0 ao salvar um celular da Nova Zelândia?

Não. O 0 do tronco é removido no E.164, então 021 123 4567 é armazenado como +64211234567.

Qual é o id de país da Nova Zelândia na API?

É nz, usado nas consultas de preço e no corpo da requisição de ativação.

Quanto custa um código de verificação da Nova Zelândia?

Os preços começam em $0.20 por código e dependem do serviço; o painel e o GET /api/v1/prices mostram o valor exato antes de você pedir.

Posso alugar um número da Nova Zelândia por alguns meses?

Não há linha +64 de longo prazo em autoatendimento. Os Números Dedicados são um produto para EUA e Canadá, e você pode escrever para [email protected] para perguntar sobre outros países.

É melhor usar polling ou webhook para coletar os códigos +64?

O polling é mais simples para um único script; um webhook assinado escala melhor quando vários jobs de teste rodam em paralelo. Os dois devolvem o mesmo código.

Todo app vai aceitar um número da OTP Route da Nova Zelândia?

Não necessariamente. Alguns serviços rejeitam números virtuais, e é por isso que um pedido sem SMS é reembolsado automaticamente.

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.