Captura de códigos SMS de foodpanda con una API, webhooks o el panel

¿Qué llamadas de la API permiten obtener un código de foodpanda?

El flujo de la API de códigos de verificación de foodpanda usa el id de servicio foodpanda y cinco llamadas a https://otproute.com/api/v1, cada una autenticada con una clave Bearer que empieza por or_live_.

1. GET /api/v1/countries te da los ids de país; guarda el resultado en caché.
2. GET /api/v1/prices?country=<id>&service=foodpanda devuelve el precio actual e indica si ese mercado puede atenderse en este momento.
3. POST /api/v1/activations con {"service": "foodpanda", "country": "<id>"} crea el pedido y devuelve un id de activación y un número de teléfono.
4. Tu prueba introduce ese número en la pantalla de foodpanda que se está ejercitando, y el código se captura por webhook o con GET /api/v1/activations/{id}.
5. POST /api/v1/activations/{id}/cancel cierra un pedido que tu prueba ya no necesita.

Añade GET /api/v1/balance al paso de preparación para que una suite se detenga limpiamente si el monedero está vacío. Las claves se crean en la consola de desarrollador, hasta 10 por cuenta, y el límite es de 300 solicitudes por minuto. La documentación para desarrolladores detalla los formatos de solicitud y de error.

¿Cómo conviene escribir el manejador del webhook?

El envío por push es la opción más ordenada cuando se ejecutan varias pruebas a la vez. Apunta uno de tus cinco endpoints permitidos a una ruta de tu entorno de pruebas y suscríbelo a activation.sms_received, activation.expired y activation.cancelled para los pedidos de foodpanda.

Cada entrega incluye X-OTPRoute-Signature: t=<unix>,v1=<hex>. Calcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compáralo con v1 en tiempo constante y rechaza las solicitudes cuya marca de tiempo sea demasiado antigua. Hazlo sobre los bytes en bruto, antes de que ningún análisis JSON los altere.

Haz que el manejador sea idempotente: identifica cada evento por su id de activación e ignora los repetidos, porque los reintentos pueden entregar el mismo evento dos veces. Responde rápido y pasa el código a lo que esté esperando tu prueba. Para scripts rápidos, consultar el endpoint de activación cada pocos segundos es una alternativa razonable. La guía de webhooks con HMAC cubre los casos límite.

¿Para qué verifica foodpanda un número de teléfono?

foodpanda es una plataforma de reparto de comida y compra, conocida sobre todo en el sur y el sudeste de Asia. Como la mayoría de las apps de reparto, asocia la cuenta a un número móvil: normalmente se confirma con un código SMS de un solo uso al registrarse, puede volver a comprobarse al iniciar sesión en un dispositivo nuevo y da a repartidores y soporte una forma de contactar con el cliente por un pedido.

Para equipos de socios, agencias y desarrolladores que trabajan en torno a la plataforma, esto significa que el paso de recibir un OTP de foodpanda está presente en muchos recorridos reales: dar de alta a un cliente nuevo, probar una pantalla de registro localizada o reproducir un problema de acceso que reportó un usuario. Disponer de un número de teléfono de foodpanda controlable para cada prueba evita tener que pedir prestada la SIM personal de un compañero.

¿Qué países pueden proporcionar un número de foodpanda?

La ruta de foodpanda está disponible en 198 países. Algunos ejemplos son Pakistán, Bangladés, Malasia, Filipinas, Taiwán, Singapur, Hong Kong, Tailandia, Camboya, Laos, Myanmar, Alemania, el Reino Unido y Estados Unidos.

Elegir país no es un detalle cosmético. Las apps de reparto se localizan por mercado, de modo que una prueba de la pantalla de registro de Bangladés debe usar un número bangladesí, y una cuenta pensada para pedir en Kuala Lumpur debe corresponder a Malasia. Un país que no encaja puede provocar el rechazo del número o llevar a un flujo regional distinto. La disponibilidad en vivo por país cambia durante el día, por eso el endpoint de precios es la fuente de verdad. La guía de enrutamiento por país explica cómo elegir y cómo pasar de un mercado a otro como alternativa.

¿Puede una persona sin perfil técnico hacerlo desde el panel?

Sí, y requiere más o menos los mismos clics que pedir la comida:

1. Abre el OTP Gateway, elige foodpanda como servicio y selecciona el país.
2. Revisa el precio mostrado y confirma el pedido.
3. Copia el número en la app o el sitio web de foodpanda que estás probando.
4. Observa la tarjeta de activación; el código aparece ahí cuando llega el SMS.

La ventana de activación es de 20 minutos. Si foodpanda nunca envía un código, o si cancelas, el cargo vuelve automáticamente a tu monedero, de modo que solo pagas por los códigos que llegan.

¿Por qué podría no llegar un código de foodpanda?

Unas pocas causas explican casi todos los fallos. foodpanda, como muchas apps de consumo, puede rechazar números virtuales en algunos mercados o para ciertas acciones. También puede limitar la frecuencia con la que un mismo dispositivo, IP o cuenta puede solicitar un código. Y algunas rutas pueden estar saturadas en determinados momentos.

Hábitos útiles para la verificación por SMS de foodpanda en pruebas:

• Espera la ventana completa antes de cancelar.
• Espacia los reintentos en lugar de pedir de nuevo en un bucle apretado.
• Prueba otra ruta de país si el caso de prueba lo permite.
• Usa el modo sandbox en una cuenta de desarrollo mientras construyes el pipeline, para no gastar pedidos reales en errores de fontanería.

Ninguna ruta puede obligar a un servicio a aceptar un número; el reembolso automático existe precisamente para esa situación.

¿Cuándo encaja mejor un número dedicado y cuáles son las reglas básicas?

Un número de un solo uso del Gateway no puede recibir un segundo código más adelante. Si una cuenta de staging o de QA tiene que volver a iniciar sesión dentro de unas semanas, tiene más sentido un número virtual de foodpanda que conserves: los números virtuales dedicados están disponibles en Estados Unidos y Canadá, desde $1.95/month, con SMS entrantes en el panel y en tu webhook. En otros países no hay un número de largo plazo de autoservicio; escribe a [email protected] para consultarlo. Consulta números virtuales para más detalles.

Usa OTP Route solo para tus propios productos y cuentas legítimas: una cuenta por persona o negocio reales, y siempre dentro de los términos de foodpanda y de la Política de uso aceptable de OTP Route. foodpanda es una marca registrada de su titular, y OTP Route no está afiliado a ella. La financiación se hace con un monedero prepago en USD, sin cuota mensual, que se recarga con tarjeta o con USDT/USDC, con factura en PDF por cada recarga.

Preguntas frecuentes

¿Cuál es el id de servicio de foodpanda en la API de OTP Route?

Es foodpanda. Combínalo con un id de país en la consulta de precios y en la solicitud de activación.

¿Puedo automatizar pruebas de registro de foodpanda en CI?

Sí. Crea una clave por entorno, haz el pedido a través de la API y espera el webhook activation.sms_received o consulta la activación.

¿De qué país debe ser mi número de prueba de foodpanda?

Del mercado para el que está pensada la cuenta. foodpanda se localiza por país, así que hacer coincidir el número con ese mercado evita números rechazados y flujos regionales equivocados.

¿Pago si foodpanda nunca envía el código?

No. Un pedido de foodpanda que no recibe SMS en sus 20 minutos, o que cancelas, se reembolsa por completo al monedero.

¿Aceptará foodpanda todos los números de OTP Route?

No necesariamente. Algunos servicios rechazan números virtuales, así que la aceptación puede variar según el país y la acción.

¿Puede el mismo número de teléfono de foodpanda recibir un código otra vez el mes que viene?

Un número del Gateway sirve para una sola verificación. Para inicios de sesión repetidos, usa un número dedicado de EE. UU. o Canadá.

¿Cómo compruebo que un webhook realmente viene de OTP Route?

Recalcula HMAC-SHA256 sobre la marca de tiempo y el cuerpo en bruto con el secreto de tu endpoint, compáralo con la cabecera de firma y rechaza las marcas de tiempo antiguas.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.