Capturando códigos SMS do foodpanda com API, webhooks ou o painel

Quais chamadas de API recuperam um código do foodpanda?

O fluxo da API de código de verificação do foodpanda usa o id de serviço foodpanda e cinco chamadas a https://otproute.com/api/v1, cada uma autenticada com uma chave Bearer iniciada em or_live_.

1. GET /api/v1/countries fornece os ids dos países; guarde o resultado em cache.
2. GET /api/v1/prices?country=<id>&service=foodpanda retorna o preço atual e informa se aquele mercado pode ser atendido neste momento.
3. POST /api/v1/activations com {"service": "foodpanda", "country": "<id>"} cria o pedido e devolve um id de ativação e um número de telefone.
4. Seu teste digita esse número na tela do foodpanda que está sendo exercitada, e o código é capturado por webhook ou por GET /api/v1/activations/{id}.
5. POST /api/v1/activations/{id}/cancel encerra um pedido de que o teste não precisa mais.

Inclua GET /api/v1/balance na etapa de preparação para que a suíte pare de forma limpa quando a carteira estiver vazia. As chaves vêm do console do desenvolvedor, até 10 por conta, e o limite é de 300 requisições por minuto. A documentação para desenvolvedores lista os formatos de requisição e de erro.

Como escrever o handler de webhook?

A entrega por push é a escolha mais organizada quando vários testes rodam ao mesmo tempo. Aponte um dos seus cinco endpoints permitidos para uma rota do seu ambiente de testes e assine activation.sms_received, activation.expired e activation.cancelled para os pedidos do foodpanda.

Toda entrega inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>. Calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare com o v1 em tempo constante e rejeite requisições cujo timestamp seja antigo demais. Faça isso sobre os bytes brutos, antes de qualquer parsing de JSON que possa alterá-los.

Torne o handler idempotente: use o id da ativação como chave de cada evento e ignore repetições, porque as novas tentativas podem entregar o mesmo evento duas vezes. Responda rápido e envie o código para o que o seu teste estiver aguardando. Em scripts rápidos, consultar o endpoint da ativação a cada poucos segundos é uma alternativa razoável. O guia de webhooks com HMAC cobre os casos extremos.

Para que o foodpanda verifica um número de telefone?

O foodpanda é uma plataforma de entrega de comida e mercado, mais conhecida no sul e no sudeste da Ásia. Como a maioria dos apps de delivery, ele vincula a conta a um número de celular: o número costuma ser confirmado com um código SMS de uso único no cadastro, pode ser verificado de novo ao entrar em um novo dispositivo e dá a entregadores e ao suporte uma forma de falar com o cliente sobre um pedido.

Para equipes parceiras, agências e desenvolvedores que trabalham em torno da plataforma, isso significa que a etapa de receber o OTP do foodpanda aparece em muitas jornadas reais: integrar um novo cliente, testar uma tela de cadastro localizada ou reproduzir um problema de login relatado por um usuário. Ter um número de telefone do foodpanda sob seu controle em cada teste elimina a necessidade de pegar emprestado o chip pessoal de um colega.

Quais países podem fornecer um número do foodpanda?

A rota do foodpanda está disponível em 198 países. Entre os exemplos estão Paquistão, Bangladesh, Malásia, Filipinas, Taiwan, Singapura, Hong Kong, Tailândia, Camboja, Laos, Mianmar, Alemanha, Reino Unido e Estados Unidos.

A escolha do país não é cosmética. Os apps de delivery se localizam por mercado, então um teste da tela de cadastro de Bangladesh deve usar um número de Bangladesh, e uma conta destinada a pedir em Kuala Lumpur deve corresponder à Malásia. Um país incompatível pode levar a um número rejeitado ou a um fluxo regional sem relação. A disponibilidade ao vivo por país muda ao longo do dia, e por isso o endpoint de preços é a fonte da verdade. O guia de roteamento por país explica como escolher e alternar entre mercados.

Uma pessoa que não é desenvolvedora consegue fazer isso pelo painel?

Sim, e leva quase tantos cliques quanto pedir o almoço:

1. Abra o OTP Gateway, escolha o foodpanda como serviço e selecione o país.
2. Confira o preço exibido e confirme o pedido.
3. Copie o número para o app ou site do foodpanda que você está testando.
4. Acompanhe o cartão da ativação; o código aparece ali quando o SMS chega.

A janela de ativação é de 20 minutos. Se o foodpanda nunca enviar um código, ou se você cancelar, o valor volta para a sua carteira automaticamente, então você só paga pelos códigos que chegam.

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

Algumas causas explicam quase todas as falhas. O foodpanda, como muitos apps de consumo, pode recusar números virtuais em alguns mercados ou para algumas ações. Ele também pode limitar a frequência com que um mesmo dispositivo, IP ou conta pode pedir um código. E rotas individuais podem ficar congestionadas em certos momentos.

Hábitos úteis para a verificação por SMS do foodpanda em testes:

• Espere a janela inteira antes de cancelar.
• Espace as novas tentativas em vez de pedir de novo em loop apertado.
• Experimente outra rota de país se o caso de teste permitir.
• Use o modo sandbox em uma conta de desenvolvimento enquanto monta o pipeline, para não gastar pedidos reais com bugs de infraestrutura.

Nenhuma rota consegue obrigar um serviço a aceitar um número; o reembolso automático existe justamente para essa situação.

Quando um Número Dedicado é mais adequado, e quais são as regras básicas?

Um número de uso único do Gateway não consegue receber um segundo código depois. Se uma conta de staging ou QA precisa fazer login de novo daqui a semanas, um número virtual para o foodpanda que você mantém faz mais sentido: os Números Virtuais Dedicados estão disponíveis nos Estados Unidos e no Canadá, a partir de $1.95/month, com SMS de entrada no painel e no seu webhook. Em outros lugares não há número de longo prazo self-service; escreva para [email protected] e pergunte. Veja números virtuais para mais detalhes.

Use o OTP Route apenas para seus próprios produtos e contas legítimas: uma conta por pessoa real ou empresa, sempre dentro dos termos do foodpanda e da Política de Uso Aceitável do OTP Route. foodpanda é marca registrada de seu titular, e o OTP Route não é afiliado a ela. O financiamento é uma carteira pré-paga em USD sem mensalidade, recarregada por cartão ou USDT/USDC, com fatura em PDF para cada recarga.

Perguntas frequentes

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

É foodpanda. Combine-o com um id de país na consulta de preços e na requisição de ativação.

Posso automatizar testes de cadastro do foodpanda no CI?

Sim. Crie uma chave por ambiente, faça o pedido pela API e aguarde o webhook activation.sms_received ou consulte a ativação por polling.

De qual país deve vir o meu número de teste do foodpanda?

Do mercado a que a conta se destina. O foodpanda se localiza por país, então alinhar o número a esse mercado evita números rejeitados e fluxos regionais errados.

Pago se o foodpanda nunca enviar o código?

Não. Um pedido do foodpanda que não recebe SMS nos seus 20 minutos, ou que você cancela, é reembolsado integralmente na carteira.

O foodpanda vai aceitar todos os números do OTP Route?

Não necessariamente. Alguns serviços rejeitam números virtuais, então a aceitação pode variar conforme o país e a ação.

O mesmo número do foodpanda pode receber um código de novo no mês que vem?

Um número do Gateway atende a uma única verificação. Para logins recorrentes, use um Número Dedicado dos EUA ou do Canadá.

Como confirmo que um webhook realmente veio do OTP Route?

Recalcule o HMAC-SHA256 sobre o timestamp e o corpo bruto com o segredo do seu endpoint, compare com o cabeçalho de assinatura e rejeite timestamps antigos.

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.