Como as equipes recebem códigos SMS do DiDi para testes e operações

A situação: uma conta de mobilidade que depende de um único número de telefone

O DiDi é uma plataforma de transporte por aplicativo e de mobilidade e, como a maioria dos apps dessa categoria, trata o número de celular como o núcleo da conta. Um código por SMS costuma ser pedido no cadastro, quando alguém faz login em um novo dispositivo e na recuperação da conta; o onboarding de motoristas e entregadores recorre à mesma verificação.

Isso cria atrito para o trabalho empresarial legítimo. Uma empresa que mantém uma conta corporativa de passageiro não quer vê-la presa ao telefone pessoal de um funcionário. Uma agência que cuida das viagens de clientes precisa de uma etapa de verificação que outra pessoa, além de quem se cadastrou, consiga concluir. Uma equipe de QA que desenvolve um produto ligado a uma conta DiDi quer ensaiar o fluxo sem passar um aparelho pessoal de mão em mão pelo escritório. Um número virtual para o DiDi, usado uma vez por verificação, mantém essas etapas fora do chip particular de qualquer pessoa.

Quais países podem fornecer um número de telefone para o DiDi?

A rota didi abrange hoje 198 países. As equipes costumam começar por mercados com alta demanda de transporte por aplicativo, como México, Brasil, Chile, Colômbia, Peru, Argentina, Costa Rica, Panamá, República Dominicana, Equador, Austrália, Nova Zelândia, Japão e Hong Kong.

Escolha o país com critério. Uma conta de passageiro que será usada em Santiago deve ser verificada com um número chileno, e um teste de regressão da tela de cadastro mexicana precisa de um número mexicano. Descasar o país do número e o mercado da conta é um motivo comum para um teste passar no papel e falhar no app real. A lista completa está em países.

Como funciona o fluxo da API de código de verificação do DiDi?

O fluxo do DiDi usa a mesma URL base de todas as outras rotas, https://otproute.com/api/v1, com uma chave or_live_ no cabeçalho Authorization.

1. Consulte GET /api/v1/prices?country=<id>&service=didi para ver se a rota está aberta e quanto custa agora.
2. Faça o pedido com POST /api/v1/activations e um corpo como {"service": "didi", "country": "mx"}.
3. Digite o número retornado na tela do DiDi que você está testando e solicite o SMS.
4. Leia o código no webhook ou faça polling em GET /api/v1/activations/{id} até ele aparecer.
5. Se o teste de reserva de corrida for abandonado no meio, libere o número com POST /api/v1/activations/{id}/cancel.

Uma conta pode ter até 10 chaves e 5 endpoints de webhook, dentro de 300 requisições por minuto.

Como escrever um handler de webhook do DiDi?

Inscreva-se em activation.sms_received e também em activation.expired e activation.cancelled, para que o seu teste saiba quando parar de esperar. Cada entrega traz X-OTPRoute-Signature: t=<unix>,v1=<hex>; recalcule o HMAC-SHA256 sobre "<t>.<raw body>" com o segredo do endpoint, compare em tempo constante e descarte tudo que tenha timestamp antigo.

Os eventos são identificados pelo id de ativação; por isso, guarde esse id ao fazer o pedido e trate uma segunda entrega para o mesmo id como uma operação nula. Essa idempotência importa porque um webhook reenviado nunca deve enviar um código do DiDi duas vezes. Se os webhooks de entrada forem incômodos no seu ambiente, o polling do endpoint de ativação também funciona. O artigo sobre captura de OTP por webhook compara as duas abordagens.

Como receber um OTP do DiDi pelo painel

A equipe de operações pode dispensar a API por completo. Entre na conta, recarregue a carteira, abra o OTP Gateway, procure por DiDi, escolha o país que corresponde à conta e confira o preço exibido antes de confirmar. O número aparece em um cartão de ativação, e o código surge ali assim que o DiDi o enviar. A ativação fica aberta por 20 minutos.

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

Várias causas comuns explicam uma ativação vazia:

• O DiDi, como muitas plataformas, pode recusar números virtuais em algumas rotas ou em certos momentos.
• A rota do país escolhido pode estar ocupada; a disponibilidade varia ao longo do dia.
• O app pode limitar pedidos repetidos do mesmo dispositivo ou da mesma sessão durante os testes.

O remédio é paciência, e não agressividade. Deixe a janela terminar, tente mais tarde ou com outro país que ainda combine com o teste e evite refazer o pedido em um laço apertado. Você nunca paga por uma tentativa sem resposta: quando a janela fecha ou você cancela, o valor integral volta automaticamente para a carteira.

Quando uma conta do DiDi deve ficar em um Dedicated Number e quais regras valem?

Uma ativação de uso único serve para uma única verificação. Se a mesma conta do DiDi precisa fazer login de novo no mês que vem, por exemplo uma conta de passageiro de staging ou um login corporativo compartilhado, um Dedicated Number mantém a linha sob o seu controle. Eles são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, com SMS recebidos no painel e no seu webhook. Veja os detalhes em números virtuais.

Use a OTP Route somente para testar e operar os seus próprios produtos e contas legítimos. Siga os termos do DiDi, mantenha uma conta por pessoa real ou empresa e lembre que a Política de Uso Aceitável da OTP Route se aplica. A OTP Route não tem afiliação com o DiDi, cujo nome é marca registrada de seu titular.

Perguntas frequentes

Qual é o id de serviço para a verificação por SMS do DiDi em testes?

Use didi no campo service, junto com o id do país do mercado que você está testando.

Posso receber um OTP do DiDi para uma conta mexicana sem um chip mexicano?

Sim, se a rota do México estiver aberta: peça um número com o país mx e o serviço didi e leia o código pela API ou no painel.

Pago se o DiDi nunca enviar o código?

Não. Uma ativação sem SMS em 20 minutos, ou uma que você cancele, é reembolsada integralmente à carteira.

O DiDi aceita qualquer número virtual?

Não necessariamente. Algumas rotas podem ser recusadas; por isso, tente mais tarde ou use outro país adequado.

Posso testar a integração com o DiDi sem gastar saldo da carteira?

Sim. Uma conta de desenvolvimento pode ser colocada em sandbox sob solicitação, devolvendo números e códigos simulados para testes de ponta a ponta.

Como pago pelas ativações do DiDi?

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. Os valores atuais estão na página de preços.

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.