Coletando códigos OTP indonésios +62 de forma programática

Quais endpoints uma integração da API OTP da Indonésia chama?

Tudo roda em https://otproute.com/api/v1 com uma chave Bearer de prefixo or_live_. Crie uma no console do desenvolvedor; uma conta pode ter até 10 chaves, o que facilita separar um runner de CI de uma máquina de staging.

1. Busque GET /api/v1/services e GET /api/v1/countries e guarde ambas as listas em cache. A Indonésia aparece com o id id.
2. Consulte GET /api/v1/prices?country=id&service=<id> para obter o preço e a disponibilidade atuais do serviço que você vai testar. O estoque se move durante o dia, então consulte-o a cada execução em vez de fixá-lo no código.
3. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "tokopedia", "country": "id"}. Você recebe de volta um id de ativação e um número +62.
4. Digite ou injete esse número no campo de telefone do seu próprio app ou conta de teste.
5. Leia o resultado por um webhook, ou faça polling de GET /api/v1/activations/{id}. Aborte de forma limpa com POST /api/v1/activations/{id}/cancel quando um teste falhar antes da etapa do SMS.

Um rápido GET /api/v1/balance antes de a suíte começar permite que uma execução falhe cedo, em vez de no meio do caminho. O polling em um intervalo sensato cabe com folga no teto de 300 requisições por minuto. Os esquemas completos estão na documentação da API.

Como processo códigos +62 com um webhook assinado?

O polling serve para um único desenvolvedor; jobs paralelos ficam mais tranquilos com entrega por push. Registre até 5 endpoints por conta e assine activation.sms_received, activation.expired e activation.cancelled.

Toda requisição inclui um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Reconstrua a string assinada como <t>.<raw body>, calcule o HMAC-SHA256 com o segredo do endpoint e compare-o com v1 em tempo constante. Calcule o hash dos bytes brutos antes de qualquer parsing de JSON e descarte requisições cujo timestamp seja antigo demais, para que um payload capturado não possa ser reproduzido.

Trate os eventos como identificados pelo id da ativação e torne o handler idempotente: uma entrega reenviada deve simplesmente encontrar o código já armazenado. Nosso texto sobre segurança de webhooks com HMAC percorre as verificações.

Quais serviços podem receber SMS OTP da Indonésia na OTP Route?

O panorama ao vivo da Indonésia cobre mais de 3.000 serviços. Entre as rotas populares estão WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook e ChatGPT (OpenAI).

Para colegas que nunca tocam na API, o painel faz o mesmo trabalho: entre, escolha o serviço, escolha Indonésia, confira o preço mostrado e faça o pedido. O número +62 aparece na tela e o código é exibido ao lado quando o SMS chega. Cancele a partir da mesma tela se o teste for suspenso.

Como armazenar e normalizar um número +62?

A Indonésia usa o prefixo de tronco 0, então as pessoas escrevem os celulares em âmbito nacional como 08 seguido do restante dos dígitos. Em E.164, o 0 desaparece: um número escrito localmente como 0812... vira +62812.... Armazene a forma E.164, normalize tudo o que o usuário digitar removendo espaços, hifens e o 0 inicial, e deixe uma biblioteca de telefones mantida julgar a validade, porque os números de assinantes indonésios não compartilham todos o mesmo tamanho.

Os modelos de SMS enviados a números indonésios costumam estar em bahasa indonésia, embora alguns serviços enviem em inglês. Extraia o código com um padrão de dígitos em vez de casar palavras como "kode" ou "code", e o seu parser não se importará com o idioma do modelo.

Por que as equipes de produto testam fluxos de cadastro na Indonésia?

A Indonésia é um dos países mais populosos do mundo e o uso da internet ali é fortemente centrado no celular, então a verificação do número de telefone fica na frente de muitos fluxos de onboarding. As equipes que se expandem pelo Sudeste Asiático querem ver as suas próprias telas de cadastro e login indonésias se comportarem corretamente com um número +62 real, verificar se o texto em bahasa indonésia é exibido sem truncamento e confirmar que as suas regras antifraude não bloqueiam usuários locais legítimos.

Equipes de operações regionais e de marketplace também usam a rota para verificar contas comerciais que administram para lojas indonésias. A página de testes de QA mostra como incorporar isso a um plano de regressão.

E se o código indonésio nunca aparecer?

O tempo de entrega depende do serviço e da rota, então dê espaço à ativação antes de decidir que ela falhou. Quando nenhum SMS chega:

• Deixe a janela de 20 minutos se esgotar, ou cancele; de qualquer forma, o valor integral volta automaticamente para a sua carteira.
• Peça de novo um pouco mais tarde, ou tente outra rota de serviço se o seu teste permitir.
• Confirme que o serviço de destino aceita números virtuais para essa ação. Alguns não aceitam, e é exatamente por isso que existe a regra de reembolso.
• Evite refazer o pedido em laço apertado. Espace as tentativas para que um job de CI não queime as repetições em segundos.

Mais ideias de diagnóstico estão em como reduzir falhas na entrega de OTP.

Existe um número +62 dedicado, e como ele é cobrado?

Não. Uma linha indonésia de longo prazo de autoatendimento não é oferecida. Os Números Dedicados são um produto dos Estados Unidos e do Canadá, a partir de $1.95/month. Se a sua equipe realmente precisa de uma linha +62 duradoura, escreva para [email protected]; a possibilidade de organizá-la depende das regras locais e não é prometida.

A cobrança do OTP Gateway usa uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. Abasteça a carteira com cartão ou com as stablecoins USDT/USDC; cada recarga dispara uma fatura em PDF por e-mail para os seus registros financeiros. Contas de desenvolvimento podem solicitar o modo sandbox, que retorna números e códigos simulados para testes de integração de ponta a ponta sem gastar fundos. Veja os preços ou crie uma conta.

Perguntas frequentes

Posso testar o fluxo de cadastro indonésio do meu app sem um chip local?

Sim. Peça um número +62 no OTP Gateway para o serviço relevante, digite-o no seu app e leia o código no painel ou pela API.

Que id de país a API da OTP Route usa para a Indonésia?

A Indonésia é id, então uma consulta de preço fica GET /api/v1/prices?country=id&service=<id>.

Pago se o SMS indonésio nunca chegar?

Não. Se nada chegar durante a janela de 20 minutos, ou se você cancelar, a cobrança integral volta automaticamente para a sua carteira.

Devo manter o 0 inicial ao salvar um celular indonésio?

Mantenha-o somente para exibição no formato local. Armazene +62 seguido do número nacional sem o 0, que é a forma E.164.

Os textos de verificação indonésios virão em inglês?

Nem sempre. Muitos chegam em bahasa indonésia, então analise o código numérico em vez de depender das palavras ao redor.

Os números indonésios podem ser usados para qualquer finalidade?

Apenas para uso legítimo: testar e operar os seus próprios produtos e contas dentro dos termos de cada serviço. A Política de Uso Aceitável da OTP Route se aplica a todos os pedidos.

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.