Flujo de Pago
El flujo de pago es el camino que recorre cada transacción hasta llegar al proveedor que la va a procesar. Ahí decides, por ejemplo, que los pagos en reales van a un proveedor y los pagos en pesos a otro, o que el 70% de las transacciones se procesan por un proveedor y el 30% por otro.
Construyes ese camino de forma visual: agregas las condiciones que necesites, las conectas entre sí y finalizas indicando el proveedor que debe recibir el pago.
Cómo funciona
Cada flujo pertenece a un único método de pago (tarjeta de crédito, tarjeta de débito, PIX, transferencia o billeteras digitales). Puedes crear todos los flujos que quieras para el mismo método, pero solo uno puede estar activo a la vez — el activo es el que se usa en los pagos.
Cuando llega un pago, la plataforma recorre el flujo activo de ese método, evalúa cada condición y envía la transacción al proveedor indicado al final del camino.
Si no hay ningún flujo activo para el método de pago, las transacciones de ese método no se procesan.
Antes de empezar
Para que un proveedor aparezca como opción al armar el flujo, debe estar:
- contratado y activo en tu cuenta;
- con las credenciales registradas;
- con las tarifas configuradas para el país y el método de pago;
- disponible para el método de pago que estás configurando.
Si un proveedor que esperas no aparece en la lista, revisa primero estos cuatro puntos. La lista de proveedores que se muestra en pantalla se arma a partir de lo que está habilitado en tu cuenta.
La pantalla de flujos
Accede a Flujo de pago en el menú. La pantalla muestra pestañas con los métodos de pago disponibles en tu cuenta y, en cada pestaña, la lista de flujos ya creados, con:
- Nombre del Flujo;
- Última Modificación;
- las acciones Editar y Ver, y el botón que activa o desactiva el flujo.
Creando un flujo paso a paso
1. Elige el método de pago
Selecciona la pestaña del método que quieres configurar y haz clic en Crear nuevo flujo.
El método queda definido por la pestaña de origen y no se puede cambiar después. Para configurar otro método, crea un nuevo flujo en la pestaña correspondiente.
2. Nombra el flujo
Completa el campo Nombre del Flujo en la parte superior de la pantalla. Usa hasta 100 caracteres y prefiere nombres que identifiquen la regla, como "Tarjeta de crédito — Brasil" o "PIX con balanceo".
Si dejas el campo vacío, la plataforma genera un nombre automático, como "Flujo de pago 1".
3. Agrega las condiciones
Usa los botones que están sobre el diagrama para agregar condiciones. Cada botón abre una ventana donde eliges los valores y, al confirmar en Agregar, un nuevo bloque aparece en el diagrama.
Puedes combinar todas las condiciones que necesites, una tras otra.
4. Conecta los bloques
Cada condición tiene dos salidas: Si y No. Arrastra desde cada salida hasta el siguiente bloque para armar el camino.
- La salida Si define qué ocurre cuando la condición se cumple;
- La salida No define qué ocurre cuando no se cumple.
Todas las condiciones deben tener las dos salidas conectadas. Si algún camino queda suelto, el flujo no se puede guardar.
5. Termina con un proveedor
Todo camino del flujo debe terminar en un bloque de PSP — el proveedor que va a procesar el pago. Un flujo con algún camino sin proveedor al final no se acepta.
6. Guarda
Haz clic en Guardar. Si todo está correcto, vuelves a la lista de flujos y el nuevo flujo aparece en la pestaña del método elegido.
Si algo está incompleto, un mensaje indica qué debes corregir. Consulta Mensajes que puedes encontrar.
Condiciones disponibles
| Condición | Qué hace | Disponible en |
|---|---|---|
| País | Dirige el pago según el país de la transacción | Todos los métodos |
| Moneda | Dirige el pago según la moneda | Todos los métodos |
| Marca de Tarjeta | Dirige según la marca de la tarjeta | Tarjeta de crédito y tarjeta de débito |
| Cuotas | Dirige según la cantidad de cuotas | Tarjeta de crédito |
| Valor | Dirige según el monto del pago | Todos los métodos |
| Balanceador | Divide los pagos entre proveedores por porcentaje | Todos los métodos |
| PSP | Define el proveedor que procesa el pago (fin del camino) | Todos los métodos |
Sobre la condición Valor
Al configurar la condición Valor, elige el operador (Mayor que, Mayor o
igual, Menor que, Menor o igual, Igual o Diferente) e informa el monto en la
moneda del pago — por ejemplo, 100 para $100,00. No es necesario convertirlo a
centavos.
Sobre la condición Cuotas
Disponible solo para tarjeta de crédito. Úsala para enviar, por ejemplo, los pagos en una sola cuota a un proveedor y los pagos en cuotas a otro.
Proveedor principal y proveedores alternativos
Puedes encadenar proveedores para que, si el primero no logra procesar el pago, la plataforma intente automáticamente con el siguiente.
Para eso, conecta la salida de un bloque de proveedor al siguiente bloque de proveedor. El orden de la conexión define la prioridad:
[ PSP A ] ──► [ PSP B ] ──► [ PSP C ]
principal alternativo alternativo
En este ejemplo, todos los pagos van primero al PSP A. Si no puede procesarlos, la plataforma intenta con el PSP B y luego con el PSP C.
Dividiendo pagos entre proveedores
El Balanceador distribuye las transacciones entre dos o más proveedores según los porcentajes que definas.
- Haz clic en Balanceador;
- Informa el porcentaje de cada franja y usa Agregar más para crear nuevas franjas;
- Confirma en Agregar;
- Conecta cada franja al proveedor que debe recibirla.
La suma de los porcentajes debe ser exactamente 100% y el balanceador debe tener como mínimo dos franjas. Cada franja también debe terminar en un proveedor.
Ejemplos prácticos
Un proveedor para cada moneda
[ ¿Moneda es BRL? ] ──Si──► [ PSP A ]
└──────────No───► [ PSP B ]
Los pagos en reales van al PSP A; los demás van al PSP B.
Proveedor con alternativos
[ ¿País es BR? ] ──Si──► [ PSP A ] ──► [ PSP B ]
└─────────No───► [ PSP C ]
Los pagos de Brasil van al PSP A y, si falla, al PSP B. Los pagos de otros países van al PSP C.
División por porcentaje
┌── 70% ──► [ PSP A ]
[ Balanceador ] ──────┤
└── 30% ──► [ PSP B ]
El 70% de las transacciones las procesa el PSP A y el 30% el PSP B.
Combinando condiciones
[ ¿Valor mayor que 500? ] ──Si──► [ PSP A ] ──► [ PSP B ]
└──────────────No───► [ Balanceador ] ─┬─ 50% ─► [ PSP A ]
└─ 50% ─► [ PSP C ]
Los pagos superiores a 500 van al PSP A, con el PSP B como alternativo. Los demás se dividen en partes iguales entre el PSP A y el PSP C.
Activando el flujo
En la lista de flujos, usa el botón de estado para activar o desactivar un flujo. El estado cambia de inmediato y pasa a valer para las próximas transacciones.
Solo puede existir un flujo activo por método de pago. Si guardas un nuevo flujo mientras otro ya está activo, el nuevo se crea como Inactivo. Para usarlo, desactiva primero el flujo actual y luego activa el nuevo.
Editando, viendo y eliminando
| Acción | Qué ocurre |
|---|---|
| Editar | Abre el diagrama para modificarlo. Al guardar, se aplican las mismas validaciones. |
| Ver | Abre el diagrama solo para consulta, sin permitir cambios. |
| Eliminar | Elimina el flujo y todas sus condiciones. La acción no se puede deshacer. |
Modificar o desactivar un flujo activo afecta de inmediato a las próximas transacciones. Es preferible hacer los cambios en un flujo inactivo y activarlo cuando esté listo.
Qué ocurre cuando llega un pago
- La plataforma identifica el método de pago de la transacción;
- Localiza el flujo activo de ese método en tu cuenta;
- Recorre las condiciones, siguiendo el camino Si o No según los datos del pago;
- Al llegar a un balanceador, elige la franja según los porcentajes configurados;
- Al llegar al proveedor, verifica que esté activo y con credenciales válidas;
- Envía el pago al proveedor. Si hay alternativos configurados y el primero falla, intenta con el siguiente en orden de prioridad.
Mensajes que puedes encontrar
| Mensaje | Qué hacer |
|---|---|
Es necesario seleccionar al menos una condición para este PSP. | Agrega al menos una condición antes de guardar el flujo. |
El flujo debe tener ambos caminos (si y no) para ser válido | Alguna condición tiene una salida suelta. Conecta los caminos Si y No. |
El flujo no termina con un PSP | Algún camino no llega a un proveedor. Finaliza todos los caminos con un bloque de PSP. |
El nombre del PSP principal no puede ser nulo | Un bloque de proveedor quedó sin proveedor seleccionado. Ábrelo y elige uno. |
Ya existe un flujo activo para este método de pago | Desactiva el flujo actual antes de activar el nuevo. |
La suma de los % debe ser igual a 100% | Ajusta los porcentajes del balanceador para que sumen exactamente 100. |
No hay PSP disponible para la moneda: ... | Ningún proveedor de tu cuenta atiende esa moneda. Elige otra moneda o contrata un proveedor compatible. |
No hay PSP disponible para el país: ... | Ningún proveedor de tu cuenta atiende ese país. |
No hay PSP disponible para la marca de tarjeta: ... | Ningún proveedor de tu cuenta acepta esa marca de tarjeta. |
Moneda ... no soportada por el PSP: ... | El proveedor elegido no opera con esa moneda. Elige otro proveedor o ajusta la condición. |
País ... no soportado por el PSP: ... | El proveedor elegido no opera en ese país. |
Buenas prácticas
- Usa nombres que identifiquen la regla del flujo, no solo números;
- Configura al menos un proveedor alternativo para los caminos más usados;
- Arma y revisa el flujo mientras está inactivo y recién entonces haz el cambio;
- Después de activarlo, realiza una transacción de prueba para confirmar el comportamiento;
- Al contratar un nuevo proveedor, recuerda editar los flujos que deben pasar a usarlo.
Preguntas frecuentes
¿Puedo tener más de un flujo para el mismo método de pago?
Sí. Puedes mantener varios flujos creados, pero solo uno puede estar activo por método de pago.
¿Puedo cambiar el método de pago de un flujo ya creado?
No. El método se define al crear el flujo. Para otro método, crea un nuevo flujo en la pestaña correspondiente.
¿Qué ocurre si desactivo todos los flujos de un método?
Las transacciones de ese método dejan de procesarse. Mantén siempre un flujo activo para cada método que utilices.
¿Necesito modificar el flujo al contratar un nuevo proveedor?
Sí. El proveedor pasa a estar disponible como opción, pero solo recibe pagos después de ser incluido en un flujo activo.
¿Por qué mi flujo se creó como inactivo?
Porque ya existía otro flujo activo para el mismo método de pago. Desactiva el anterior y activa el nuevo.