¿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 palabra "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 cambiar entre vista cuadrícula y vista lista con el toggle de la esquina superior derecha. En vista lista, las columnas son:

• Conexión: nombre del proveedor.
• 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?

El proceso se divide en tres pasos:

Paso 1 — Conexión

• Ve a la sección Conexiones del menú vertical de la izquierda.
• Haz clic en "Nueva conexión".
• Selecciona la conexión que te interesa. Puedes usar el buscador o filtrar por moneda y categoría para encontrarla más rápido.
• Haz clic en "Conectar".

Paso 2 — Credenciales

• Escribe el nombre con el que aparecerá la conexión en el panel.
• Rellena las credenciales que te haya facilitado el proveedor.

✋ 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, verás la sección "Credenciales de [procesador]" con dos opciones:

• Mis credenciales: usa tus propias credenciales de prueba del procesador. Selecciona esta opción 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.

• Si quieres que la conexión quede desactivada de entrada, desmarca el toggle "Activo".
• Haz clic en "Conectar".

Paso 3 — Métodos

• Selecciona los métodos de pago que quieres activar dentro de la conexión.
• Haz clic en "Añadir métodos".

Una vez creada la conexión, ya puedes usarla en tus Orquestaciones y/o Checkouts.

El detalle de una conexión

Al hacer clic en una conexión verás el detalle con la tabla de métodos activos. Para cada método puedes consultar:

• Completados / Usos: número de pagos completados sobre el total de usos.
• Pagos: volumen total procesado.
• Conversión%: tasa de conversión del método.

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

Configuración avanzada de una conexión

Dentro del detalle de una conexión, haz clic en el botón "Configurar" de arriba a la derecha. Se abrirá un modal con un acordeón de 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 configurar este campo durante el proceso de 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.
• Una vez dentro, ve a "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.
• Ve a "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 uno a uno.

¿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: 01/05/2026