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.
Inactive: la cuenta está desactivada y puede requerir reactivación.
Setup: la conexión quedó incompleta o requiere reintentar la autorizació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 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 Cactus muestra una cuenta vinculada, hacé clic en Configurar.

Desde la configuración del local podés seleccionar la sucursal de Mercado Pago y vincular las cajas de Cactus con las cajas o puntos de venta de Mercado Pago.

4. Seleccionar la sucursal de Mercado Pago

En la configuración de Mercado Pago del local:

En Sucursal de Mercado Pago, elegí la sucursal que corresponde a ese local.
Si no ves la sucursal esperada, hacé clic en Actualizar Datos.
Confirmá que la sucursal elegida coincide con el local físico de Cactus.

La sucursal correcta es importante porque de ella dependen los puntos de venta, QR y terminales disponibles para mapear.

5. Vincular cajas de Cactus con Mercado Pago

En Mapeo de Cajas, Cactus muestra las cajas del local y permite asociarlas con una caja, QR o terminal de Mercado Pago.

Para cada caja:

Ubicá la Caja Cactus que querés configurar.
En Caja Mercado Pago, seleccioná el punto de venta correspondiente.
Repetí el proceso para cada caja que vaya a cobrar con Mercado Pago.
Hacé clic en Guardar Cambios o Guardar configuración.
Confirmá los cambios si Cactus muestra una advertencia.

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

6. 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, la sucursal correcta seleccionada en el local 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 Setup, usá Reintentar para volver a autorizarla.
Si no aparecen sucursales o cajas de Mercado Pago, usá Actualizar Datos.
Si no podés guardar la configuración, confirmá que elegiste una sucursal y que las cajas del local 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