¿Qué es una orquestación?

Una orquestación es un flujo de enrutamiento que decide qué conexión gestiona cada pago. Puedes definir rutas distintas según variables del pago, del cliente o de la tarjeta y añadir conexiones alternativas que entren si la principal falla.

Para saber más sobre qué es la orquestación de pagos y para qué sirve, puedes leer este artículo del Academy o nuestros posts del blog:

• ¿Qué es la orquestación de pagos y en qué ayuda a tu negocio online?
• Cómo la orquestación de pagos disminuye los errores de procesamiento de tarjetas

Antes de crear una orquestación

• Puedes orquestar tres cosas distintas, según el trigger que elijas: procesadores de tarjeta entre sí, financieras entre sí, o las cuentas de un mismo método de pago. Lo que no puedes hacer es enrutar entre métodos distintos, por ejemplo pasar de Bizum a PayPal.
• Las conexiones que quieras usar tienen que estar añadidas y activas en Conexiones. Si no las has añadido antes, no te aparecerán al construir la orquestación.
• Si vas a orquestar procesadores de tarjeta, el procesador no puede estar en modo redirección. Al añadirlo en Conexiones, asegúrate de que indique "Sin redirección". Si aparece "con redirección", el flujo sale de Zru y no se puede redirigir a otro procesador.

El listado de orquestaciones

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

• Puedes alternar entre vista cuadrícula y vista lista con el toggle de la esquina superior derecha.
• El desplegable Todos los triggers filtra el listado por trigger: Primer pago, Pago recurrente, Pago físico, Financiación y Métodos alternativos.
• En la vista lista, el menú "..." de la cabecera de la tabla abre Personalizar tabla, donde eliges y reordenas las columnas. Se aplica con Aplicar cambios.
• El botón Exportar CSV, en la cabecera junto a Crear orquestación, descarga el contenido del listado.

✋ Exportar CSV solo aparece si tu rol tiene el permiso Exportar dentro de Entorno → Orquestaciones. Funciona igual que el permiso de exportación de Conexiones.

¿Cómo crear una orquestación?

• Ve a la sección Orquestaciones del menú vertical de la izquierda.
• Haz clic en "Crear orquestación".
• Se abrirá el canvas del editor. Escribe el nombre de la orquestación en el campo superior.
• Elige el trigger con el que quieres que se dispare esta orquestación (ver sección siguiente).
• Si eliges Método alternativo, lo siguiente que te pide es el método de pago sobre el que vas a enrutar (ver La tarjeta Método).
• A partir de ahí, construye el flujo añadiendo bloques desde el panel de la derecha.
• Cuando hayas terminado, haz clic en Publicar para que los cambios entren en vigor.

⚠️ Al publicar, los cambios se activan inmediatamente en todos los Checkouts que usen esa orquestación.

El canvas: cómo funciona

El editor de orquestaciones es un canvas visual. Puedes moverte por él arrastrando con el ratón y hacer zoom con el scroll del trackpad.

Al abrir una orquestación entras en vista de consulta, con el flujo dibujado pero sin poder tocarlo. En la cabecera encontrarás:

• Toggle de activación de la orquestación.
• Fecha de última actualización.
• Nombre de la orquestación.
• Contador de uso: cuántos Checkouts están usando esta orquestación.
• Botón Editar.

Al hacer clic en Editar pasas a la edición y la cabecera añade:

• Botones deshacer (↶) y rehacer (↷).
• Botón Publicar.

🧐 En vista de consulta no se ofrecen los menús de eliminar y el toggle de activación no se puede mover. El botón Editar solo aparece si tu rol tiene permiso de edición.

Los triggers

Al crear una orquestación, lo primero es elegir el trigger, es decir, qué tipo de pago va a activarla:

• Primer pago: pagos iniciados por el usuario en el momento del checkout.
• Pago recurrente: cobros recurrentes de autorizaciones o suscripciones.
• Pago físico: pagos realizados en un terminal físico (POS).
• Financiación: pagos que se resuelven con una financiera. Va del trigger directo a la acción y solo lista financieras.
• Método alternativo: enruta entre las cuentas de un mismo método de pago, como Bizum, PayPal o Klarna.

🧐 El trigger determina qué bloques y qué conexiones están disponibles en el canvas. Por ejemplo, con trigger "Pago físico" solo aparecen procesadores que admiten pago presencial.

✋ Financiación y Método alternativo enrutan dentro de un mismo método de pago, no entre procesadores de tarjeta. Por eso no ofrecen Ejecutar 3DS, Crear Network Token ni cadena de reintentos: solo Ruta y Dividir tráfico como utilidades, y Completar pago o Rechazar Pago como acciones. Al elegir Completar pago se abre directamente la selección de la cuenta, sin pantalla intermedia.

Las cuentas que se te ofrecen en cada bloque dependen del trigger: procesadores con los triggers de tarjeta, financieras con Financiación, y conexiones del método elegido con Método alternativo.

La tarjeta Método

Solo aparece con el trigger Método alternativo. Es una tarjeta propia, llamada Método, situada entre el trigger y el primer paso del flujo.

• Al crear la orquestación, lo primero que se te pide es elegir el método de pago.
• Para cambiarlo, haz clic sobre el método en la tarjeta: se abre un panel con un buscador y el listado de métodos disponibles.
• Para quitarlo, usa el menú "..." de la tarjeta, que ofrece la opción de eliminar.
• A partir de ese método, los bloques de acción solo ofrecen cuentas de ese método.

⚠️ Al eliminar la tarjeta Método se retira también el trigger y todo lo que hayas construido debajo.

Los bloques

Una vez elegido el trigger, construyes el flujo combinando bloques. Hay dos tipos: de utilidad (organizan el flujo) y de acción (ejecutan algo sobre el pago).

Bloques de utilidad:

• Ruta: divide el flujo en ramas según condiciones. Funciona como un switch/case (ver sección siguiente).
• Dividir tráfico: reparte el tráfico entre ramas en porcentajes configurables.

Bloques de acción:

• Completar pago: envía el pago a una conexión para que lo procese. Dentro de la tarjeta, + Añadir fallback añade conexiones de reintento que entran si la anterior falla.
• Rechazar Pago: corta el flujo y devuelve el pago como rechazado. Al configurarlo eliges qué error quieres que se devuelva, y la tarjeta muestra su código y su texto.
• Ejecutar 3DS: lanza la autenticación 3D Secure de forma independiente al procesador.
• Crear Network Token: tokeniza la tarjeta con el esquema de red antes de procesar.

No todos los bloques están disponibles con todos los triggers:

El bloque Ruta

El bloque Ruta es el más potente del editor. No es un simple "si/si no": funciona como un switch/case, donde cada condición que añades es una rama de salida independiente con su propio flujo.

Al añadir un bloque Ruta verás:

• Condición 1, Condición 2...: cada una es una rama. Puedes añadir tantas como necesites con el botón "+ Añadir condición" y eliminar cada una con su icono de papelera.
• Todos los demás: rama de fallback que se ejecuta cuando ninguna condición se cumple. Siempre está presente y no se puede eliminar.

Dentro de cada condición defines las variables que tiene que cumplir el pago para entrar por esa rama. Si añades varias variables a una misma condición, todas tienen que cumplirse a la vez (lógica AND).

Variables disponibles en una condición (33 en total)

Operación (12): Precio, Moneda, Tipo, Idioma, Solo autorizar el pago, MOTO, Aprobación parcial, POS, Terminal POS, Score de fraude, Autorizaciones recurrentes, Suscripciones recurrentes.

Cliente (9): Variable personalizada, Tipo de dispositivo, Sistema operativo, Navegador, País IP, Región IP, País, Región, Email.

Tarjeta (12): Marca, Tipo, Nivel, País de emisión, Banco emisor, Wallet utilizado, BIN, Network Token, Intento de Network Token, Titular, Mes de expiración, Año de expiración.

🧐 La categoría Tarjeta es exclusiva de orquestaciones. Los datos de la tarjeta solo se conocen en el momento de procesar el pago, no antes, por eso esta categoría no está disponible en Checkouts. El Score de fraude también es exclusivo de orquestaciones por la misma razón.

Configuración de una conexión dentro de un bloque

Para configurar una conexión que ya está en un bloque, haz clic directo sobre ella. Se abre un panel a la derecha, y lo que contiene depende del bloque y del trigger.

En todos los casos la cabecera del panel muestra la conexión con un botón Cambiar para sustituirla, y abajo un botón Guardar.

Con Completar pago y un trigger de tarjeta, el panel se titula "Configuración del procesador" y trae las cuatro secciones que verás a continuación. Con Financiación solo te deja cambiar la conexión: no hay 3D Secure, ni Network Token, ni condición general, ni conexiones secundarias, porque no aplican. En Ejecutar 3DS el panel se titula con el nombre del bloque y también solo te deja cambiar la conexión.

Condición general

Permite que esa conexión solo se use si se cumplen ciertas condiciones (mismas variables: Operación 10 + Cliente 9 + Tarjeta 12). Cuando no hay ninguna, la sección muestra "Sin condición", y se añaden con + Añadir condición. Si no añades ninguna, la conexión se ejecutará siempre.

Conexiones secundarias

Permite definir conexiones alternativas del mismo procesador que se usarán en lugar de la principal según ciertas condiciones. Se añaden con + Añadir conexión.

✋ Solo puedes añadir conexiones del mismo procesador que la principal. Por ejemplo, si la principal es Adyen, las secundarias también tienen que ser conexiones de Adyen.

Esto es útil cuando tienes varias cuentas del mismo procesador para distintos mercados (Europa, LATAM, US) y quieres usar la cuenta correcta según País IP o Moneda, sin necesidad de crear bloques separados.

3D Secure

Solo disponible en el bloque Completar pago.

Elige cómo quieres aplicar la autenticación 3DS en ese procesador:

• Agnóstico: usa la información del 3DS que ya se ejecutó en un bloque anterior ("Ejecutar 3DS") y la envía al procesador, sin volver a solicitar autenticación.
• Procesador: aplica 3DS siguiendo la decisión del procesador y del banco emisor, según sus reglas de riesgo.
• Procesador (Forzar 3DS): fuerza la autenticación 3DS en todas las operaciones, independientemente del importe o del riesgo.
• Sin 3DS: no aplica autenticación 3DS, aunque el emisor podría solicitarla igualmente.

Network Token

Solo disponible en el bloque Completar pago.

• Utilizar si existe: si la tarjeta tiene un network token, se usará en lugar del PAN para procesar el pago, mejorando la seguridad y la tasa de aprobación.
• No utilizar: el pago se procesa con los datos originales de la tarjeta, aunque exista un network token disponible.

¿Cómo modificar una orquestación?

• Ve a la sección Orquestaciones del menú vertical de la izquierda.
• Haz clic en la orquestación que quieras modificar. Se abrirá en vista de consulta.
• Haz clic en Editar para pasar a la edición.
• Realiza los cambios que necesites.
• Haz clic en Publicar para que entren en vigor.

⚠️ Al publicar, los cambios se activan inmediatamente en todos los Checkouts que usen esa orquestación.

🧐 Si sales de una orquestación con cambios sin publicar, el panel te pregunta antes de salir. Activar o desactivar la orquestación cuenta como cambio, así que tampoco se pierde sin aviso.

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

Desde el canvas, usa el toggle de activación en la cabecera para activar o desactivar la orquestación. En vista de consulta el toggle no se puede mover: entra primero en Editar.

También puedes hacerlo desde el listado: en la vista lista, cada orquestación muestra su estado y puedes gestionarla desde ahí.

Actualizado el: 01/09/2026