Cómo capturar por API los códigos de verificación telefónica de Yahoo

¿Dónde pide Yahoo un número de teléfono?

Las cuentas de Yahoo abarcan Mail, noticias, finanzas y fantasy sports bajo un único inicio de sesión, y el número de teléfono ocupa un lugar central en esa identidad. En los flujos más conocidos aparece en varios momentos:

• Creación de la cuenta, donde se solicita un número móvil y se confirma con un código enviado por SMS.
• Inicio de sesión, incluidas las opciones sin contraseña que envían un código o una notificación en lugar de pedir la contraseña.
• Recuperación, cuando alguien ha olvidado la contraseña y la cuenta recurre al teléfono registrado.
• Verificación en dos pasos, que añade un código como segundo factor después de la contraseña.

Para un equipo de QA, cada uno de esos momentos es un caso de prueba distinto. Una prueba de registro necesita un número nuevo una sola vez; una prueba de recuperación o de dos pasos necesita que el mismo número siga accesible más adelante, lo que influye en qué producto de OTP Route eliges.

¿Importa el país del número para Yahoo?

Sí importa. Yahoo se usa en todo el mundo, y un número del mercado al que pertenece tu cuenta ofrece la prueba más fiel de los textos localizados, las pantallas de registro regionales y el formato de los números. Actualmente se pueden recibir códigos de Yahoo en 198 países, entre ellos Estados Unidos, Reino Unido, Canadá, India, Filipinas, México, Brasil, Alemania, Francia, Indonesia, Nigeria, Sudáfrica, Australia, España y Taiwán.

Ajusta el país del número al caso de prueba: una agencia que gestiona el buzón de Yahoo de un cliente en Manila debería verificar con una ruta filipina, mientras que un equipo que revisa el onboarding en español aprende más con un número mexicano o español que con uno estadounidense.

¿Cómo es el flujo de la API para el id de servicio yahoo?

Las solicitudes se dirigen a https://otproute.com/api/v1 y se autentican con una clave Bearer or_live_ de la consola de desarrollador. Las cuentas pueden tener 10 claves y 5 endpoints de webhook, con un límite de 300 solicitudes por minuto.

1. Confirma cuánto vas a pagar: GET /api/v1/prices?country=gb&service=yahoo (cambia gb por cualquier id api_country).
2. Abre la activación con POST /api/v1/activations y el cuerpo {"service": "yahoo", "country": "gb"}.
3. Introduce el número devuelto en el paso de teléfono de Yahoo.
4. Recoge el código desde activation.sms_received, o haz polling a GET /api/v1/activations/{id} si todavía no tienes webhooks configurados.
5. Cancela con POST /api/v1/activations/{id}/cancel cuando abandones la prueba.

Trata el webhook con cuidado. Recalcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compáralo con v1 de X-OTPRoute-Signature: t=<unix>,v1=<hex> y rechaza las marcas de tiempo antiguas. Después haz el handler idempotente usando el id de activación como clave, para que un evento reenviado no rellene dos veces el mismo formulario de Yahoo. Cómo proteger webhooks OTP con HMAC cubre los casos límite.

¿Cómo recibo un OTP de Yahoo desde el panel?

1. Inicia sesión y abre el OTP Gateway.
2. Selecciona Yahoo y luego el país que se ajuste a tu prueba.
3. Revisa el precio en pantalla y confirma.
4. Escribe el número en Yahoo y solicita el código.
5. Lee el mensaje en la tarjeta de la activación cuando llegue.

Las reglas coinciden exactamente con las de la API: un código por activación, 20 minutos de escucha y ningún cargo si no llega nada o si cancelas.

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

Yahoo decide por su cuenta si envía un mensaje y a qué números. Puede rechazar números virtuales en algunas regiones o para ciertos tipos de cuenta, y puede ralentizar las solicitudes repetidas desde la misma sesión. Cuando falta un código:

• Deja la activación abierta durante toda su ventana; un envío retrasado todavía puede llegar.
• Prueba el mismo flujo con otra ruta de país.
• Espera un rato antes de reintentar en lugar de repetir pedidos en un bucle rápido.
• Considera un rechazo como una propiedad del servicio, no como un fallo de tu código.

El reembolso automático hace que un intento fallido no cueste nada, lo que mantiene barato el testing exploratorio.

¿Cuándo encaja mejor un número dedicado para Yahoo?

Una activación temporal termina tras un código. Está bien para pruebas de registro, pero no para un teléfono de Yahoo que debe seguir recibiendo mensajes el próximo trimestre, como la línea de recuperación de un buzón compartido de operaciones o una cuenta de staging que inicia sesión con códigos cada semana.

Para esos casos, un número dedicado conserva la misma línea mientras se renueva desde el monedero, recibe SMS en el panel y en tu webhook como number.sms_received, y cuesta desde $1.95/month. Se venden de forma inmediata solo en Estados Unidos y Canadá; la página de números virtuales compara ambos productos.

¿Cuáles son las reglas básicas para probar con Yahoo?

Usa OTP Route para probar tu propio producto o para operar cuentas legítimas que pertenezcan a una persona real o a una empresa, una cuenta por cada una. Cumple las condiciones de Yahoo y recuerda que la Política de Uso Aceptable de OTP Route se aplica a cada activación. Yahoo es una marca registrada de su titular y OTP Route no tiene ninguna afiliación con ella.

La facturación es un monedero prepago en USD sin cuota mensual, que se recarga con tarjeta o con USDT/USDC y genera una factura en PDF por cada recarga. Las cuentas de desarrollo pueden pedir el modo sandbox, que devuelve números y códigos simulados para pruebas de integración de extremo a extremo; el centro para desarrolladores incluye las notas de configuración.

Preguntas frecuentes

¿Puedo probar un flujo de registro de Yahoo sin una SIM física?

Sí. Pide un número para el servicio yahoo en OTP Route y el código aparecerá en el panel o en tu webhook. Si Yahoo no envía nada en 20 minutos, el importe completo vuelve a tu monedero.

¿Cuánto cuesta un número virtual para Yahoo?

Las activaciones empiezan en $0.20 por código, y la cifra exacta varía según el país. Llama a GET /api/v1/prices con el id del país y yahoo para verla en tiempo real.

¿Debo usar un número temporal como teléfono de recuperación de Yahoo?

No. Una activación se detiene tras un código, así que la recuperación fallaría más adelante. Un número dedicado de EE. UU. o Canadá es lo adecuado para la recuperación y los inicios de sesión repetidos.

¿Yahoo acepta cualquier número de teléfono?

No necesariamente. Yahoo puede rechazar números virtuales o limitar las solicitudes, y por eso OTP Route reembolsa las activaciones que no reciben ningún SMS.

¿Cómo evito que los eventos de webhook duplicados rompan mi prueba de Yahoo?

Guarda cada id de activación procesado e ignora las repeticiones. Verifica la firma antes de procesar nada.

¿Qué países puedo elegir para un número de teléfono de Yahoo?

Yahoo está disponible actualmente en 198 rutas de país. La lista en tiempo real se obtiene con GET /api/v1/countries y en el panel.

¿Puedo automatizar la verificación por SMS de Yahoo para pruebas en CI?

Sí. Usa la API con webhook o polling y pide el modo sandbox en una cuenta de desarrollo para que las ejecuciones del pipeline usen números y códigos simulados.

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.