Conectar Mercado Pago
Cobra con tarjeta en cuotas y PIX a través de tu cuenta de Mercado Pago, en siete países de América Latina.
Mercado Pago procesa tarjeta de crédito, tarjeta de débito y PIX (el pago instantáneo de Brasil) para cuentas abiertas en Argentina, Brasil, Chile, Colombia, México, Perú y Uruguay. Conectado a Vipter, atiende ventas únicas, cuotas con tarjeta y order bump.
Sin suscripciones y sin upsell de 1 clic
Las suscripciones y el upsell de 1 clic cobran la tarjeta guardada sin que el comprador esté presente, y la conexión con Mercado Pago no hace ese tipo de cobro. Si vendes suscripciones, conecta también otro proveedor de tarjeta, como Pagar.me o Asaas, y envíale los cobros recurrentes en los flujos de pago.
Antes de empezar
- Una cuenta de Mercado Pago y una aplicación creada en Tus integraciones, en el portal Mercado Pago Developers. Las claves están dentro de la aplicación.
- Rol Admin o Propietario en el proyecto de Vipter.
- Espacio en tu plan para una conexión activa más. La pantalla de proveedores muestra cuántas usas.
Paso 1: copiar las credenciales en Mercado Pago
Vipter acepta dos formas de autenticación: el Access Token con la Public Key, o el Client ID con el Client Secret de la aplicación. Si no sabes cuál usar, elige el Access Token.
- En Mercado Pago Developers, abre Tus integraciones y entra a tu aplicación.
- Abre ProducciónCredenciales de producción para vender, o PruebasCredenciales de prueba para probar.
- Copia el Access Token y la Public Key.
Guarda las credenciales con cuidado
El Access Token y el Client Secret permiten generar cobros en tu cuenta. Pega esos valores solo en Vipter. Si se filtran, renueva las credenciales en Mercado Pago y cámbialas en Vipter con el botón Cambiar claves.
Paso 2: crear la conexión en Vipter
- En el panel de Vipter, abre PagosProveedoresMercado Pago.
- Haz clic en Nueva conexión. Si la tienda aún no tiene ninguna cuenta de Mercado Pago, el formulario ya aparece abierto.
- En Forma de autenticación, elige Token del panel o OAuth (aplicación), la misma forma del paso 1.
- Completa los campos numerados:

| # | Campo | Qué pegar |
|---|---|---|
| 1 | Nombre de la cuenta | Un nombre para reconocer la cuenta, como "Mercado Pago Brasil". Aparece en los flujos de pago. |
| 2 | País de la cuenta | El país donde se abrió la cuenta de Mercado Pago. No se puede cambiar después. |
| 3 | Access Token | El Access Token que copiaste en el paso 1. |
| 4 | Public Key | La Public Key de las mismas credenciales (de prueba o de producción) que el Access Token. |
| 5 | Conexión de prueba | Encendido, para usar las credenciales de prueba. Apágalo para cobrar de verdad con las credenciales de producción. |
- Haz clic en Guardar y obtener la URL del webhook. Vipter verifica las credenciales con Mercado Pago antes de guardar. Si están mal, no se guarda nada y el error aparece en el formulario.
El modo de prueba empieza encendido
El interruptor Conexión de prueba empieza encendido para que una primera conexión no le cobre a nadie por error. Para vender, crea la conexión con él apagado y las credenciales de producción.
Si la tienda todavía no tiene flujo para tarjeta de crédito, tarjeta de débito o PIX, Vipter crea esos flujos apuntando a la nueva cuenta. La tienda ya puede cobrar después del paso 4.
Paso 3: configurar las notificaciones en Mercado Pago
Por el webhook, Mercado Pago le avisa a Vipter lo que pasa con cada pago: PIX pagado, pago aprobado después de una revisión, reembolsos y contracargos. Cada aviso viene firmado con una clave secreta que Mercado Pago genera para tu aplicación.
- Después de guardar, la tarjeta de la conexión muestra la URL del webhook. Cópiala.
- En Mercado Pago Developers, abre Tus integraciones, entra a la misma aplicación del paso 1 y ve a WebhooksConfigurar notificaciones.
- Elige la pestaña del entorno de la conexión: la de prueba, para una conexión de prueba, o Modo productivo, para vender.
- Pega la URL que copiaste en el punto 1.
- En eventos, selecciona Pagos. Es el único evento que usa Vipter.
- Guarda. Mercado Pago genera la clave secreta de la aplicación. Muéstrala y copia el valor.
- Vuelve a Vipter, pega la clave secreta en la tarjeta de la conexión y haz clic en Guardar secreto.

| # | Campo | Qué pegar |
|---|---|---|
| 1 | Secreto del webhook (firma secreta) | La clave secreta que Mercado Pago generó en el punto 6, copiada exactamente como aparece. |
Si renuevas la clave secreta
Mercado Pago permite renovar la clave secreta. Después de renovarla, pega el nuevo valor en Vipter y vuelve a hacer clic en Guardar secreto. Mientras los dos valores sean distintos, los avisos se rechazan.
Paso 4: probar la conexión
- En la tarjeta de la conexión, haz clic en Probar. Vipter consulta a Mercado Pago con las credenciales guardadas.
- Haz una compra de prueba en el checkout de una oferta. Con credenciales de prueba de una cuenta de Brasil, usa la tarjeta Visa
4235 6477 2802 5682, vencimiento11/30y CVV123. En el nombre del titular, escribeAPROpara que el pago se apruebe, y usa el CPF (número de contribuyente de Brasil)123.456.789-09.
Funcionó si
Aparece el mensaje Conexión OK., la tarjeta muestra Secreto de verificación configurado. y la compra de prueba aparece en VentasTransacciones como pagada.
Problemas comunes
-
Tu plan permite N conector(es) activo(s). Mejora el plan para agregar más.
Tu plan llegó al límite de conexiones activas. Desactiva una conexión que ya no uses o cambia de plan en Plan Vipter.
-
Elige un país que atienda este proveedor.
Mercado Pago solo se acepta en los siete países de la lista. Elige el país donde se abrió la cuenta.
-
Mercado Pago rechazó las credenciales
Las credenciales son de otra aplicación, están incompletas o no coinciden con el país que elegiste. Revisa también que el Access Token y la Public Key vengan del mismo entorno (prueba o producción) y que la forma de autenticación elegida en Vipter sea la misma de las credenciales.
-
Sin el secreto de verificación la plataforma rechaza los eventos de este proveedor. Registra la URL de arriba en el proveedor, copia el secreto y guárdalo aquí.
La clave secreta no se guardó en Vipter. Repite el paso 3.
Qué hacer después
- Define cuántas cuotas ofrece la tienda y con qué interés en cuotas.
- Revisa los flujos de pago para decidir qué cuenta cobra cada pago y cuál queda de fallback.