Mercado Pago: OAuth, PIX y el token de 6 meses

Como en Stripe, no pegas ninguna credencial en MMNWEB. Autorizas a la aplicación de Fragasoft a cobrar en tu cuenta, y Mercado Pago devuelve un token a nuestro servidor. Pero MP tiene una particularidad que ya tumbó el split de mucha gente — y está al final de esta página.

Los tipos de credencial de Mercado Pago

Cada par es único por aplicación (vinculado a la aplicación creada, no a una cuenta genérica). Y hay dos conjuntos: prueba y producción. Las de prueba vienen ya activas; las de producción deben ser activadas, completando los datos del negocio (incluido el rubro).

Quién tiene qué, en MMNWEB

Fragasoft mantiene la aplicación de plataforma en Mercado Pago y guarda Client ID, Client Secret y el secreto de webhook — credenciales globales, cifradas en reposo, que nunca van al navegador ni al repositorio. Tú mantienes tu cuenta Mercado Pago y no nos entregas Public Key ni Access Token manualmente. Al autorizar, MP entrega a nuestro servidor un conjunto ligado a ti: access_token, refresh_token, user_id (tu ID de receptor) y public_key — almacenados cifrados (AES-256-GCM) y usados solo para cobrar en tu nombre.

Cómo conectar, paso a paso

1. En el panel de MMNWEB, ve a la configuración de pagos de tu proyecto.
2. Haz clic en "Conectar mi cuenta Mercado Pago".
3. Se te lleva a Mercado Pago. Inicia sesión en tu cuenta y autoriza la aplicación.
4. MP redirige de vuelta y MMNWEB guarda la autorización.
5. Verifica el estado: el PIX solo aparece en el checkout cuando esté listo.

⚠️ La trampa: el token del vendedor expira en 6 meses

El access_token que MP emite para el vendedor tiene validez de 180 días (el campo expires_in devuelve 15.552.000 segundos). Junto a él viene un refresh_token, hecho exactamente para renovar el acceso antes del vencimiento. Si el token vence sin renovación, el split de ese comercio simplemente se detiene — no es una falla ruidosa; es un cobro que deja de ser autorizado.

MMNWEB renueva automáticamente antes del vencimiento — no tienes que hacer nada. Pero debes saber que esto existe, por dos motivos:

Cómo funciona el split

El cobro PIX ocurre dentro de MMNWEB, en tu cuenta Mercado Pago. La comisión de la plataforma se descuenta vía application_fee — el mecanismo nativo de split de MP. El dinero no pasa por la cuenta de Fragasoft: usar el split nativo es lo que mantiene la operación fuera de las exigencias regulatorias de quien custodia recursos de terceros. El porcentaje lo define Fragasoft y se configura en el sistema — tú no lo editas. Como en Stripe, vale la regla "sin proveedor listo, sin venta": el checkout solo ofrece el PIX cuando la autorización es válida y la capacidad de cobrar fue verificada de verdad.

Preguntas rápidas

¿Necesito mandar mi Access Token al soporte? No. El flujo es OAuth; el token llega directo al servidor. Si alguien pide tu Access Token por mensaje, desconfía.

El PIX se detuvo de la nada. Dos causas probables: autorización revocada en el panel de MP, o credenciales de producción renovadas manualmente. Abre un ticket antes de tocar nada.

Probé con credenciales de prueba y funcionó. Prueba y producción son conjuntos distintos. Producción debe activarse en el panel, con los datos del negocio completos.

¿Uso Mercado Pago y Stripe al mismo tiempo? Sí. En general: PIX por Mercado Pago, tarjeta por Stripe.

Fuentes oficiales

Credenciales (tipos, prueba × producción) · OAuth — Access Token, validez y refresh · Referencia de la API OAuth

Relacionados: Visión general de las integraciones · Stripe (tarjeta) · Cielo · Conceptos del motor