Como receber OTPs do Tokopedia em um número roteado para suas contas de teste e de operação

Onde o Tokopedia pede um número de telefone?

O Tokopedia é um dos maiores marketplaces online da Indonésia e, como a maioria dos aplicativos de comércio indonésios, trata o número de telefone como parte central da conta. O telefone do Tokopedia costuma ser solicitado no cadastro, usado para códigos únicos no login em um aparelho novo e conferido de novo antes de alterações sensíveis, como editar dados de recebimento ou trocar o próprio número. As contas de vendedor passam por etapas de confirmação semelhantes.

O aplicativo pode oferecer mais de um canal para os códigos; a OTP Route captura a rota de SMS, então escolha SMS quando o aplicativo perguntar. As mensagens costumam chegar em indonésio.

Entre os motivos legítimos para receber um OTP do Tokopedia em um número roteado estão o QA de uma ferramenta de vendedor ou de uma integração de loja que você desenvolve, agências que operam contas de lojistas em nome de clientes e equipes de operações que querem manter um login de loja compartilhado fora do chip pessoal de um funcionário. A página da solução para marketplaces trata dessas configurações.

De qual país deve vir o número do Tokopedia?

O levantamento ao vivo lista o Tokopedia em 197 países. Combine o número com o mercado real da conta: um número da Indonésia (+62) serve para a conta típica de vendedor ou comprador indonésio, enquanto um número de outro lugar é útil para verificar como o seu próprio produto lida com a entrada internacional de telefones.

Outros países da lista incluem Malásia, Singapura, Brunei, Filipinas, Tailândia, Vietnã, Índia, Austrália, Japão, Coreia do Sul, Hong Kong, Taiwan, Reino Unido, Países Baixos e Estados Unidos. Um caso de teste deve declarar o país que espera, para que uma falha aponte para o fluxo, e não para uma rota incompatível.

Como corre o fluxo da API de código de verificação do Tokopedia?

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer com o prefixo or_live_. O id do serviço é tokopedia, e o id de país da Indonésia é id.

1. Consulte GET /api/v1/prices?country=id&service=tokopedia para ver preço e disponibilidade ao vivo.
2. Faça o pedido com POST /api/v1/activations e o corpo {"service": "tokopedia", "country": "id"}.
3. Digite o número retornado na tela de cadastro ou de login que você está testando e peça o código por SMS.
4. Leia o resultado no seu webhook ou consulte GET /api/v1/activations/{id} por polling até o código aparecer.
5. Chame POST /api/v1/activations/{id}/cancel se o teste for abortado, para que os fundos voltem na hora.

O limite da conta de 300 requisições por minuto é mais que suficiente para o polling. Os formatos completos de requisição e resposta estão na documentação da API.

Como escrever um handler de webhook para o Tokopedia?

Aponte um dos seus cinco endpoints de webhook para uma rota que escute activation.sms_received, activation.expired e activation.cancelled dos pedidos do Tokopedia. Cada entrega inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e recuse timestamps vencidos.

Torne o handler idempotente usando o id da ativação como chave, porque uma entrega repetida não pode concluir o mesmo teste duas vezes. Se você preferir não expor um endpoint, o polling funciona igualmente bem para um único script. O guia de captura por webhook traz um desenho completo.

O painel consegue tratar um código do Tokopedia sem escrever código?

Sim. Abra o OTP Gateway, escolha o Tokopedia, selecione um país e confirme o preço na tela. Copie o número para o aplicativo do Tokopedia, selecione SMS como canal, e o código aparece ao lado da ativação quando for recebido. Um responsável pelas operações de lojistas pode fazer isso enquanto os desenvolvedores usam a API com a mesma carteira.

Por que um OTP do Tokopedia pode não chegar?

Várias coisas podem barrar um código: o aplicativo pode recusar números virtuais em alguns fluxos, pode limitar solicitações repetidas para o mesmo número, ou o código pode ter ido por um canal diferente do SMS. As rotas também variam ao longo do dia.

Cada ativação dura 20 minutos, e você só paga quando o código chega. Se nada chegar, o valor volta automaticamente para a sua carteira. Deixe a janela terminar, tente de novo mais tarde ou por outra rota de país que sirva à conta e evite refazer o pedido em um loop apertado. Nosso guia sobre falhas de entrega lista mais verificações.

Uma conta de loja do Tokopedia deveria ficar em um Número Dedicado?

Uma ativação descartável serve para um teste de cadastro novo. Uma conta de loja que precisa entrar de novo no mês que vem exige um número que continue sob o seu controle; do contrário, um código de login futuro pode ficar sem destino. Os Números Dedicados cobrem esse caso nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS recebidos no painel e encaminhados ao seu webhook number.sms_received. Se um número dos EUA ou do Canadá serve para uma conta do Tokopedia depende da própria conta, então verifique isso antes de contar com ele.

Quais são as regras para testar o Tokopedia com responsabilidade?

Siga os termos do Tokopedia, mantenha uma conta por pessoa ou empresa reais e use a OTP Route apenas para testar e operar seus próprios produtos e contas legítimos. O nome do serviço é uma marca registrada de seu proprietário, e a OTP Route não tem afiliação com ele. A Política de Uso Aceitável da OTP Route se aplica a todos os pedidos.

A cobrança vem de uma carteira pré-paga em USD recarregada por cartão, USDT ou USDC, com fatura em PDF a cada recarga e sem mensalidade. Contas de desenvolvedor podem pedir o modo sandbox para testes simulados de ponta a ponta.

Perguntas frequentes

Posso testar o login da minha ferramenta de vendedor no Tokopedia sem o telefone de um colega?

Sim. Peça uma ativação do Tokopedia no OTP Gateway e leia o código no painel ou pela API.

Qual id de serviço a API usa para o Tokopedia?

É tokopedia. Combine-o com um id de país, como id para a Indonésia.

O Tokopedia aceita qualquer número virtual?

Não. Alguns fluxos podem recusar números virtuais, e por isso uma ativação sem código é reembolsada integralmente.

Qual país é o melhor para um número de telefone do Tokopedia?

Em geral a Indonésia, já que é onde operam a maioria das contas, mas escolha o país que corresponde à conta e ao caso de teste.

Pago se o Tokopedia enviar o OTP por outro canal?

Não, se nenhum SMS chegar ao número. Quando a janela de 20 minutos fecha vazia, o valor integral volta para a sua carteira.

Como evito que entregas duplicadas de webhook quebrem meus testes?

Guarde os ids de ativação já processados e ignore as repetições, depois de verificar o cabeçalho de assinatura em cada requisição.

Posso manter um número por longo prazo para uma conta de loja do Tokopedia?

Os Números Dedicados estão disponíveis nos EUA e no Canadá pelo painel; os outros países não têm linha de longo prazo de autoatendimento.

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.