Captura de códigos SMS de Vinted en números de OTP Route a través de la API

¿Cuál es la secuencia de la API para una activación de Vinted?

El flujo de la API de códigos de verificación de Vinted usa los mismos endpoints del OTP Gateway que cualquier otro servicio, bajo https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_:

1. Confirma el id de servicio con GET /api/v1/services; para Vinted es vinted. Obtén los ids de país con GET /api/v1/countries.
2. Llama a GET /api/v1/prices?country=<id>&service=vinted para ver el precio actual y si hay números disponibles para esa combinación.
3. Haz el pedido con POST /api/v1/activations y un cuerpo como {"service": "vinted", "country": "fr"}. Guarda el id de activación y el número devuelto.
4. Escribe el número en el paso de teléfono de Vinted de tu cuenta de prueba y espera el código.
5. Si el escenario se abandona, POST /api/v1/activations/{id}/cancel devuelve los fondos de inmediato.

Las claves se crean en la consola de desarrollador, hasta 10 por cuenta, y la API admite 300 solicitudes por minuto. GET /api/v1/balance es una llamada barata de comprobación previa para un job de CI. La página de desarrolladores reúne el material de referencia en un solo lugar.

¿Cómo debe procesar un manejador de webhook los códigos de Vinted?

Suscribe un endpoint (se permiten cinco por cuenta) a activation.sms_received, y también a activation.expired y activation.cancelled, para que los jobs en espera puedan terminar limpiamente. Cada entrega incluye X-OTPRoute-Signature: t=<unix>,v1=<hex>.

• Calcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint y compáralo con v1 en tiempo constante.
• Descarta las solicitudes con marcas de tiempo antiguas para bloquear los ataques de repetición.
• Registra cada evento con el id de activación como clave, de modo que una segunda entrega del mismo evento no cambie nada.
• Responde primero con un 2xx y pasa el trabajo lento a una cola.

El sondeo es la alternativa más simple para una sola prueba: llama a GET /api/v1/activations/{id} cada pocos segundos hasta que aparezca el código o termine la activación. Nuestra guía sobre cómo proteger los webhooks de OTP con HMAC muestra la comprobación de la firma en detalle.

¿Cuándo pide Vinted un número de teléfono?

Vinted es un marketplace de ropa de segunda mano y otros artículos usados, organizado en sitios por país, sobre todo en Europa. Como muchos marketplaces, puede pedir a los miembros que añadan y confirmen un número de teléfono de Vinted, por ejemplo durante la configuración de la cuenta, cuando un inicio de sesión procede de un dispositivo desconocido o antes de cambiar datos sensibles de la cuenta. Los avisos exactos varían según el mercado y cambian con el tiempo, así que conviene tratar cualquier plan de pruebas como algo que hay que revisar después de que Vinted actualice su app.

Para los equipos que construyen en torno a Vinted, como herramientas para vendedores, agencias que gestionan la tienda propia de una marca o ingenieros de QA que revisan una integración, la verificación por SMS de Vinted para pruebas consiste simplemente en llevar ese único código a un número que controlas.

¿Qué países puedo elegir para un número de Vinted?

Los números de Vinted figuran en 198 países. Entre las opciones europeas están Francia, Alemania, Reino Unido, España, Italia, Polonia, Lituania, los Países Bajos, Bélgica, la República Checa, Portugal, Austria, Suecia, Irlanda y Rumanía, y la lista completa de GET /api/v1/countries va mucho más allá de Europa.

En un marketplace, el país del número pesa más que en una app de mensajería. Elige un número del mismo mercado que la cuenta que estás probando, porque un perfil de Vinted pertenece al sitio de un solo país, y un número de otro lugar puede ser rechazado o simplemente resultar extraño para el usuario. Nuestro artículo sobre el enrutamiento por país en OTP explica cómo asignar casos de prueba a rutas.

¿Puedo recibir un OTP de Vinted desde el panel?

Sí. Inicia sesión, recarga el monedero, abre el OTP Gateway y elige Vinted junto con el país de la cuenta. El precio se muestra antes de confirmar. Copia el número en Vinted y el código aparece en la página de la activación en cuanto llega. Es el mismo pedido que crearía una llamada a la API, por lo que los resultados de las comprobaciones manuales y automáticas son comparables.

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

Cada activación está abierta durante 20 minutos. Si no llega ningún SMS en ese tiempo, o si cancelas, el importe completo vuelve automáticamente a tu monedero.

Las causas habituales de un código que no llega:

• Números virtuales rechazados. Vinted, como muchas plataformas, puede rechazar un número virtual para la verificación telefónica. Ninguna ruta lo cambia, y por eso existe el reembolso.
• Entrega lenta. El tiempo depende de la ruta, así que deja correr la ventana antes de rendirte.
• Poca disponibilidad. Reintenta un poco más tarde, o con otro país que siga encajando con tu prueba.
• Tormentas de reintentos. Repetir pedidos en un bucle apretado rara vez ayuda; espera entre intentos y registra cada id de activación.

¿Es alguna vez mejor un número de largo plazo para trabajar con Vinted?

Un número de un solo uso gestiona un código. Si una cuenta de prueba debe iniciar sesión de nuevo más adelante, o un equipo de operaciones necesita recibir avisos de la cuenta en una línea estable, un número dedicado es la mejor herramienta, pero solo se vende para Estados Unidos y Canadá, desde $1.95/month, con SMS entrantes en el panel y en el webhook number.sms_received. Como la mayoría de los mercados de Vinted son europeos, eso solo ayuda cuando un número estadounidense o canadiense encaja realmente con la cuenta. La comparación entre números temporales y dedicados cubre este equilibrio.

¿Cómo usamos los números de Vinted de forma responsable?

Respeta los términos de Vinted. Mantén una cuenta por persona o negocio reales, y usa un número virtual para Vinted solo en cuentas y productos que sean realmente tuyos, como cuentas de prueba de tu propia integración o la tienda propia del negocio. OTP Route no sirve para crear cuentas a gran escala ni para esquivar las decisiones de una plataforma, y su Política de uso aceptable se aplica a cada pedido. Vinted es una marca registrada de su titular, y OTP Route no tiene ninguna afiliación con ella.

Preguntas frecuentes

¿Qué id de servicio usa OTP Route para Vinted?

Usa vinted en GET /api/v1/prices y en el cuerpo de POST /api/v1/activations.

¿Cuánto cuesta recibir un OTP de Vinted?

Desde $0.20 por código; el precio exacto depende del país y lo devuelve la API en vivo y se muestra en el panel.

¿Se me cobra si Vinted rechaza el número?

No. Si no llega ningún código en 20 minutos o cancelas, el importe completo se reembolsa a tu monedero.

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

Debe coincidir con el sitio de país de la cuenta que estás probando, para que el número encaje con el mercado al que pertenece el perfil.

¿Puedo probar mi integración con Vinted sin gastar fondos del monedero?

Sí. Pide el modo sandbox en una cuenta de desarrollo y la API devolverá números y códigos simulados para ejecutar el flujo de extremo a extremo.

¿Puedo pagar los números de verificación de Vinted con criptomonedas?

El monedero prepago en USD acepta pagos con tarjeta y con las stablecoins USDT/USDC, con una factura en PDF por correo por cada recarga y sin cuota mensual.

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.