💳 Cómo Integrar Mercado Pago para Aceptar Pagos

Conecta tu cuenta de Mercado Pago para aceptar pagos dentro de CRMHUB. Para completar la configuración, necesitarás tus credenciales de producción de Mercado Pago, y también deberás configurar notificaciones de webhook dentro de tu panel de desarrollador de Mercado Pago.

📋 Contenido de este Tutorial

💳 ¿Qué es Mercado Pago?
✨ Beneficios Clave
✅ Prerrequisitos y Requisitos
⚠️ Notas Importantes
🧭 Cómo Configurar Mercado Pago
❓ Preguntas Frecuentes

💳 ¿Qué es Mercado Pago?

Es un proveedor de pagos que los negocios pueden usar para aceptar pagos de clientes, especialmente en mercados de LatAm. CRMHUB se integra con Mercado Pago para que puedas conectarlo directamente dentro de tu cuenta en vez de depender de soluciones alternas o configuraciones manuales de pago.

Una vez conectado, puedes gestionar el proveedor desde Pagos → Integraciones y elegir dónde usarlo entre los canales de pago soportados en CRMHUB.

✨ Beneficios Clave

Experiencia localizada: ofrece métodos de pago que tus clientes ya conocen y en los que confían.
Mejores conversiones: reduce la fricción en el checkout con proveedores familiares.
Expansión de mercado: aprovecha un ecosistema de pagos de LatAm en rápido crecimiento.
Más control: decide cómo y dónde encaja Mercado Pago en tu stack de pagos.

✅ Prerrequisitos y Requisitos

Antes de empezar, asegúrate de tener:

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 de negocio, por si Mercado Pago la solicita al habilitar credenciales de producción.

⚠️ Nota: los pagos en vivo requieren credenciales de producción (no credenciales de prueba). Las credenciales de producción están ligadas a una aplicación que creas en Mercado Pago bajo "Tus integraciones".

Necesitarás estos valores de Mercado Pago: Public Key, Access Token, país de la cuenta, y secreto de webhook.

⚠️ Notas Importantes

Usa credenciales de producción para pagos reales. Las credenciales de prueba solo sirven para pruebas y no procesarán transacciones en vivo.
Mantén tu Access Token privado y guárdalo de forma segura.
Según la configuración de tu país en Mercado Pago, las opciones disponibles pueden variar. Distintos países tienen distintos montos mínimos — revisa las Preguntas Frecuentes para más detalles.
Tu cuenta de Mercado Pago debe tener soporte CVV-less habilitado para que esta integración funcione como se espera.
Mercado Pago no permite lanzar dos elementos de checkout en una sola página — por ejemplo, no puedes tener dos formularios de pedido de un paso en el mismo embudo.

🧭 Cómo Configurar Mercado Pago

Paso 1: Abre Mercado Pago en Integraciones de Pago

En CRMHUB, ve a Pagos desde el menú lateral izquierdo. 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. Abre el área de desarrollador de Mercado Pago. Ve a Tus integraciones. Abre una aplicación existente o crea una nueva. Ve a Credenciales de producción y copia el Public Key y el Access Token. Si las credenciales de producción aún no están activas, completa los detalles de negocio requeridos, como tu industria y sitio web.

Si necesitas crear una nueva aplicación: Mercado Pago normalmente te pedirá: ingresar un nombre de aplicación, elegir el tipo de pago o caso de uso de negocio para pagos en línea, confirmar los detalles de tu configuración, y habilitar las credenciales de producción.

Paso 3: Ingresa tus credenciales de Mercado Pago en CRMHUB

Pega el Public Key en el campo correspondiente. Pega el Access Token en el campo correspondiente. Elige el país o región de cuenta correcta. Genera o ingresa tu Secreto de Webhook en el campo correspondiente. Haz clic en Guardar o Conectar.

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 de vuelta a tu plataforma.

Inicia sesión en tu cuenta de Mercado Pago y ve al panel de desarrollador. Abre la aplicación usada para la integración y ve a Webhooks. Haz clic en Configurar notificaciones. Completa la configuración requerida:

Pega la URL de webhook en el campo de URL de modo Producción: https://backend.LeadConnectorhq.com/payments/mercado-pago/webhook
Agrega el Secreto de Webhook, el mismo que usaste en el lado de CRMHUB.
Selecciona el evento "Payment" requerido para tu integración.
Guarda tus cambios.

Paso 5: Asigna Mercado Pago por canal

Después de conectar la integración, abre "Gestionar Configuraciones de Proveedor" para Mercado Pago en CRMHUB. Alterna entre modo Vivo y Prueba según sea necesario. Asigna Mercado Pago a los canales donde quieres que esté disponible.

❓ Preguntas Frecuentes

¿Hay condiciones de monto mínimo en mi país? Sí. Mercado Pago tiene reglas específicas de monto mínimo y máximo según el método de pago. Si creas un producto que no cumple estas condiciones, el pago puede fallar.
¿Qué pasa si creo un producto en moneda USD? Por ahora, Mercado Pago no convierte dinámicamente la moneda para esta configuración. Se recomienda mantener la moneda de tu producto o servicio igual a la moneda local de tu cuenta de Mercado Pago.
Agregué dos elementos de checkout o pago a mi embudo, pero no funcionan. Mercado Pago no lo permite por sus condiciones de seguridad. Solo puedes abrir una pantalla de checkout en una sesión activa. Asegúrate de que tu embudo use solo un elemento activo de checkout de Mercado Pago a la vez.
¿Qué pasa si el soporte CVV-less no está habilitado en mi cuenta? Se recomienda encarecidamente habilitarlo. Sin él, funciones como suscripciones, pagos fuera de sesión, y modo SaaS pueden no funcionar correctamente.
¿Qué países están soportados para esta integración? Colombia, Argentina, Chile, México, Ecuador, Uruguay, Perú, Brasil, El Salvador.
¿Cómo genero un secreto de webhook? Es una cadena aleatoria de alta entropía usada para firmar solicitudes de payload. Puede ser una contraseña que recuerdes, pero debe coincidir en ambos lados (CRMHUB y Mercado Pago). También puedes usar un generador de secretos de webhook basado en web, que genera un secreto basado en algoritmo hmac-sha256, más seguro.
¿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, comúnmente usado para verificar transacciones en línea o telefónicas. En flujos de pago con tarjeta guardada — especialmente al cobrar a clientes fuera de sesión o iniciar suscripciones usando una tarjeta ya guardada — pedir el CVV cada vez genera fricción y aumenta el abandono. Para evitar esto, algunos proveedores soportan flujos CVV-less, donde la tarjeta se guarda de forma segura permitiendo pagos recurrentes más fluidos y mejor compatibilidad con funciones de CRMHUB como suscripciones, pagos fuera de sesión, y flujos de facturación relacionados con SaaS. Tu cuenta de Mercado Pago puede ya tenerlo habilitado, pero deberás verificarlo con el equipo de soporte de Mercado Pago. Si no está habilitado, deberás solicitar su activación.