Cómo integrar tu cuenta de Mercado Pago con systeme.io

En este artículo aprenderás a integrar tu cuenta de Mercado Pago con systeme.io.

Necesitarás:

Una cuenta de systeme.io
Una cuenta de Mercado Pago (haz clic aquí para crear una cuenta de Mercado Pago)

Para conectar tu cuenta de systeme.io a tu cuenta de Mercado Pago, haz clic en tu foto de perfil y luego en Configuración (1).

En el menú izquierdo, haz clic en Pasarelas de pago (2) y en Conectar (3)

Para implementar la integración, debes ingresar las credenciales de Clave API pública y Access Token y seleccionar el país al que pertenece la cuenta de Mercado Pago.

Para generar estas credenciales, inicia sesión en tu cuenta de Mercado de Pago y sigue estos pasos:

1. Cómo obtener y activar las credenciales de Mercado Pago

Debes crear una aplicación en Mercado Pago para obtener tus credenciales y posteriormente activarlas para producción. Sigue estos pasos:

1.1 Generar las credenciales de Mercado Pago

Ingresa al panel principal de Mercado Pago, haz clic en tu nombre (1) en la parte superior derecha, dirígete a la pestaña Negocio (2) y selecciona Tus integraciones (3).

Haz clic en + Crear aplicación (4)

Agrega el nombre de tu aplicación en la casilla (5) y haz clic en Continuar (6).

En la opción Pagos online, selecciona la opción A través de una plataforma en la sección ¿Cómo hiciste la tienda?.

Si lo deseas, puedes ingresar el enlace de tu página de pago en el campo URL de la tienda. Finalmente, haz clic en Continuar (7)

En la casilla Otra plataforma, escribe: systeme.io (8) y haz clic en continuar.

Después, revisa los datos ingresados, marca la casilla para autorizar el uso de tus datos personales y completa el reCAPTCHA (9).

Finalmente, haz clic en Confirmar (10) para crear tu aplicación.

1.2 Activar las credenciales de Mercado Pago

A continuación, serás dirigido al panel de tu aplicación. En el menú desplegable, selecciona la aplicación que acabas de crear (11); si es tu primera aplicación, ya estará seleccionada por defecto, y haz clic en Activar credenciales (12).

Selecciona la industria (13) a la que pertenece tu negocio y opcionalmente ingresa la URL de tu sitio web si cuentas con uno.

A continuación, acepta los términos marcando la casilla de autorización, resuelve el reCAPTCHA (14) y haz clic en Activar credenciales de producción (15).

¡Listo! Tu aplicación de Mercado Pago ya está activa.

Localiza tu Public Key y haz clic en el ícono de Copiar

Localiza tu Access Token, haz clic en el icono del ojo para revelar el texto y luego en Copiar.

Guarda temporalmente estas claves para ingresarlas en el siguiente paso en tu cuenta de systeme.io.

Importante: tu Access Token y Client Secret son contraseñas confidenciales. Nunca las compartas públicamente.

Nota: tendrás un conjunto de credenciales por cada aplicación que utilices.

1.3. Vincula las credenciales en systeme.io

Regresa a tu cuenta de systeme.io, pega tu clave API pública y el access token de producción, selecciona tu país y haz clic en Guardar.

Al guardar, systeme.io conectará tu cuenta de Mercado Pago.

2. Configuración IPN en Mercado Pago

Una vez guardadas las credenciales, systeme.io genera automáticamente una URL de Webhook. Para que systeme.io reciba las notificaciones de pago en tiempo real, debes registrar esa URL en tu panel de desarrollador de Mercado Pago.

Haz clic en el botón de copiar (1) para obtener la URL del Webhook que usarás en el siguiente paso.

Inicia sesión en tu cuenta de Mercado Pago e ingresa al panel de desarrollador a través de este enlace: https://www.mercadopago.com.co/developers/es

Arriba a la derecha, haz clic en el menú Integraciones.

Nota: el enlace al panel de desarrolladores varía según el país. Asegúrate de acceder con el dominio correspondiente a tu cuenta cambiando la extensión del enlace (por ejemplo: .com.co para Colombia, .com.mx para México, .com.ar para Argentina, etc.).

En la lista de Tus aplicaciones, ubica la aplicación que acabas de crear y haz clic en su nombre (2).

Dirígete al menú de la izquierda, desplázate hasta el apartado NOTIFICACIONES y selecciona la opción Webhooks (3).

En la sección de Webhooks, haz clic en el botón Configurar notificaciones (4).

Ve a la pestaña Modo productivo (5) y completa la siguiente configuración:

URL de producción (6): Pega la URL del webhook que copiaste previamente de systeme.io.
Eventos recomendados (7): Marca la casilla Pagos (legacy).
Otros eventos (8): Marca la casilla Planes y suscripciones.

Para finalizar, haz clic en el botón Guardar configuración (9).

En la ventana emergente, haz clic en Guardar para confirmar la acción.

Para aprender más sobre la configuración del webhook de Mercado Pago, puedes consultar este artículo.

Notas:

Para que un pago sea procesado con éxito por Mercado Pago, las páginas de pago deben contener los campos: correo electrónico, nombre, apellido, país y número de IVA.
Solo se puede seleccionar un país para integrar una cuenta de Mercado Pago (Brasil, Colombia, México, Chile o Argentina).
Vincular una cuenta de Mercado Pago te permite crear precios en la moneda local de esa cuenta (p. ej., reales brasileños, pesos colombianos, etc.).
Debido a limitaciones de Mercado Pago, no es posible procesar reembolsos desde systeme.io.
Recurso adicional: Para más detalles sobre el funcionamiento y la configuración del webhook, puedes consultar la documentación oficial de Mercado Pago.

3. Monedas admitidas y restricciones

Antes de recibir pagos, asegúrate de que tus túneles y productos estén configurados con una de las monedas admitidas por esta pasarela.

Mercado Pago admite pagos mediante tarjetas de crédito, así como métodos de pago locales como PIX y Boleto para usuarios en Brasil.

Compradores admitidos: Argentina, Brasil, Chile, Colombia y México.
Pagos recurrentes (suscripciones): Sí.
Monedas admitidas: ARS, BRL, CLP, COP y MXN.
Restricciones para el comerciante: Tu cuenta de comerciante de Mercado Pago debe estar registrada en el mismo país que la moneda con la que cobras en tus túneles (por ejemplo, debes usar una cuenta argentina para cobrar en ARS o una cuenta brasileña para cobrar en BRL). Ten en cuenta que solo puedes seleccionar un país para integrar por cuenta de systeme.io.

¿Qué sucede cuando hay un error en un pago con Mercado Pago?

Tarjetas: se realizarán tres intentos. El tiempo de espera entre cada intento no puede modificarse. Para conocer el intervalo exacto, contacta al soporte de Mercado Pago.
Boleto, Pix: se realizarán tres intentos, con un intervalo de 7 días entre cada uno.