Integraciones

Conectar Mercado Pago

La integración con Mercado Pago permite conectar una cuenta de Mercado Pago con Cactus para administrar pagos integrados, sucursales, cajas de Mercado Pago, códigos QR y terminales Point asociados a tus locales.

La configuración tiene dos partes: primero vinculás la cuenta a nivel organización y después configurás cómo se usa en cada local.

Antes de empezar

Tené a mano:

acceso a la cuenta de Mercado Pago que querés vincular;
permiso para autorizar aplicaciones en Mercado Pago;
el local creado en Cactus;
las cajas del local creadas en Configuración > Cajas;
permisos para administrar integraciones y métodos de pago.

1. Conectar la cuenta de Mercado Pago

Entrá al Portal de Cuenta.
Abrí Administrar > Integraciones.
Buscá Mercado Pago.
Hacé clic en Administrar.
En la pantalla de Mercado Pago, hacé clic en Agregar Cuenta.
Cactus abrirá la autorización de Mercado Pago en una nueva ventana.
Iniciá sesión en Mercado Pago, revisá la autorización y aceptá la vinculación.
Volvé a Cactus y verificá que la cuenta aparezca en la lista.

Si todavía no tenías ninguna cuenta conectada, el botón puede mostrarse como Agregar Primera Cuenta.

2. Revisar el estado de la cuenta

En Administrar > Integraciones > Mercado Pago, cada cuenta muestra su estado.

Los estados principales son:

Activo: la cuenta está conectada y disponible.
Inactivo: la cuenta está desactivada y puede requerir reactivación.
Pendiente: la conexión quedó incompleta o requiere reintentar la autorización.
Necesita atención: falló la renovación automática de la conexión.

Desde esa pantalla también podés:

usar Actualizar Datos para traer sucursales, puntos de venta, QR y terminales actualizados desde Mercado Pago;
usar Activar o Reintentar cuando la conexión quedó pendiente;
usar Revincular si el estado es “Necesita atención”;
usar Desactivar si necesitás desconectar la cuenta.

3. Configurar Mercado Pago en un local

Después de conectar la cuenta, entrá al local que va a cobrar con Mercado Pago.

Abrí el local en el Portal de Cuenta.
Entrá a Configuración.
Seleccioná la pestaña Métodos de Pago.
Buscá la sección de Mercado Pago.
Si hay una cuenta vinculada, Cactus muestra automáticamente la sección de configuración de Mercado Pago para ese local — no hace falta ningún clic adicional.

Desde ahí podés seleccionar el local de Mercado Pago y vincular las cajas de Cactus con sus puntos de venta.

4. Vincular el local y las cajas de Cactus con Mercado Pago

En la sección de Mercado Pago dentro de Métodos de Pago:

En Local de Mercado Pago, elegí el local que corresponde a ese negocio. Si no ves el que esperás, hacé clic en Actualizar Datos.
En la tabla Puntos de Venta, para cada caja de Cactus seleccioná el punto de venta, QR o terminal de Mercado Pago correspondiente.
Hacé clic en Guardar configuración.

Si no hay cajas configuradas en el local, primero crealas desde Configuración > Cajas.

5. Configurar QR y terminales Point

Según la información disponible de Mercado Pago, Cactus puede mostrar:

QR: acceso al código QR asociado al punto de venta.
Conectar: acción para conectar un QR si todavía no está asociado.
Terminal: identificador de una terminal Point asociada.
Modo PDV: modo que permite que la terminal procese pagos integrados con Cactus.
Standalone: modo independiente de Mercado Pago.

Si una terminal aparece en modo Standalone, podés usar Activar PDV para integrarla con Cactus. Si desactivás el modo PDV, la terminal deja de procesar pagos a través de Cactus hasta que vuelvas a activarlo.

Resultado esperado

Al finalizar, deberías ver la cuenta de Mercado Pago como Activa, el local de Mercado Pago correcto seleccionado y las cajas de Cactus vinculadas con sus puntos de venta, QR o terminales de Mercado Pago.

Si algo no sale como esperabas

Si no se abre Mercado Pago al agregar la cuenta, revisá el bloqueo de ventanas emergentes del navegador.
Si la cuenta queda en Pendiente, usá Reintentar para volver a autorizarla. Si queda en Necesita atención, usá Revincular.
Si no aparecen locales o cajas de Mercado Pago, usá Actualizar Datos.
Si no podés guardar la configuración, confirmá que elegiste un local de Mercado Pago y que las cajas del negocio existen en Cactus.
Si una terminal no procesa pagos desde Cactus, revisá si está en modo PDV o Standalone.
Si el problema continúa, contactá a soporte con el nombre de la cuenta, el local, la caja afectada y una captura del estado visible en Cactus.

Otras documentaciones