¿Qué es una orquestación?

Una orquestación es un flujo de enrutamiento que decide qué procesador gestiona cada pago. Puedes definir rutas distintas según variables del pago, del cliente o de la tarjeta y añadir procesadores alternativos que entren si el 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

• Solo puedes orquestar procesadores de tarjeta. Otros métodos de pago como PayPal o Klarna no son orquestables.
• Los procesadores que quieras usar tienen que estar añadidos y activos en Conexiones. Si no los has añadido antes, no te aparecerán al construir la orquestación.
• 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.

¿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).
• 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.

En la cabecera del editor encontrarás:

• Toggle de activación de la orquestación.
• Fecha de última actualización.
• Nombre editable de la orquestación.
• Contador de uso: cuántos Checkouts están usando esta orquestación.
• Botones deshacer (↶) y rehacer (↷).
• Botón Publicar.

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).

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

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 un procesador para que lo procese.
• 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

Cuando añades una conexión a un bloque de acción (Completar pago, Ejecutar 3DS o Crear Network Token), puedes configurarla de dos formas:

• Haciendo clic directo sobre la conexión en el panel derecho.
• Con el menú "..." > Editar.

Se abre el panel "Configuración del procesador", con las siguientes secciones:

Condición general

Disponible en todos los bloques con conexiones.

Permite que esa conexión solo se use si se cumplen ciertas condiciones (mismas variables: Operación 10 + Cliente 9 + Tarjeta 12). Si no añades ninguna condición, la conexión se ejecutará siempre.

Conexiones secundarias

Disponible en todos los bloques con conexiones.

Permite definir conexiones alternativas del mismo procesador que se usarán en lugar de la principal según ciertas condiciones.

✋ 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á el canvas del editor.
• 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.

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

Desde el canvas del editor, usa el toggle de activación en la cabecera para activar o desactivar la orquestación.

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

Actualizado el: 12/05/2026