¿Qué es una conexión en Zru?

Zru es un agregador de métodos de pago. Pero además de conectar con procesadores de pago, también te permite conectar con otras herramientas: antifraude, gestión de chargebacks, 3DS Agnóstico, Network Token, etc.

Por eso la sección se llama Conexiones y no simplemente "métodos de pago": puedes utilizarla para añadir tanto procesadores como herramientas de gestión de pagos, todo con unos pocos clics desde el panel.

A lo largo de esta guía usaremos el término "proveedor" para referirnos tanto a métodos de pago como a herramientas.

Diferencia entre Conexión y Método de pago

En el panel diferenciamos lo que es una conexión y un método de pago para que la gestión sea más sencilla. Todo se agrupa por proveedor.

Algunos puntos clave:

• Una conexión puede englobar uno o varios métodos de pago.
• Existen conexiones sin métodos de pago, como 3DS Agnóstico, que es un proveedor de servicios y no de pago.
• Los métodos de pago siempre viven dentro de una conexión.
• Las credenciales se introducen una sola vez en la conexión, no en cada método de pago por separado.

Algunos ejemplos:

• Redsys es una conexión con tres métodos de pago: Tarjeta, Bizum y Tarjeta Redirección.
• dLocal es una conexión con varios métodos de pago: Tarjeta, dLocal Redirección, 7-eleven, etc.
• Inespay es una conexión con un único método de pago: Transferencia.
• 3DS Agnóstico es una conexión sin métodos de pago.

Antes de añadir una conexión

Zru es una plataforma tecnológica: te conecta con el proveedor, pero primero necesitas tener una cuenta con ellos.

• En algunos casos tenemos acuerdos con el proveedor y podemos ponerte directamente en contacto. Lo verás al añadir la conexión: aparecerá la etiqueta "Partner".
• En otros casos lo gestionamos nosotros y no necesitas cuenta en ningún proveedor externo, como ocurre con 3DS Agnóstico o Network Token.

Una vez tengas cuenta con el proveedor, te darán unas credenciales que introducirás en el panel para configurar la conexión.

✋ Ten en cuenta que según la región o país en que esté tu empresa podrás o no utilizar algunos proveedores, ya que cada uno da servicio en determinados países.

El listado de Conexiones

Ve a la sección Conexiones del menú vertical de la izquierda. Verás dos pestañas: Activas y Desactivadas.

Puedes buscar por nombre de conexión o de método con el buscador, y acotar con los filtros Todas las categorías y Todas las monedas. El botón Exportar CSV descarga el listado.

Las columnas del listado son:

• Conexión: nombre del proveedor.
• Categoría: tipo de conexión (Procesador, Banca, BNPL, Marketplace, Seguridad, etc.).
• Métodos de pago: métodos activos dentro de esa conexión.
• Uso: dos iconos que indican si la conexión está siendo usada en orquestaciones y/o en Checkouts. Al hacer hover sobre cada icono aparece un tooltip con los nombres concretos.
• Fecha de conexión: cuándo se añadió.

¿Cómo añadir una conexión?

La creación de una conexión se hace en una vista dedicada paso a paso.

Paso 1 — Selecciona la conexión

• Ve a la sección Conexiones del menú vertical de la izquierda.
• Haz clic en "Nueva conexión".
• Busca la conexión que te interesa por nombre, o acota con los filtros de moneda y categoría.
• Cada tarjeta muestra el proveedor, una descripción breve, su categoría y los métodos de pago que soporta. Si tenemos acuerdo con el proveedor, verás la etiqueta "Partner".
• Haz clic en la conexión que quieras.

Paso 2 — Configura las credenciales

Se abrirá un panel lateral con la configuración de la conexión.

• Escribe el nombre con el que aparecerá la conexión en el checkout.
• En el bloque Credenciales de [proveedor], rellena las credenciales que te haya facilitado.

✋ Si estás en un entorno de prueba, introduce las credenciales de prueba. Si es un entorno de producción, las de producción.

En entornos de prueba, si el procesador es compatible, podrás elegir entre dos opciones:

• Mis credenciales: usa tus propias credenciales de prueba del procesador. Selecciónala si ya tienes una cuenta activa con ellos.
• Credenciales de Zru: Zru te proporciona las credenciales de sandbox. Útil para empezar a probar sin necesidad de tener cuenta propia en el procesador.

Según el proveedor verás campos y opciones específicas (por ejemplo, activar o forzar 3DS). Si quieres asignar un identificador propio a la conexión, despliega Configuración avanzada y rellena el campo Código interno.

• Haz clic en "Continuar".

Paso 3 — Añade los métodos de pago

En el panel lateral Añadir métodos de pago:

• Selecciona los métodos que quieres activar, o usa "Seleccionar todos".
• Haz clic en "Añadir métodos".

La conexión se crea activa por defecto. Verás un aviso que te invita a empezar a operar añadiendo la conexión a tus Orquestaciones o Checkouts.

El detalle de una conexión

Al hacer clic en una conexión verás su detalle. En la cabecera se muestran la Conexión (proveedor), la Categoría, el Uso en orquestaciones y Checkouts, la Fecha de conexión y su estado.

Debajo está la sección Métodos de pago, con su propio buscador y filtros (Todos los estados, Todas las monedas). Para cada método puedes consultar:

• Uso: en cuántas orquestaciones y Checkouts se está usando.
• Pagos / Aceptación: número de pagos procesados y su tasa de aceptación.
• Monedas: monedas en las que opera el método.
• Última modificación: cuándo se actualizó por última vez.
• Estado: activa o desactiva el método con el toggle, sin salir de la tabla.

Desde aquí también puedes eliminar un método con el icono de papelera.

🧐 Si una conexión no tiene ningún método activo, el panel te avisa para que añadas alguno y la conexión pueda empezar a operar.

Configuración avanzada de una conexión

Dentro del detalle de una conexión, haz clic en "Configuración" arriba a la derecha. Se abrirá un panel con el acordeón Configuración avanzada, que incluye el campo Código interno.

🧐 El código interno se envía en la notificación dentro de _gateway, en el campo internal_code. Es útil si necesitas identificar de qué conexión proviene un pago en tus sistemas.

También puedes rellenar este campo durante la creación de la conexión, en el paso de credenciales.

¿Cómo activar o desactivar una conexión?

Para desactivar una conexión

• Ve a la sección Conexiones del menú vertical de la izquierda.
• Haz clic en la conexión que quieres desactivar, dentro de la pestaña Activas.
• Haz clic en "Configuración" arriba a la derecha y desactiva "Estado de la conexión" al final del módulo.
• Haz clic en "Actualizar".

La conexión pasará a la pestaña Desactivadas.

Para activar una conexión

• Ve a la sección Conexiones del menú vertical de la izquierda.
• Haz clic en la pestaña Desactivadas.
• Haz clic en la conexión que quieres activar.
• Haz clic en "Configuración" arriba a la derecha y activa "Estado de la conexión" al final del módulo.
• Haz clic en "Actualizar".

✋ Ten en cuenta que activar la conexión no activa automáticamente los métodos incluidos. Debes entrar en la conexión y activar los métodos que desees con el toggle de Estado.

¿Cómo modificar una conexión?

• Ve a la sección Conexiones del menú vertical de la izquierda.
• Haz clic en la conexión que quieres modificar.
• Haz clic en "Configuración" arriba a la derecha.
• Cambia los parámetros que necesites.
• Haz clic en "Actualizar" para guardar los cambios.

¿Puedo borrar una conexión?

Actualmente no es posible borrar una conexión. Si ya no la necesitas, mantenla desactivada. Siempre puedes volver a activarla cuando quieras.

¿Dónde puedo usar las conexiones?

Los métodos de pago de cada conexión (o la conexión en sí, si no es un procesador de pago) estarán disponibles como opción al configurar tus Orquestaciones y tus Checkouts.

Actualizado el: 30/06/2026