Saltar al contenido principal

¿Cómo integrar con Mercado Pago para aceptar pagos?

En este artículo, aprenderás cómo conectar tu cuenta de Mercado Pago para que puedas aceptar pagos dentro de Ropofy. Para completar la configuración, necesitarás tus credenciales de producción de Mercado Pago, y es posible que también tengas que configurar notificaciones de webhook en la configuración de desarrollador de tu cuenta Mercado Pago.

---

¿Qué es Mercado Pago?

Mercado Pago es un proveedor de pagos que las empresas pueden utilizar para aceptar pagos de clientes, especialmente en los mercados de LATAM. Ropofy se integra con Mercado Pago para que las empresas puedan conectarlo directamente dentro de su cuenta en vez de depender de soluciones separadas o configuraciones manuales de pagos.

Una vez conectado, las empresas pueden gestionar el proveedor desde Pagos > Integraciones y elegir dónde usarlo a lo largo de los canales de pago soportados en Ropofy.

---

Beneficios clave de Mercado Pago

  • Experiencia localizada: Ofrece métodos de pago que tus clientes ya conocen y en los que confían
  • Mejores conversiones: Reduce fricción al momento del pago usando proveedores familiares
  • Expansión de mercado: Accede a un ecosistema de pagos en LATAM de rápido crecimiento
  • Más control: Decide cómo y dónde encaja Mercado Pago en tu stack de pagos
---

Requisitos previos

Una configuración exitosa de Mercado Pago depende de contar con las credenciales correctas, ajustes de la cuenta y la información de webhook lista antes de comenzar.

Antes de comenzar, asegúrate de tener:

  • Una cuenta de Mercado Pago con soporte para pagos sin CVV/CVC habilitado.
  • Acceso a tu panel de desarrollador de Mercado Pago.
  • La URL de tu sitio web empresarial, en caso de que Mercado Pago la solicite para habilitar las 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 asociadas a una app que creas en Mercado Pago bajo Tus integraciones.

Necesitarás estos valores de Mercado Pago:

  • Clave Pública (Public Key)
  • Access Token
  • País de la cuenta
  • Secreto del Webhook

---

Notas importantes

  • Usa credenciales de producción para pagos reales. Las credenciales de prueba son solo para pruebas y no procesarán transacciones reales.
  • Mantén tu Access Token privado y guárdalo de forma segura.
  • Dependiendo del país que hayas configurado en tu cuenta de Mercado Pago, las opciones disponibles pueden variar. Diferentes países tienen mínimos diferentes; consulta las preguntas frecuentes para más detalles.
  • Tu cuenta de Mercado Pago debe tener habilitado el soporte para pagos sin CVV para que esta integración funcione correctamente.
  • Mercado Pago no permite lanzar dos elementos de pago en una sola página, por ejemplo, no puedes tener dos formularios de pedido de un paso en un embudo.
---

¿Cómo configurar Mercado Pago?

Una configuración adecuada garantiza que Ropofy pueda conectarse a Mercado Pago, enrutar los pagos correctamente y recibir actualizaciones de eventos de pago mediante webhooks. Completar cada paso detenidamente ayuda a evitar conexiones fallidas y problemas de sincronización posteriores.

Paso 1: Abre Mercado Pago en Integraciones de Pago

  1. En Ropofy, ve a Pagos desde el menú lateral.
  2. Abre la pestaña Integraciones.
  3. Encuentra Mercado Pago en la lista de proveedores y haz clic en Conectar.

Paso 2: Obtén tus credenciales de producción de Mercado Pago

  1. Inicia sesión en tu cuenta de Mercado Pago.
  2. Abre el área de desarrollador de Mercado Pago.
  3. Ve a Tus integraciones.
  4. Abre una aplicación existente o crea una nueva.
  5. Ve a Credenciales de producción y copia la Clave Pública y el Access Token. Si las credenciales de producción aún no están activas, completa cualquier detalle empresarial requerido como tu rubro y sitio web.

Si necesitas crear una nueva aplicación:

Si aún no tienes una aplicación en Mercado Pago, créala primero. En la mayoría de los casos, Mercado Pago te pedirá:

  1. Ingresar un nombre para la aplicación.
  2. Elegir el tipo de pago o caso de uso para pagos en línea.
  3. Confirmar los detalles de tu configuración.
  4. Habilitar credenciales de producción y usarlas en el paso 2.

Paso 3: Ingresa tus credenciales de Mercado Pago en Ropofy

  1. Pega la Clave Pública en el campo correspondiente.
  2. Pega el Access Token en el campo correspondiente.
  3. Elige el país o región de la cuenta correcto.
  4. Genera o ingresa tu Webhook Secret en el campo correspondiente.
  5. Haz clic en Guardar o Conectar.

Una vez guardado, tu cuenta de Mercado Pago debería estar enlazada. Ahora habilitaremos los webhooks en la aplicación de Mercado Pago.

Paso 4: Configura los webhooks en Mercado Pago

Algunas integraciones con 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.

  1. En Mercado Pago, abre la aplicación utilizada para la integración y ve a Webhooks.
  2. Haz clic en Configurar notificaciones.
  3. Completa la configuración requerida del webhook para que los eventos de pago se sincronicen correctamente con Ropofy.
    • Pega la URL del webhook en el campo de URL para modo de producción: https://backend.LeadConnectorhq.com/payments/mercado-pago/webhook
    • Agrega el secreto del Webhook igual que en la página de Lead Connector
    • Selecciona el evento ‘Payment’ requerido para tu integración.
    • Guarda los cambios.

Paso 5: Asigna Mercado Pago por canal

Después de conectar la integración, abre la Gestión de Configuraciones del Proveedor para Mercado Pago en Ropofy.

  • Cambia entre modo En Vivo y Prueba según lo necesario.
  • Asigna Mercado Pago a los canales donde quieras que esté disponible.

---

Preguntas frecuentes

P: ¿Existen condiciones de monto mínimo en 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 cumpla con estas condiciones, el pago podría fallar. La referencia actual se basa en los límites de pago que Mercado Pago soporta:

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

Pago Fácil y Rapipago

  • Monto mínimo: $100.00
  • Monto máximo: $1,000,000.00

P: ¿Qué sucede si creo un producto en moneda USD?

Por el momento, Mercado Pago no convierte la moneda dinámicamente para esta configuración. Se recomienda que la moneda de tu producto o servicio sea la misma moneda de tu cuenta local de Mercado Pago.

Por ejemplo, si tu cuenta de Mercado Pago está basada en Argentina, debes usar Peso argentino para el precio de tus productos.

P: Agregué dos elementos de checkout o pago a mi embudo, pero no funcionan

Mercado Pago no permite esto por razones de seguridad. Solo puedes tener una pantalla de checkout abierta en una sesión activa. Para evitar problemas de pago, asegúrate de usar solo un elemento activo de checkout o pago de Mercado Pago a la vez en tu embudo.

Por ejemplo, dos o más formularios de pedido con elemento de captura de tarjeta en un mismo embudo o página web no se cargarán.

P: ¿Qué pasa si el soporte para pagos sin CVV no está habilitado en mi cuenta?

Se recomienda ampliamente habilitar el soporte para pagos sin CVV en tu cuenta de Mercado Pago. Sin ello, funcionalidades como suscripciones, pagos fuera de sesión y modo SaaS podrían no funcionar correctamente.

P: ¿Qué países están soportados para esta integración?

Está disponible en los siguientes países:

Colombia, Argentina, Chile, México, Uruguay, Perú, Brasil.

Y próximamente en países como Ecuador y El Salvador.

P: ¿Cómo genero un secreto de webhook?

Un secreto de webhook es una cadena aleatoria de alta entropía utilizada para firmar las solicitudes de payload. Esta cadena puede ser una contraseña que recuerdes, pero debe ser la misma tanto en Lead Connector como en Mercado Pago. Puedes también utilizar herramientas web para generar un secreto de webhook basado en hmac-sha256 como este (más seguro): e70fd2ccfed7cf82596fe0494925a0ada87e3b03873a83150bd5458754650211 (solo como ejemplo)

P: ¿Qué es una cuenta habilitada para pagos sin CVV/CVC?

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 se utiliza para verificar transacciones en línea o por teléfono y ayuda a reducir el fraude.

En los procesos de pago con tarjeta guardada, especialmente al hacer cobros fuera de sesión o iniciar suscripciones usando una tarjeta previamente guardada, pedir el CVV cada vez puede generar fricción e incrementar el abandono.

Para evitar esto, algunos proveedores de pago soportan procesos sin CVV. En estos procesos, la tarjeta se almacena de forma segura para permitir pagos recurrentes más fluidos y mejor compatibilidad con las funciones de Lead Connector, tales como suscripciones, cobros fuera de sesión y facturación SaaS.

Es posible que tu cuenta de Mercado Pago ya lo tenga habilitado, pero deberás verificar esto con el equipo de soporte de Mercado Pago. Si no está habilitado, deberás solicitar la activación.

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.