Cómo gestionar la verificación por SMS de Mercado Libre en flujos de prueba y operaciones

La situación: construir sobre un marketplace con muchos sitios regionales

Mercado Libre opera sitios regionales independientes por toda Latinoamérica, y una integración para vendedores, un panel de logística o una herramienta de monitorización de precios suele tener que probarse contra varios de ellos. Cada cuenta de prueba está ligada a un país y, tarde o temprano, cada una pide un número de teléfono. Los equipos que dependen de los teléfonos del personal acaban con números personales asociados a cuentas de empresa y con pruebas bloqueadas a la espera de quien esté despierto.

Un número virtual para Mercado Libre de OTP Route ofrece a QA y operaciones un camino más limpio: un número en el mercado correcto, un código capturado por API y ninguna SIM personal de por medio. Los equipos de marketplaces pueden leer más en marketplaces.

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

Como la mayoría de los grandes marketplaces, Mercado Libre usa la verificación telefónica en unos pocos puntos previsibles: al crear una cuenta, al iniciar sesión desde un dispositivo desconocido, durante la recuperación de la cuenta y al cambiar datos de seguridad. El SMS lleva un código numérico corto, normalmente en español, o en portugués en el sitio brasileño, Mercado Livre. Tu prueba debería extraer los dígitos en lugar de comparar el texto del mensaje, porque la redacción puede cambiar en cualquier momento.

¿Qué países pueden proporcionar un número de teléfono para Mercado Libre?

El servicio mercado está disponible actualmente en rutas de 201 países. Los que más eligen los equipos coinciden con la presencia del propio marketplace: Argentina, Brasil, México, Colombia, Chile, Uruguay, Perú, Ecuador, Bolivia, Paraguay, Venezuela, Costa Rica, Panamá, Guatemala, El Salvador, Honduras, República Dominicana y Estados Unidos.

La elección del país no es cosmética. Una cuenta registrada en un sitio regional suele esperar un número de ese mercado, así que elige la ruta que corresponda al caso de prueba. La disponibilidad cambia a lo largo del día; consulta GET /api/v1/countries antes de cada ejecución.

¿Cómo funciona la API de código de verificación de Mercado Libre?

Usa una clave Bearer de la consola para desarrolladores (prefijo or_live_) contra https://otproute.com/api/v1:

1. Consulta el precio, por ejemplo GET /api/v1/prices?country=ar&service=mercado.
2. Crea la activación con POST /api/v1/activations y {"service": "mercado", "country": "ar"}.
3. Introduce el número devuelto en la pantalla de verificación de Mercado Libre.
4. Recibe el evento activation.sms_received o consulta GET /api/v1/activations/{id} por polling.

Con webhooks, valida X-OTPRoute-Signature (HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint), rechaza las marcas de tiempo antiguas y haz el manejador idempotente: usa el id de la activación como clave para que una entrega reintentada no pueda enviar dos veces el mismo código. El polling encaja con scripts cortos; los webhooks, con CI. Planifica tu matriz de pruebas del marketplace teniendo en cuenta los límites por cuenta: 10 claves, 5 endpoints de webhook, 300 solicitudes por minuto. Consulta la documentación y la guía de captura de OTP por webhook.

¿Sin integración? En el panel, elige Mercado Libre y un país, haz el pedido, pega el número y espera el código en pantalla.

¿Por qué puede no llegar un código de Mercado Libre?

Los marketplaces protegen con cuidado el registro y el inicio de sesión, y Mercado Libre puede rechazar algunos números virtuales. La entrega también depende de la ruta y del momento. Cada activación tiene una ventana de 20 minutos: si no llega ningún SMS, o si cancelas, el cargo completo vuelve automáticamente a tu monedero.

• Espera a que termine la ventana antes de reintentar.
• Inténtalo de nuevo más tarde, o cambia a otra ruta de país que siga encajando con tu prueba.
• Deja pasar tiempo entre intentos en lugar de volver a pedir en bucle.

Cómo reducir los fallos en la entrega de OTP profundiza en el tema.

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

Los números del gateway sirven para una verificación cada uno. Si una cuenta interna tiene que volver a iniciar sesión semanas después, por ejemplo un acceso de operaciones que Mercado Libre vuelve a verificar en dispositivos nuevos, una línea persistente evita perder el acceso. Los Dedicated Virtual Numbers se ofrecen solo en Estados Unidos y Canadá, desde $1.95/month, con SMS entrantes en el panel y en tu webhook. Sirven para cuentas que ya aceptan un número estadounidense o canadiense; para otros mercados, escribe a [email protected] para preguntar qué es posible.

Uso responsable y facturación

OTP Route sirve para probar tu propio producto y operar cuentas legítimas. Respeta las condiciones de Mercado Libre, mantén una cuenta por persona real o empresa y no uses números para crear perfiles de vendedor duplicados ni para reclamar promociones repetidamente. Se aplica la Política de Uso Aceptable, y Mercado Libre es una marca registrada de su titular, sin que se implique afiliación alguna.

El pago se hace con un monedero prepago en USD sin cuota mensual, que se recarga con tarjeta o USDT/USDC, con una factura en PDF por cada recarga. Pide a soporte que pase una cuenta de desarrollo a sandbox si quieres códigos simulados de Mercado Libre mientras montas la integración.

Preguntas frecuentes

¿Puedo recibir un OTP de Mercado Libre a través de una API?

Sí. Crea una activación con el servicio mercado y un id de país, y lee el código por polling o con el webhook activation.sms_received.

¿Qué país debería elegir para una cuenta de prueba de Mercado Libre?

Elige el mercado en el que está registrada la cuenta, como Argentina, Brasil o México, para que el número coincida con lo que espera ese sitio regional.

¿Mercado Libre acepta números virtuales?

No siempre. Si no llega ningún código en 20 minutos, el importe se reembolsa y puedes intentarlo más tarde o por otra ruta.

¿Cuánto cuesta la verificación por SMS de Mercado Libre para pruebas?

Desde $0.20 por código; el precio exacto depende del país y lo muestra GET /api/v1/prices antes de pedir.

¿Puedo conservar el mismo número para futuros inicios de sesión en Mercado Libre?

Los números del gateway son de un solo uso. Un Dedicated Number en EE. UU. o Canadá puede conservarse mientras se renueva, si la cuenta acepta un número así.

¿Cómo evito que mi webhook procese dos veces el mismo código?

Guarda el id de la activación cuando llegue el primer evento e ignora las repeticiones de ese id después de verificar la firma.

¿Puedo abrir varias cuentas de Mercado Libre con números de OTP Route?

Solo cuando cada cuenta pertenezca a una persona real o a una empresa y las condiciones de Mercado Libre lo permitan. No se permiten cuentas duplicadas ni promocionales.

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.