Como receber códigos de verificação por telefone do Gojek via API

Como o Gojek usa o seu número de telefone?

O Gojek nasceu na Indonésia como serviço de mototáxi por aplicativo e se tornou um super-app que cobre corridas, entrega de comida, envio de encomendas e pagamentos, e hoje pertence ao mesmo grupo do Tokopedia. O número de telefone é o centro de uma conta Gojek: é o identificador de login, um código único o confirma no cadastro e outro código é pedido quando alguém entra em um novo dispositivo ou troca o número.

É por isso que quem integra com o Gojek ou atende usuários dele acaba precisando de um número de telefone do Gojek para testes. Quando o app oferece uma escolha de canal de entrega, selecione SMS, porque um número do OTP Gateway recebe mensagens de texto.

Motivos típicos para uma equipe pedir uma verificação por SMS do Gojek para testes:

• Uma integração com parceiro, como um vínculo de lojista ou de fidelidade, que precisa de um login novo do Gojek em uma execução de staging.
• A equipe de suporte reproduzindo o problema de login de um cliente em uma conta limpa que ela controla.
• Verificações de localização que confirmam como ficam a tela do código e seu temporizador de reenvio em bahasa indonésio e em inglês.

Por que o país de um número de teste do Gojek importa?

O serviço gojek está listado em 197 países na OTP Route, mas o país certo depende do que você está verificando. A maioria das contas reais do Gojek é indonésia; por isso, a Indonésia (+62) é o padrão natural; os celulares indonésios são escritos 08… localmente e viram +62 8… em E.164 depois de retirado o zero do prefixo de tronco. Os textos de verificação em contas indonésias costumam chegar em bahasa indonésio.

Outras rotas incluem Singapura, Malásia, Vietnã, Filipinas, Tailândia, Índia, Austrália, Japão, Reino Unido, Estados Unidos e Brasil. Um número de fora do Sudeste Asiático é útil quando você quer ver como o cadastro se comporta para um viajante ou para uma região sem suporte. O artigo sobre roteamento por país explica como escolher.

Como é o fluxo da API para o serviço gojek?

Envie as requisições para https://otproute.com/api/v1 com uma chave Bearer que começa com or_live_.

1. Leia GET /api/v1/prices?country=id&service=gojek para ver o preço em tempo real e a disponibilidade na rota indonésia.
2. Crie o pedido: POST /api/v1/activations com {"service": "gojek", "country": "id"}. Guarde o id de ativação.
3. Digite o número retornado no app do Gojek e solicite o código.
4. Receba o código em activation.sms_received no seu webhook ou faça polling em GET /api/v1/activations/{id}.
5. Chame POST /api/v1/activations/{id}/cancel se o teste for abandonado.

Nos webhooks, confira o cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>) calculando o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, e descarte timestamps antigos. Como uma entrega pode ser repetida, deixe o handler idempotente: use o id de ativação como chave e ignore as repetições. O polling serve para execuções isoladas dentro do limite de 300 requisições por minuto. Veja a documentação para a referência completa.

Posso receber um OTP do Gojek pelo painel?

Sim. Escolha Gojek como serviço, selecione o país, confirme o preço exibido e faça o pedido. Digite o número no app, toque para enviar o código e observe o cartão da ativação; o SMS aparece ali assim que chegar. O pedido fica aberto por 20 minutos e, se nada chegar ou se você cancelar, o valor integral volta para a sua carteira.

Por que o SMS do Gojek pode não chegar?

Algumas causas são comuns:

• O Gojek, como muitos apps, pode recusar números virtuais ou pedir verificações extras; você não paga quando nenhum código chega.
• O app pode ter enviado o código por um canal diferente do SMS.
• A rota pode estar ocupada; espere a janela terminar e depois tente de novo mais tarde ou use outro país.
• Pedidos repetidos em sequência rápida podem acionar os tempos de espera do próprio app; por isso, espace as tentativas em vez de fazer um laço.

Quando um número dedicado é mais adequado?

Um número de uso único cobre um código. Se uma conta de teste ou de operações do Gojek precisa continuar fazendo login, um Dedicated Number com SMS de longo prazo pode ser melhor, mas eles são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, e só ajudam se a conta aceitar um número dos EUA ou do Canadá. Compare as duas opções em números temporários versus dedicados.

Como manter os testes do Gojek responsáveis?

Siga os termos do Gojek. Mantenha uma conta por pessoa real ou empresa, use os números apenas para testar os fluxos do seu próprio produto ou operar as suas próprias contas legítimas, e nunca para criar contas extras ou resgatar promoções de cadastro. A OTP Route não é afiliada ao Gojek, o nome é marca registrada de seu titular, e a Política de Uso Aceitável da OTP Route vale para cada pedido.

Perguntas frequentes

Posso receber um OTP do Gojek sem um chip indonésio?

Sim. Peça um número +62 de uso único para o serviço gojek no OTP Gateway e leia o código no painel ou pela API.

Qual é o id de serviço do Gojek na API da OTP Route?

É gojek; combine-o com um id de país como id para a Indonésia.

Um número virtual para o Gojek é aceito sempre?

Não. O Gojek pode recusar alguns números virtuais, e é por isso que uma ativação sem código é reembolsada automaticamente.

Por quanto tempo a ativação do Gojek fica aberta?

Vinte minutos. Se nenhum SMS chegar nesse tempo, ou se você cancelar, a cobrança volta para a sua carteira.

Posso usar o mesmo número para entrar no Gojek mais tarde?

Não com o OTP Gateway, que cobre um código por número. Para logins repetidos, considere um Dedicated Number dos EUA ou do Canadá, quando a conta permitir.

Como evito o processamento duplicado de webhooks dos códigos do Gojek?

Verifique a assinatura, depois guarde o id de ativação e ignore qualquer evento que você já tenha tratado.

Posso testar sem gastar dinheiro?

Sim, sob solicitação uma conta de desenvolvimento pode ser movida para o sandbox, que devolve números e códigos simulados.

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.