Recebendo códigos de verificação indianos (+91) por meio de uma API

Como é a sequência de chamadas da API OTP da Índia?

Todo o fluxo é um punhado de requisições a https://otproute.com/api/v1, autenticadas com uma chave Bearer que começa por or_live_. As chaves vêm do console do desenvolvedor, até 10 por conta, para que cada ambiente tenha a sua.

1. Chame GET /api/v1/countries uma vez e guarde em cache. O id de país da Índia é in.
2. Chame GET /api/v1/prices?country=in&service=<id> para o serviço em teste. Ele retorna o preço e a disponibilidade ao vivo, então leia-o a cada execução.
3. Faça o pedido com POST /api/v1/activations e um corpo JSON como {"service": "telegram", "country": "in"}. A resposta dá um id de ativação e um número +91.
4. Digite esse número na tela de cadastro ou de login do seu próprio app.
5. Colete o código por webhook ou por polling de GET /api/v1/activations/{id}. Se o teste morrer cedo, chame POST /api/v1/activations/{id}/cancel.

Verifique GET /api/v1/balance no início de uma suíte para que a execução falhe rápido. A API permite 300 requisições por minuto, de sobra para fazer polling a cada poucos segundos. Os detalhes de requisição e resposta estão na documentação da API.

Como construir um handler de webhook para códigos +91?

Um webhook assinado escala melhor do que o polling quando os jobs rodam em paralelo. Registre um endpoint no console do desenvolvedor (até 5 por conta) e escute activation.sms_received, activation.expired e activation.cancelled.

Cada entrega traz um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Para verificá-lo, calcule o HMAC-SHA256 sobre a string <t>.<raw body> com o segredo desse endpoint e compare o resultado com v1 em tempo constante. Dois detalhes pegam as pessoas de surpresa:

• Calcule o hash dos bytes brutos da requisição, nunca de um objeto JSON reserializado; a ordem das chaves e os espaços alteram o digest.
• Recuse timestamps com mais de alguns minutos para que uma requisição capturada não possa ser reproduzida.

Baseie as suas gravações no id da ativação para que uma entrega duplicada vire uma operação nula, e responda com 2xx antes de fazer trabalho lento. Nosso texto sobre proteger webhooks de OTP com HMAC percorre a etapa de comparação linha por linha.

Quais serviços podem enviar códigos para números indianos?

A rota da Índia lista atualmente mais de 2.300 serviços. Entre as entradas populares do panorama ao vivo estão WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Discord, Uber e Snapchat.

A disponibilidade muda ao longo do dia, e é por isso que a API a informa ao vivo. Se a sua matriz de testes depende de um serviço, consulte os preços de in antes da execução e pule de forma limpa quando essa rota estiver fechada. Use essas rotas apenas para os seus próprios produtos e contas, siga os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Quem não é desenvolvedor pode pedir um número de verificação da Índia pelo painel?

Pode. A equipe de operações e os gerentes de contas de agências podem dispensar a API:

1. Crie uma conta com o seu e-mail e um código de 6 dígitos por e-mail, ou com o login do Google, e ative o TOTP de dois fatores.
2. Recarregue a carteira.
3. Escolha Índia e o serviço, confira o preço na tela e faça o pedido.
4. Digite o número +91 no app que você está configurando; o código aparece na página da ativação assim que o SMS chega.

O painel e a API compartilham a mesma janela, a mesma regra de reembolso e a mesma carteira.

O que fazer quando nenhum código chega em 20 minutos?

Toda ativação fica aberta por 20 minutos. Você só paga se o SMS chegar: quando a janela se fecha vazia, ou você cancela antes, o valor integral volta automaticamente para a sua carteira e o seu webhook recebe activation.expired ou activation.cancelled.

Se um código estiver faltando:

• Deixe a janela correr antes de reagir; um serviço pode simplesmente estar mais lento que o normal para enviar.
• Confirme que o serviço aceita números virtuais. Algumas plataformas os recusam, o que é uma política delas, e não uma falha de entrega.
• Tente de novo mais tarde, ou teste com outra rota de serviço.
• Nunca refaça o pedido em laço apertado. Espace as tentativas para não gastar esforço em uma rota que está recusando números.

Há um tratamento mais longo da estratégia de novas tentativas em como reduzir falhas na entrega de OTP.

Como armazenar e normalizar os números de telefone indianos?

Os celulares indianos têm dez dígitos e, na prática, começam por 6, 7, 8 ou 9. Dentro da Índia, as pessoas costumam escrevê-los com um 0 de tronco no início, ou divididos em cinco e cinco com um espaço. O formato internacional elimina esse 0 e acrescenta o código do país, resultando em +91 seguido dos dez dígitos.

Armazene apenas a forma E.164: +91 mais dez dígitos, sem espaços, hifens nem zero. Normalize a entrada na borda removendo a formatação, um 0 inicial ou um 91 solto digitado sem o sinal de mais. Isso evita usuários duplicados que diferem apenas pela formatação.

A maioria dos SMS de verificação na Índia chega em inglês e vem de um cabeçalho de remetente alfanumérico, e não de um número de telefone. Alguns apps enviam em hindi ou em outro idioma regional, então teste qualquer parser de código também com escritas não latinas.

Por que as equipes de produto precisam de um número +91 para testes?

A Índia é um mercado de lançamento comum para apps de consumo, onboarding de fintech e marketplaces, e os seus usuários esperam uma etapa de SMS no cadastro. As equipes usam rotas +91 para ensaiar um lançamento, para fazer o QA de localização em interfaces em hindi, tâmil, telugu, bengali, marati e outras, para apoiar a equipe de operações regionais e para verificar fluxos usados por clientes da diáspora indiana no exterior que ainda entram com um número do país de origem. Um bom roteamento OTP aqui significa escolher a rota de serviço que corresponde à jornada real do usuário e depois ligá-la às mesmas chamadas da API de verificação por SMS que você usa em outros mercados.

Existe uma linha indiana de longo prazo, e como funciona a cobrança?

Não. Os números dedicados são um produto dos EUA e do Canadá, a partir de $1.95/month, e não é possível comprar uma linha indiana de longo prazo pelo painel. Se precisar de uma, escreva para [email protected]; a disponibilidade depende das regras locais e não é garantida.

A cobrança funciona com uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. Recarregue por cartão ou com as stablecoins USDT/USDC, e cada recarga chega com uma fatura em PDF por e-mail. Para o trabalho de integração, peça ao suporte para mudar uma conta de desenvolvimento para o sandbox: ele retorna números e códigos simulados, para que você teste o seu handler de webhook de ponta a ponta sem gastar fundos da carteira.

Perguntas frequentes

Posso testar o fluxo de cadastro indiano do meu app sem um chip local?

Sim. Peça um número +91 pelo OTP Gateway, digite-o na sua tela de cadastro e leia o código no painel, na API ou no seu webhook.

Qual é o id de país da Índia na API da OTP Route?

É in. Passe-o como país em GET /api/v1/prices e no corpo de POST /api/v1/activations.

Quanto custa receber um SMS OTP da Índia?

Os códigos começam em $0.20 por código, e o preço exato depende do serviço. Você o vê antes de pedir, e uma ativação que não recebe código é reembolsada na sua carteira.

Posso reutilizar o mesmo número +91 para entrar de novo no mês que vem?

Não. Um número do gateway cobre um único código de verificação. Contas que precisam de logins repetidos pertencem a uma linha dedicada, e elas existem apenas nos EUA e no Canadá.

Existe um sandbox para construir a integração com a Índia?

Sim, sob solicitação. O suporte pode mover uma conta de desenvolvimento para o sandbox, em que números e códigos simulados fluem pelo seu código sem tocar na carteira.

A nossa equipe financeira pode pagar com stablecoins?

Sim. A carteira aceita pagamentos por cartão e também USDT e USDC, e cada recarga gera uma fatura em PDF por e-mail.

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.