En este artículo aprenderás cómo conectar tu cuenta de Mercado Pago para aceptar pagos dentro de tu CRM. Para completar la configuración necesitarás tus credenciales de producción de Mercado Pago y es posible que también debas configurar notificaciones de webhook en los ajustes de desarrollador de Mercado Pago.
¿Qué es Mercado Pago?
Mercado Pago es un proveedor de pagos que las empresas pueden usar para cobrar a sus clientes, especialmente en los mercados de LATAM. El sistema se integra con Mercado Pago para que las empresas puedan conectarlo directamente desde su cuenta, sin depender de soluciones alternativas o configuraciones de pago manuales.
Una vez conectado, las empresas pueden gestionar el proveedor desde Pagos > Integraciones y elegir dónde utilizarlo en los canales de pago disponibles.
Requisitos previos
Una configuración exitosa de Mercado Pago depende de tener las credenciales correctas, los ajustes de cuenta y la información de webhook listos antes de comenzar.
Antes de empezar, asegúrate de contar con:
-
Una cuenta de Mercado Pago con soporte CVV/CVC-less habilitado.
-
Acceso a tu panel de desarrollador de Mercado Pago.
-
La URL de tu sitio web, en caso de que Mercado Pago la solicite al activar las credenciales de producción.
Nota: Los pagos en producción requieren credenciales de producción (no de prueba). Las credenciales de producción están vinculadas a una app que creas en Mercado Pago en "Tus integraciones".
Necesitarás estos valores de Mercado Pago:
-
Public Key (Clave pública)
-
Access Token (Token de acceso)
-
País de la cuenta
-
Webhook secret (Secreto de webhook)
Notas importantes
-
Usa credenciales de producción para pagos reales. Las credenciales de prueba son solo para testing y no procesarán transacciones en vivo.
-
Mantén tu Access Token privado y guárdalo de forma segura.
-
Dependiendo de la configuración de país de tu cuenta de Mercado Pago, las opciones disponibles pueden variar. Cada país tiene montos mínimos diferentes; consulta las preguntas frecuentes para más detalles.
-
Tu cuenta de Mercado Pago debe tener habilitado el soporte CVV-less para que esta integración funcione correctamente.
-
Mercado Pago no permite que se lancen dos elementos de checkout en una misma página; por ejemplo, no puedes tener dos formularios de orden de 1 paso en un funnel.
Cómo configurar Mercado Pago
Una configuración correcta garantiza que el sistema pueda conectarse a Mercado Pago, enrutar los pagos correctamente y recibir actualizaciones de eventos de pago a través de webhooks. Completar cada paso con cuidado ayuda a evitar problemas de conexión y sincronización.
Paso 1: Abre Mercado Pago en Integraciones de Pagos
-
Ve a Pagos en la navegación lateral izquierda.
-
Abre la pestaña Integraciones.
-
Busca Mercado Pago en la lista de proveedores y haz clic en Conectar.
Paso 2: Obtén tus credenciales de producción de Mercado Pago
-
Inicia sesión en tu cuenta de Mercado Pago.
-
Ve a ajustes
-
Ve a Tus integraciones.
-
Abre una aplicación existente o crea una nueva.
-
Ve a Credenciales de producción y copia la Public Key y el Access Token. Si las credenciales de producción aún no están activas, completa los datos del negocio que se soliciten, como tu industria y sitio web.
Si necesitas crear una nueva aplicación:
Si aún no tienes una aplicación dentro de Mercado Pago, créala primero. En la mayoría de los casos, Mercado Pago te pedirá que:
-
Ingreses un nombre para la aplicación.
-
Elijas el tipo de pago o caso de uso para pagos en línea.
-
Confirmes los detalles de configuración.
-
Actives las credenciales de producción y las uses en el paso 2
-
Paso 3: Ingresa tus credenciales de Mercado Pago
-
Pega la Public Key en el campo correspondiente.
-
Pega el Access Token en el campo correspondiente.
-
Elige el país o región de la cuenta correcta.
-
Genera o ingresa tu Webhook Secret en el campo correspondiente.
-
Haz clic en Guardar o Conectar.
Una vez guardado, tu cuenta de Mercado Pago quedará vinculada. Ahora habilitaremos los webhooks en la app de Mercado Pago.
Paso 4: Configura los webhooks en Mercado Pago
Algunas integraciones de Mercado Pago requieren notificaciones de webhook para que los eventos de pago se sincronicen correctamente con tu plataforma. Inicia sesión en tu cuenta de Mercado Pago y ve al panel de desarrollador: (https://www.mercadopago.com.br/developers/es)
-
En Mercado Pago, abre la aplicación usada para la integración y ve a Webhooks.
-
Haz clic en Configurar notificaciones.
-
Completa la configuración requerida del webhook para que los eventos de pago se sincronicen correctamente:
-
Pega la URL del webhook en el campo de URL en modo Producción:
https://backend.LeadConnectorhq.com/payments/mercado-pago/webhook -
Agrega el Webhook Secret igual al que configuraste en Leadway.
-
Selecciona el evento "Payment" requerido para tu integración.
-
Guarda los cambios.
-
Paso 5: Asigna Mercado Pago por canal
Una vez conectada la integración, abre Gestionar configuraciones del proveedor para Mercado Pago.
-
Cambia entre modo En vivo y Prueba según lo necesites.
-
Asigna Mercado Pago a los canales donde quieres que esté disponible.
Preguntas frecuentes
P: ¿Existen montos mínimos según mi país?
Sí. Mercado Pago tiene reglas específicas de montos mínimos y máximos dependiendo del método de pago. Si creas un producto que no cumple estas condiciones, el pago puede fallar. La referencia actual se basa en los límites de pago soportados por Mercado Pago:
Tarjetas de crédito y débito
-
Visa, Mastercard, American Express, Naranja, Cabal y Sucrédito
-
Monto mínimo para pagos únicos: $100.00
-
Monto mínimo para compras en cuotas: $100.00 por cuota
-
Monto máximo: $15,000,000.00
Easy Payment y Rapipago
-
Monto mínimo: $100.00
-
Monto máximo: $1,000,000.00
Referencia: https://www.mercadopago.com.ar/ayuda/monto-minimo-maximo-medios-de-pago_620
P: ¿Qué pasa si creo un producto con moneda USD?
Por el momento, Mercado Pago no convierte la moneda dinámicamente en esta configuración. Se recomienda usar la misma moneda que la de tu cuenta de Mercado Pago local.
Por ejemplo, si tu cuenta de Mercado Pago está basada en Argentina, debes usar pesos argentinos para el precio de tus productos.
P: Agregué dos elementos de checkout o pago a mi funnel, pero no están funcionando.
Mercado Pago no lo permite debido a sus condiciones de seguridad. Solo puedes abrir una pantalla de checkout en una sesión activa. Para evitar problemas de pago, asegúrate de que tu funnel use únicamente un elemento de checkout o pago de Mercado Pago activo a la vez.
Por ejemplo, dos o más formularios de orden con elemento de captura de tarjeta en un mismo funnel o página web no se cargarán correctamente.
P: ¿Qué pasa si no tengo habilitado el soporte CVV-less en mi cuenta?
Se recomienda fuertemente habilitar el soporte CVV-less en tu cuenta de Mercado Pago. Sin él, funciones como suscripciones, pagos fuera de sesión y el modo SaaS pueden no funcionar correctamente.
P: ¿Qué países están soportados para esta integración?
Colombia, Argentina, Chile, México, Ecuador, Uruguay, Perú, Brasil, El Salvador.
P: ¿Cómo genero un webhook secret?
Un webhook secret es una cadena aleatoria de alta entropía que se usa para firmar las solicitudes del payload. Puede ser una contraseña que puedas recordar, pero debe coincidir tanto en Leadway como en Mercado Pago. También puedes usar un generador de webhook secret en línea, que generará un secreto basado en el algoritmo HMAC-SHA256, como este (solo de ejemplo): e70fd2ccfed7cf82596fe0494925a0ada87e3b03873a83150bd5458754650211 Estos son más seguros.
P: ¿Qué es la habilitación de cuenta CVV/CVC-less?
El CVV o CVC es el código de seguridad de 3 o 4 dígitos impreso en una tarjeta de crédito o débito. Se usa comúnmente para verificar transacciones en línea o por teléfono y ayuda a reducir el fraude.
En flujos de pago con tarjeta guardada, especialmente al cobrar a clientes fuera de sesión o al iniciar suscripciones con una tarjeta ya guardada, pedir el CVV cada vez puede generar fricción y aumentar el abandono.
Para evitar esto, algunos proveedores de pago soportan flujos CVV-less. En estos flujos, la tarjeta se almacena de forma segura de una manera que permite pagos recurrentes más fluidos y mejor compatibilidad con funciones de Leadway como suscripciones, pagos fuera de sesión y flujos de facturación relacionados con SaaS.
Es posible que tu cuenta de Mercado Pago ya tenga esto habilitado, pero deberás verificarlo con el equipo de soporte de Mercado Pago. Si no está habilitado, deberás solicitar la activación directamente con ellos.