Como receber OTPs do Zalo em números da OTP Route pela API

Como é o fluxo da API de código de verificação do Zalo?

O id do serviço é zalo. As chamadas vão para https://otproute.com/api/v1 com uma chave Bearer com prefixo or_live_, emitida no console do desenvolvedor.

1. Obtenha os ids de país em GET /api/v1/countries; o Vietnã, por exemplo, é vn.
2. Confira preço e disponibilidade ao vivo com GET /api/v1/prices?country=vn&service=zalo.
3. Crie a ativação: POST /api/v1/activations com {"service": "zalo", "country": "vn"}. Guarde o id da ativação e o número retornado.
4. Digite o número na tela de telefone do Zalo, na conta de teste que você controla.
5. Receba o código por webhook ou por polling, ou encerre o pedido com POST /api/v1/activations/{id}/cancel.

Uma consulta de saldo com GET /api/v1/balance no início da suíte evita surpresas no meio da execução. Veja a documentação da API para os formatos completos das requisições.

Como montar um receptor de webhook para códigos do Zalo

Registre um endpoint no console do desenvolvedor e assine activation.sms_received, activation.expired e activation.cancelled. Cada requisição traz o cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>; calcule o HMAC-SHA256 sobre <t>.<raw body> usando o segredo do endpoint, compare em tempo constante e rejeite timestamps antigos.

Torne o handler idempotente guardando os resultados com o id da ativação como chave. Se o mesmo evento for entregue duas vezes, a segunda gravação deve ser um no-op. Equipes sem endpoint público podem consultar GET /api/v1/activations/{id} por polling; o limite de 300 requisições por minuto deixa folga para um intervalo curto entre vários testes em paralelo.

Quando o Zalo pede um número de telefone?

O Zalo é um aplicativo vietnamita de mensagens e rede social, e o número de telefone funciona como o principal identificador da conta. Em geral, um código é solicitado quando alguém cria uma conta, entra em um novo aparelho e recupera o acesso. Os pedidos exatos são definidos pelo Zalo e podem mudar, então um plano de testes deve cobrir cada tela em vez de supor uma sequência fixa.

Para as equipes de QA isso importa, porque uma integração de mensagens, um mini app ou um canal de atendimento construído em torno do Zalo costuma precisar de uma conta de teste nova e verificada antes de qualquer outro cenário rodar.

Quais países podem receber OTP do Zalo na OTP Route?

As rotas do Zalo estão listadas em 198 países. Entre eles estão Vietnã, Estados Unidos, Japão, Coreia do Sul, Taiwan, Austrália, Canadá, Camboja, Laos, Tailândia, Malásia, Singapura, Alemanha, França e Reino Unido.

Escolha o país que corresponde à conta que você está testando. Um lançamento no Vietnã precisa de números +84 para reproduzir o que os usuários locais veem, enquanto uma equipe que atende comunidades vietnamitas no exterior pode preferir números dos países onde esses clientes moram. O país também influencia preço e disponibilidade, e por isso vale consultar primeiro o endpoint de preços.

Passo a passo no painel para um teste de verificação por SMS do Zalo

Nem todo mundo em um projeto escreve código. No painel, escolha o Zalo como serviço, selecione o país, confirme o preço exibido e faça o pedido. Copie o número para o Zalo; o código aparece ao lado do pedido assim que o SMS chega. Cancelar pela mesma tela devolve o valor integral. O cadastro no painel exige um endereço de e-mail e um código de 6 dígitos enviado por e-mail, ou o login do Google, e o TOTP de dois fatores pode proteger o login da equipe.

Por que um código do Zalo pode não chegar?

A entrega depende do serviço e da rota, então não há um tempo de espera fixo. O Zalo também pode recusar alguns números virtuais, e é por isso que existe o reembolso. Se nada aparecer:

• Deixe o pedido aberto até o fim da janela de 20 minutos, ou cancele; de qualquer modo a carteira recebe o dinheiro de volta.
• Tente de novo mais tarde, ou troque para outro país que sirva ao teste.
• Não repita o pedido em um loop apertado; adicione um backoff nos jobs automatizados.
• Confirme que a própria conta de teste não está bloqueada nem sujeita a limite de taxa do lado do Zalo.

Uma conta de teste do Zalo deveria usar um Número Dedicado?

Um número do OTP Gateway trata um único código. Se uma conta de staging ou de suporte precisa entrar de novo no mês que vem, o Número Dedicado é a melhor opção: uma linha dos EUA ou do Canadá a partir de $1.95/mês, que você mantém enquanto ela é renovada, com SMS recebidos no painel e no webhook number.sms_received. Saiba mais em números virtuais.

Use qualquer uma das opções com responsabilidade. Siga os termos do Zalo, mantenha uma conta por pessoa ou empresa reais e use a OTP Route apenas para testar e operar suas próprias contas e produtos legítimos. O Zalo é uma marca registrada de seu proprietário, e a OTP Route não é afiliada a ele.

Perguntas frequentes

Qual id de serviço a API da OTP Route usa para o Zalo?

É zalo, enviado no corpo de POST /api/v1/activations junto com um id de país.

Posso receber um OTP do Zalo em um número fora do Vietnã?

Sim. As rotas do Zalo estão listadas em 198 países, e a disponibilidade de cada uma é retornada ao vivo pelo endpoint de preços.

Sou cobrado se o Zalo rejeitar o número virtual?

Não. Se nenhum código chegar ao número em 20 minutos, ou se você cancelar, o valor integral é reembolsado na carteira.

Um número virtual para o Zalo serve para uma conta que preciso manter por muito tempo?

Um número descartável não serve. Para logins recorrentes, um Número Dedicado dos EUA ou do Canadá, que você mantém enquanto ele é renovado, é a escolha mais segura.

Como pago pela verificação por SMS do Zalo em testes?

Recarregue uma carteira pré-paga em USD por cartão ou USDT/USDC; não há mensalidade, e cada recarga vem com uma fatura em PDF.

Posso testar a integração com o Zalo sem gastar dinheiro?

Sim. Depois que o suporte muda uma conta de desenvolvimento para o sandbox, os pedidos do Zalo retornam números e códigos simulados, e o código de webhook e de polling pode ser validado antes de qualquer gasto real.

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.