Español
Cómo reciben los equipos los códigos SMS de DiDi para pruebas y operaciones
Un equipo recibe un código de verificación de DiDi en un número de OTP Route pidiendo un número de un solo uso en el OTP Gateway con el id de servicio didi y un país, y leyendo después el código en el panel o recogiéndolo mediante polling de la API o un webhook firmado. Los precios empiezan en $0.20 por código, la cifra en tiempo real depende del país, y el cargo se devuelve al monedero si no llega nada dentro de la ventana de 20 minutos.
La situación: una cuenta de movilidad que depende de un único número de teléfono
DiDi es una plataforma de transporte con conductor y movilidad y, como la mayoría de las apps de esa categoría, trata el número móvil como el núcleo de una cuenta. Normalmente se solicita un código SMS al registrarse, cuando alguien inicia sesión en un dispositivo nuevo y durante la recuperación de la cuenta; el alta de conductores y mensajeros se apoya en la misma comprobación.
Eso genera fricción en el trabajo empresarial legítimo. Una empresa que gestiona una cuenta corporativa de pasajero no quiere que quede ligada al teléfono personal de un empleado. Una agencia que gestiona viajes para clientes necesita un paso de verificación que pueda completar alguien distinto de quien se registró originalmente. Un equipo de QA que desarrolla un producto vinculado a una cuenta de DiDi quiere ensayar el flujo sin pasarse un móvil personal por la oficina. Un número virtual para DiDi, usado una vez por verificación, mantiene esos pasos fuera de la SIM privada de cualquiera.
¿Qué países pueden aportar un número de teléfono para DiDi?
La ruta didi abarca actualmente 198 países. Los equipos suelen empezar por mercados con mucha demanda de transporte con conductor, como México, Brasil, Chile, Colombia, Perú, Argentina, Costa Rica, Panamá, República Dominicana, Ecuador, Australia, Nueva Zelanda, Japón y Hong Kong.
Elige el país con criterio. Una cuenta de pasajero que se usará en Santiago debería verificarse con un número chileno, y una prueba de regresión de la pantalla de registro mexicana necesita uno mexicano. Desajustar el país del número y el mercado de la cuenta es un motivo habitual de que una prueba pase sobre el papel pero falle con la app real. La lista completa está en países.
¿Cómo transcurre el flujo de la API de códigos de verificación de DiDi?
El flujo de DiDi usa la misma URL base que el resto de rutas, https://otproute.com/api/v1, con una clave or_live_ en la cabecera Authorization.
- Consulta
GET /api/v1/prices?country=<id>&service=didipara ver si la ruta está abierta y cuánto cuesta ahora mismo. - Haz el pedido con
POST /api/v1/activationsy un cuerpo como{"service": "didi", "country": "mx"}. - Introduce el número devuelto en la pantalla de DiDi que estás probando y solicita el SMS.
- Lee el código desde el webhook, o haz polling a
GET /api/v1/activations/{id}hasta que aparezca. - Si la prueba de reserva de viaje se abandona a medias, libera el número con
POST /api/v1/activations/{id}/cancel.
Una cuenta puede tener hasta 10 claves y 5 endpoints de webhook, dentro de 300 solicitudes por minuto.
¿Cómo debe escribirse un handler de webhook para DiDi?
Suscríbete a activation.sms_received, y también a activation.expired y activation.cancelled para que tu prueba sepa cuándo dejar de esperar. Cada entrega lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>; recalcula HMAC-SHA256 sobre "<t>.<raw body>" con el secreto del endpoint, compara en tiempo constante y descarta todo lo que tenga una marca de tiempo caducada.
Los eventos se identifican por el id de activación, así que guarda ese id al hacer el pedido y trata una segunda entrega para el mismo id como una operación sin efecto. Esa idempotencia importa porque un webhook reintentado nunca debe enviar un código de DiDi dos veces. Si los webhooks entrantes resultan complicados en tu entorno, el polling del endpoint de activación también funciona. El artículo sobre la captura de OTP basada en webhooks compara ambos enfoques.
Recibir un OTP de DiDi desde el panel
El personal de operaciones puede prescindir por completo de la API. Inicia sesión, recarga el monedero, abre el OTP Gateway, busca DiDi, elige el país que coincida con la cuenta y revisa el precio mostrado antes de confirmar. El número aparece en una tarjeta de activación, y el código aparece allí en cuanto DiDi lo envía. La activación permanece abierta durante 20 minutos.
¿Por qué podría no llegar un código de DiDi?
Varias causas corrientes explican una activación vacía:
- DiDi, como muchas plataformas, puede rechazar números virtuales en algunas rutas o en algunos momentos.
- La ruta del país elegido puede estar ocupada; la disponibilidad se mueve a lo largo del día.
- La app puede limitar las solicitudes repetidas desde el mismo dispositivo o sesión durante las pruebas.
La solución es paciente, no agresiva. Deja que termine la ventana, prueba más tarde o con otro país que siga encajando con la prueba, y evita volver a pedir en un bucle rápido. Nunca pagas por un fallo: cuando se cierra la ventana o cancelas, el importe completo vuelve automáticamente al monedero.
¿Cuándo debe una cuenta de DiDi estar en un número dedicado y qué reglas se aplican?
Una activación de un solo uso sirve para una única verificación. Si la misma cuenta de DiDi debe volver a iniciar sesión el mes que viene, por ejemplo una cuenta de pasajero de staging o un acceso corporativo compartido, un número dedicado mantiene la línea bajo tu control. Se ofrecen solo en Estados Unidos y Canadá, desde $1.95/month, con SMS entrantes en el panel y en tu webhook. Consulta números virtuales para más detalles.
Usa OTP Route solo para probar y operar tus propios productos y cuentas legítimos. Cumple las condiciones de DiDi, mantén una cuenta por persona real o empresa y ten en cuenta que se aplica la Política de Uso Aceptable de OTP Route. OTP Route no tiene ninguna afiliación con DiDi, cuyo nombre es una marca registrada de su titular.
Preguntas frecuentes
¿Cuál es el id de servicio para la verificación por SMS de DiDi en pruebas?
Usa didi en el campo service, junto con el id de país del mercado que estás probando.
¿Puedo recibir un OTP de DiDi para una cuenta mexicana sin una SIM mexicana?
Sí, si la ruta de México está abierta: pide un número con país mx y servicio didi, y lee el código por API o en el panel.
¿Pago si DiDi nunca envía el código?
No. Una activación sin ningún SMS en 20 minutos, o una que canceles, se reembolsa íntegra al monedero.
¿DiDi acepta todos los números virtuales?
No necesariamente. Algunas rutas pueden ser rechazadas, así que reintenta más tarde o usa otro país adecuado.
¿Puedo probar la integración con DiDi sin gastar fondos del monedero?
Sí. Una cuenta de desarrollo puede pasarse a sandbox bajo petición, lo que devuelve números y códigos simulados para pruebas de extremo a extremo.
¿Cómo pago las activaciones de DiDi?
Recarga un monedero prepago en USD con tarjeta o con USDT/USDC; no hay cuota mensual y cada recarga incluye una factura en PDF. Las tarifas actuales están en la página de precios.
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.