Cómo llevar el código SMS de Mercado Pago a tu ejecución de pruebas

¿Qué problema resuelven los equipos en el paso del teléfono de Mercado Pago?

Mercado Pago, la plataforma de pagos y monedero digital de Mercado Libre, forma parte del comercio cotidiano en toda Latinoamérica. Como la mayoría de las apps financieras, vincula la cuenta a un número de teléfono: un código por SMS confirma el número al registrarse, y la app puede pedir un código nuevo cuando alguien inicia sesión en un dispositivo nuevo o recupera el acceso. Para los equipos que construyen sobre ella, como comercios que integran el checkout, agencias que operan la cuenta de vendedor de un cliente o ingenieros de QA que prueban un marketplace que ofrece Mercado Pago en el pago, ese paso del SMS suele ser el más incómodo. El personal acaba poniendo teléfonos personales en cuentas de empresa, o un caso de prueba se queda parado porque la única persona que tiene la SIM adecuada está desconectada.

OTP Route convierte ese paso en algo que tus herramientas pueden gestionar: un número a demanda para el mercado que necesites, con el código entregado a tus sistemas. Esa es la base de la verificación por SMS de Mercado Pago para pruebas.

¿Cómo funciona el flujo de la API de código de verificación de Mercado Pago?

Todas las solicitudes van a https://otproute.com/api/v1 con una clave Bearer (prefijo or_live_) de la consola para desarrolladores. El id del servicio es mercado_pago; el id del país es el valor api_country de tu mercado, por ejemplo br para Brasil o mx para México.

1. GET /api/v1/prices?country=br&service=mercado_pago devuelve el precio y la disponibilidad en vivo para esa combinación.
2. POST /api/v1/activations con {"service": "mercado_pago", "country": "br"} devuelve el id de la activación y el número.
3. Introduce el número en el paso del teléfono de la cuenta que estás configurando o probando.
4. Recoge el código cuando activation.sms_received llegue a tu endpoint, o consultando GET /api/v1/activations/{id} por polling.
5. Si la ejecución termina antes, llama a POST /api/v1/activations/{id}/cancel.

Usa GET /api/v1/balance como comprobación previa. Cada cuenta dispone de 10 claves, 5 endpoints de webhook y 300 solicitudes por minuto; todo lo demás está en la documentación.

¿Cómo debe tratar el manejador del webhook los códigos de Mercado Pago?

La entrega por push evita que los test runners queden atrapados en bucles de polling. Cada evento llega con X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcula el HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint, compara en tiempo constante y descarta las solicitudes con marcas de tiempo antiguas. Después, haz el manejador idempotente: guarda el id de la activación e ignora una segunda entrega del mismo evento, porque los reintentos ocurren. Escucha también activation.expired y activation.cancelled, para que el runner libere su hueco y marque la prueba para otro intento. Si prefieres no alojar un endpoint, consultar la activación por polling cada pocos segundos queda muy por debajo del límite de frecuencia. Cómo proteger los webhooks de OTP incluye una lista de comprobación más completa.

¿De qué país debe ser el número de Mercado Pago?

El servicio mercado_pago figura en 201 países en OTP Route, pero la elección útil casi siempre es el mercado al que pertenece la cuenta. Mercado Pago es más conocido en Brasil, Argentina, México, Chile, Colombia, Uruguay y Perú, así que ahí se concentran la mayoría de los casos de prueba. El catálogo llega además a Ecuador, Bolivia, Paraguay, Costa Rica, Panamá, República Dominicana, España, Portugal y Estados Unidos, entre muchos otros.

Un número del país equivocado puede fallar la validación o provocar comprobaciones adicionales, y no te dice nada sobre cómo viven el flujo los usuarios reales de ese mercado. Ajústate al caso de prueba: el alta en Brasil, con un número brasileño; el alta en Chile, con uno chileno.

¿Qué puedo hacer desde el panel en su lugar?

Quien no desarrolla llega al mismo resultado sin código. Abre el OTP Gateway, elige Mercado Pago como servicio, elige el país y revisa el precio que se muestra antes de pedir. Copia el número en la app, solicita el SMS y el código aparece en la tarjeta de la activación en cuanto se entrega. El número se mantiene 20 minutos; si no llega nada, no se cobra nada, ya que el importe vuelve automáticamente a tu monedero.

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

Las plataformas de pago son cuidadosas con los números de teléfono, y un número virtual para Mercado Pago puede ser rechazado en algunos flujos o en todos. Las rutas también cambian a lo largo del día. Si el código no aparece:

• Deja que termine la ventana de 20 minutos; el reembolso es automático.
• Evita volver a pedir en bucle rápido. Espacia los intentos o vuelve más tarde.
• Prueba otra ruta para el mismo mercado si una sigue caducando.
• Comprueba que el campo del teléfono recibió el número en el formato que espera la app.

Cuando un flujo rechaza sistemáticamente los números virtuales, acepta ese resultado y usa una línea real para esa cuenta. Cómo reducir los fallos en la entrega de OTP cubre el diagnóstico más amplio.

¿Cuándo tiene más sentido un número dedicado?

Un número de un solo uso gestiona un único código. Una cuenta de empresa que pedirá un código nuevo dentro de unos meses necesita un número que sigas controlando. Los Dedicated Numbers de OTP Route cumplen ese papel en Estados Unidos y Canadá, desde $1.95/month: SMS entrantes en el panel y en tu webhook (number.sms_received), SMS salientes y llamadas desde el navegador, con renovación desde el monedero hasta que liberes la línea. Fuera de esos dos países no hay una línea de largo plazo de autoservicio; escribe a [email protected] para preguntar, y la disponibilidad depende de la normativa local. Consulta números virtuales para más detalles.

¿Qué normas se aplican al usar estos números con Mercado Pago?

Mercado Pago mueve dinero real, y sus comprobaciones de identidad existen por buenas razones. Un número de teléfono de OTP Route no sustituye esas comprobaciones y nunca debe usarse para esquivarlas: completa la verificación de identidad con datos auténticos, mantén una cuenta por persona real o empresa y respeta las condiciones de Mercado Pago junto con la Política de Uso Aceptable de OTP Route. La plataforma sirve para probar tu propio producto y operar tus propias cuentas legítimas, no para abrir cuentas en volumen ni para reclamar promociones. La facturación es de pago por uso desde un monedero prepago en USD (tarjeta o USDT/USDC, con una factura en PDF por cada recarga), y hay un sandbox con códigos simulados disponible a petición para las pruebas de integración. Mercado Pago es una marca registrada de su titular, y OTP Route no está afiliada a ella.

Preguntas frecuentes

¿Puedo recibir un OTP de Mercado Pago sin una SIM local en Brasil o México?

Sí, cuando pruebas u operas tu propia cuenta. Pide un número mercado_pago del país adecuado y lee el código en el panel, por la API o por un webhook.

¿Cuál es el id de servicio de Mercado Pago en la API?

Es mercado_pago. Combínalo con el id del país en el cuerpo de POST /api/v1/activations.

¿Mercado Pago acepta números virtuales?

No siempre. Puede rechazarlos en algunos flujos, y por eso se reembolsa el importe completo cuando no llega ningún código en 20 minutos.

¿Cuánto cuesta un número de teléfono de Mercado Pago para la verificación?

Desde $0.20 por código. El precio exacto depende del país y lo muestran la API y el panel antes de pedir.

¿Puedo usar el mismo número de un solo uso para volver a iniciar sesión el mes que viene?

No. Un número de un solo uso recibe un único código. Las cuentas que necesitan inicios de sesión repetidos se atienden mejor con un Dedicated Number de EE. UU. o Canadá.

¿Puede mi pipeline de CI ejecutar el flujo de Mercado Pago sin cargos reales?

Sí. Pide el modo sandbox en una cuenta de desarrollo; devuelve números y códigos simulados a través de los mismos endpoints.

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.