📋 Antes de comenzar
Para asegurar una integración exitosa, asegúrate de tener listo lo siguiente:
✅ Una cuenta activa de Zolutium.
✅ Una cuenta de Mercado Pago con el soporte para CVV/CVC desactivado (consulta las preguntas frecuentes al final para más detalles).
✅ Acceso a tu panel de desarrollador de Mercado Pago.
✅ La URL del sitio web de tu negocio (Mercado Pago podría solicitarla al habilitar las credenciales de producción).
Nota: Las credenciales de producción de Mercado Pago están vinculadas a una aplicación que tú creas dentro de tus integraciones. Los pagos en vivo requieren credenciales de producción, no de prueba.
🔑 Lo que necesitarás de Mercado Pago
Para conectar ambas plataformas, debes tener a la mano estos cuatro valores clave:
Clave pública (Public Key)
Token de acceso (Access Token)
País de la cuenta
Secreto del webhook
🚀 Paso a paso: Cómo conectar tu cuenta
🟢 Paso 1: Abre las integraciones de pago en Zolutium
Inicia sesión en tu cuenta de Zolutium.
Ve a la sección Pagos en la barra de navegación izquierda.
Abre la pestaña Integraciones, donde se gestionan las pasarelas de pago.
Encuentra Mercado Pago en la lista.
Haz clic en el botón Conectar.
🟢 Paso 2: Genera tus credenciales de producción de Mercado Pago
Inicia sesión en tu cuenta de Mercado Pago.
2. Abre el área de Desarrolladores de Mercado Pago.
3. Ve a Tus integraciones.
4. Abre una aplicación existente o crea una nueva.
5. Navega a Credenciales de producción.
6. Copia la clave pública y el token de acceso. (Nota: Si las credenciales de producción aún no están activas, es posible que se te solicite completar información comercial, como tu sector y sitio web, antes de la activación).
✨ ¿Necesitas crear una nueva aplicación? Si aún no tienes una aplicación en Mercado Pago, créala primero siguiendo estos pasos:
Introduce un nombre para la aplicación.
Selecciona el tipo de pago o el caso de uso comercial: pagos en línea.
Confirma los detalles de tu configuración.
Habilita las credenciales de producción y úsalas como se indica en el Paso 2.
🟢 Paso 3: Añade las credenciales en Zolutium
Regresa a la pestaña de Zolutium y completa los campos:
Pega tu clave pública en el campo correspondiente.
Pega tu token de acceso en el campo correspondiente.
Selecciona el país o la región de tu cuenta si aparece la opción.
Genera una clave secreta para el webhook e introdúcela en el campo correspondiente (consulta la FAQ #6 si tienes dudas).
Haz clic en Guardar o Conectar. ¡Listo! Una vez guardada, tu cuenta de Mercado Pago estará vinculada. Ahora pasaremos a habilitar los webhooks.
🟢 Paso 4: Configurar las notificaciones de webhook en Mercado Pago
Algunas integraciones requieren notificaciones webhook para que los eventos de pago se sincronicen correctamente con tu plataforma.
Ve al panel de desarrolladores de Mercado Pago: https://www.mercadopago.com.br/developers/en
2. Abre la aplicación que usaste para la integración.
3. Ve a la sección Webhooks.
4. Haz clic en Configurar notificaciones.
5. Pega la siguiente URL en el campo URL del modo de producción: 🔗 https://backend.Lead Connector hq.com/payments/mercado-pago/webhook
6. Agrega el secreto del webhook (exactamente el mismo que pusiste en Zolutium).
7. Selecciona el evento 'Pago' necesario para tu integración.
8. Guarda los cambios.
⚠️ Notas importantes
Entorno real: Utilice las credenciales de producción para pagos reales. Las credenciales de prueba son solo para realizar simulaciones y no procesarán transacciones reales.
Seguridad: Mantén tu token de acceso totalmente privado y guárdalo de forma segura.
Variaciones regionales: Según la configuración de Mercado Pago en tu país, las opciones disponibles pueden variar. Por ejemplo, los requisitos mínimos de cuenta varían según el país.
Función indispensable: Para que esta integración funcione correctamente, tu cuenta de Mercado Pago debe tener habilitada la compatibilidad con CVV less.
Límite de checkouts: Mercado Pago no permite que se lancen dos elementos de pago en una sola página (por ejemplo, no se pueden mantener dos formularios de pedido de un solo paso activos en un mismo embudo al mismo tiempo).
❓ Preguntas Frecuentes (FAQ)
1. ¿Existen requisitos de importe 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 con estas condiciones, el pago podría fallar. (La información a continuación se basa en los límites admitidos por Mercado Pago):
💳 Tarjetas de crédito y débito (Visa, Mastercard, American Express, Naranja, Cabal y Sucrédito):
Importe mínimo para pagos únicos: $100.00
Importe mínimo para compras a plazos: $100.00 por plazo
Importe máximo: $15,000,000.00
🏪 Pago fácil y Rapipago:
Importe mínimo: $100.00
Importe máximo: $1,000,000.00
Referencia oficial: Monto mínimo y máximo en medios de pago
2. ¿Qué sucede si creo un producto en dólares estadounidenses? Por el momento, Mercado Pago no realiza la conversión de moneda de forma dinámica 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 (Por ejemplo, si tu cuenta está registrada en Argentina, debes usar pesos argentinos para fijar el precio de tus productos).
3. Agregué dos elementos de pago a mi embudo, pero no funcionan. Mercado Pago no lo permite debido a sus estrictas condiciones de seguridad. Solo se puede abrir una pantalla de pago por sesión activa. Para evitar problemas, asegúrate de que tu embudo utilice solo un elemento de pago de Mercado Pago activo a la vez por página web.
4. ¿Qué sucede si la compatibilidad con CVV-less no está habilitada en mi cuenta? Se recomienda encarecidamente habilitar la opción de pago sin CVV. Sin ella, funciones avanzadas como las suscripciones, los pagos fuera de sesión y el modo SaaS podrían fallar o no funcionar correctamente.
5. ¿Qué países reciben soporte para esta integración? La integración está disponible en: Colombia, Argentina, Chile, México, Ecuador, Uruguay, Perú, Brasil y El Salvador.
6. ¿Cómo genero un secreto de webhook? Un secreto de webhook es una cadena aleatoria de alta entropía que se utiliza para firmar las solicitudes de carga útil. Puede ser una contraseña compleja que recuerdes, pero debe coincidir exactamente tanto en Zolutium como en Mercado Pago. También puedes usar un generador de secretos en línea basado en el algoritmo hmac-sha256 (son más seguros). Ejemplo de formato: e70fd2ccfed7cf82596fe0494925a0ada87e3b03873a83150bd5458754650211.
7. ¿Qué es la habilitación de cuentas sin CVV/CVC? El CVV o CVC es el código de seguridad de 3 o 4 dígitos impreso en las tarjetas de crédito o débito, utilizado habitualmente para verificar transacciones y reducir el fraude. En los flujos de pago con tarjetas guardadas (especialmente al cobrar fuera de sesión o al iniciar suscripciones recurrentes), pedirle al cliente que ingrese el CVV cada mes genera fricción y abandono. Para evitar esto, se admiten flujos sin CVV, donde la tarjeta se almacena de forma segura permitiendo pagos recurrentes fluidos y total compatibilidad con las funciones SaaS de Zolutium. Nota: Es posible que esta función ya esté activada en tu cuenta, pero deberás verificarlo con el equipo de soporte de Mercado Pago. Si no lo está, deberás solicitar su activación directamente con ellos.