Por qué importa
Para los equipos de producto y de operaciones, las rutas de transacción dan flujos Pix auditables sin aplicación de reglas en el nivel de la aplicación. Cada transacción lleva una referencia a la ruta que siguió, así que las revisiones de cumplimiento y las investigaciones de incidentes se mantienen simples. Para los equipos de ingeniería, las rutas eliminan el código de validación repetitivo. Configuras las reglas de cuenta y de comisión una vez. Midaz entonces las aplica en el nivel del ledger en cada integración Pix.
Para una mirada más profunda a cómo funcionan las rutas de transacción y las rutas de operación, ve Rutas contables.
Requisitos previos
Ambos escenarios suponen un entorno Midaz con la siguiente estructura ya establecida:
Los valores en Midaz son montos decimales. Para BRL,
150.00 significa R$ 150.00.Escenario 1: Transferencia Pix simple
Alice envía R$ 150.00 a Bob por Pix. El dinero se mueve de una cuenta corriente a otra, sin comisiones y sin divisiones.
El objetivo
- Debitar R$ 150.00 de la cuenta corriente de Alice
- Acreditar R$ 150.00 en la cuenta corriente de Bob
- Validar que ambas cuentas son de tipo
checkingantes de procesar - Hacer este patrón reutilizable para cada transferencia Pix entre cuentas corrientes
Configurar las rutas
1
Crear la ruta de operación de origen
Esta ruta define el lado de débito de la transferencia. La regla Guarda el
account_type acepta cualquier cuenta de tipo checking como origen. La ruta no fija un remitente específico en el código.id devuelto. Lo necesitas cuando construyes la ruta de transacción.2
Crear la ruta de operación de destino
Esta ruta define el lado de crédito. Usa el mismo tipo de regla: cualquier cuenta
checking califica como receptor válido.3
Crear la ruta de transacción
Agrupa ambas rutas de operación en una sola ruta de transacción. Esta ruta representa “Pix Transfer” en tu sistema.Reemplaza los IDs de marcador de posición con los IDs reales de las rutas de operación de los pasos anteriores.
Ejecutar una transferencia Pix
Con la ruta establecida, cada transferencia Pix referencia el ID de la ruta de transacción en el camporouteId. Midaz valida que las cuentas coinciden con las reglas de la ruta antes de procesar la transacción.
Qué pasa por debajo
1
Midaz recibe la transacción
La solicitud lleva el ID de la ruta de transacción en el campo
routeId. Midaz carga la configuración de la ruta.2
Validación del origen
Para cada entrada
from, Midaz revisa la cuenta contra las reglas de la ruta de operación de origen. La cuenta de Alice es de tipo checking, así que coincide con la regla account_type. La validación pasa.3
Validación del destino
Para cada entrada
to, Midaz revisa la cuenta contra las reglas de la ruta de operación de destino. La cuenta de Bob es de tipo checking, así que la validación pasa.4
Midaz procesa la transacción
Ambas validaciones pasan, así que Midaz crea la transacción de forma atómica. Debita R$ 150.00 de
@alice_checking y acredita R$ 150.00 en @bob_checking.Escenario 2: Transferencia Pix con cobro de comisión
Este flujo coincide con el escenario 1, pero ahora el banco cobra una comisión de R$ 1.50 en cada transferencia Pix. El flujo agrega una tercera ruta de operación para el destino de la comisión, y el débito total de Alice sube a R$ 151.50.
Qué cambia
Ya tienes las rutas de operación de origen y de destino del escenario 1. Agregas una ruta de operación para la comisión y una ruta de transacción nueva que agrupa las tres.Configurar la ruta de comisión
1
Crear la ruta de operación de comisión
Las rutas anteriores usan
account_type. Esta usa el tipo de regla alias en cambio. Apunta a una cuenta específica, @revenue_pix_fees, y ninguna otra cuenta califica.2
Crear la ruta de transacción con comisión
Esta ruta agrupa las rutas originales de origen y de destino con la ruta de comisión nueva. Es una ruta de transacción separada de la transferencia simple, así que tu sistema puede ofrecer ambas variantes.
Ejecutar una transferencia Pix con comisión
Alice envía R$ 150.00 a Bob. El banco cobra R$ 1.50. El débito total de Alice es R$ 151.50.Qué desbloquea esto
- Cobro de comisión transparente: la comisión es un asiento de primera clase en el ledger, no un metadato oculto. Los equipos de finanzas y de cumplimiento ven exactamente adónde fue el R$ 1.50.
- Bloques de construcción reutilizables: las variantes simple y con comisión comparten las rutas de operación de origen y de destino. Agregas solo lo que cambia.
- Control en el nivel de la ruta: tu sistema puede ofrecer tanto “Pix Transfer” como “Pix Transfer with Fee” como productos distintos, cada uno respaldado por su propia ruta de transacción.
- Evolución fácil: para agregar una comisión porcentual o una división entre cuentas de ingresos, crea rutas de operación nuevas y compón una ruta de transacción nueva. Los flujos existentes quedan intactos.
Entender los tipos de regla
Los dos tipos de regla sirven para propósitos distintos. La elección correcta depende de si la cuenta en una ruta es dinámica o fija.
Qué necesitas para empezar
Debes habilitar la validación de rutas de transacción para cada ledger. Ve Trabajar con rutas contables para los pasos de configuración.
Próximos pasos
Rutas contables
Entiende cómo funcionan las rutas de operación y las rutas de transacción en un nivel más profundo.
Transacciones
Conoce el modelo de transacciones de partida doble de Midaz y sus capacidades N:N.
Pix con comisiones automatizadas
Combina el Pix Plugin con el Fees Engine para la gestión automatizada de comisiones.
Pix Lerian
Explora la interfaz unificada para pagos, claves, cobranzas y devoluciones.