Por qué esto importa
Para equipos de producto y operaciones, las Transaction Routes te dan flujos Pix auditables sin cumplimiento a nivel de aplicación. Cada transacción lleva una referencia a la ruta que siguió, así las revisiones de cumplimiento y las investigaciones de incidentes se mantienen simples. Para equipos de ingeniería, las rutas eliminan código de validación repetitivo. Configuras las reglas de cuenta y de tarifa una vez. Luego Midaz las aplica a nivel de ledger en cada integración Pix.
Para una mirada más profunda sobre cómo funcionan las Transaction Routes y las Operation Routes, consulta Rutas Contables.
Requisitos previos
Ambos escenarios asumen 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 vía Pix. El dinero se mueve de una cuenta corriente a otra — sin tarifas, sin divisiones, solo una transferencia limpia entre pares.
El objetivo
- Debitar la cuenta corriente de Alice en R$ 150,00
- Acreditar la cuenta corriente de Bob en R$ 150,00
- Validar que ambas cuentas sean del tipo
checkingantes de procesar - Hacer este patrón reutilizable para cada transferencia Pix entre cuentas corrientes
Configurar las rutas
1
Crear la Operation Route de origen
Esta ruta define el lado de débito de la transferencia. La regla Guarda el
account_type acepta cualquier cuenta del tipo checking como origen. La ruta no codifica un emisor específico.id devuelto — lo necesitas al construir la Transaction Route.2
Crear la Operation Route 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 Transaction Route
Agrupa ambas Operation Routes en una sola Transaction Route. Esta ruta representa “Transferencia Pix” en tu sistema.Reemplaza los IDs de ejemplo con los IDs reales de las Operation Routes de los pasos anteriores.
Ejecutar una transferencia Pix
Con la ruta establecida, cada transferencia Pix hace referencia al ID de la Transaction Route en el camporouteId. Midaz valida que las cuentas coincidan con las reglas de la ruta antes de procesar la transacción.
Qué sucede internamente
1
Midaz recibe la transacción
La solicitud lleva el ID de la Transaction Route en el campo
routeId. Midaz carga la configuración de la ruta.2
Validación del origen
Para cada entrada
from, Midaz verifica la cuenta contra las reglas de la Operation Route de origen. La cuenta de Alice es del tipo checking, así que coincide con la regla account_type. La validación pasa.3
Validación del destino
Para cada entrada
to, Midaz verifica la cuenta contra las reglas de la Operation Route de destino. La cuenta de Bob es del tipo checking, así que la validación pasa.4
Midaz procesa la transacción
Ambas validaciones pasan, así que Midaz crea la transacción atómicamente. Debita
@alice_checking en R$ 150,00 y acredita @bob_checking en R$ 150,00.Escenario 2: Transferencia Pix con cobro de tarifa
Este flujo coincide con el Escenario 1, pero ahora el banco cobra una tarifa de R$ 1,50 en cada transferencia Pix. El flujo agrega una tercera Operation Route para el destino de la tarifa, y el débito total de Alice aumenta a R$ 151,50.
Qué cambia
Ya tienes las Operation Routes de origen y destino del Escenario 1. Agregas una Operation Route para la tarifa y una nueva Transaction Route que agrupa las tres.Configurar la ruta de tarifa
1
Crear la Operation Route de tarifa
Las rutas anteriores usan
account_type. Esta usa el tipo de regla alias en su lugar. Apunta a una cuenta específica — @revenue_pix_fees — y ninguna otra cuenta califica.2
Crear la Transaction Route con tarifa
Esta ruta agrupa las rutas de origen y destino originales con la nueva ruta de tarifa. Es una Transaction Route separada de la transferencia simple, así que tu sistema puede ofrecer ambas variantes.
Ejecutar una transferencia Pix con tarifa
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é habilita esto
- Cobro de tarifas transparente — la tarifa es una entrada de ledger de primera clase, no metadatos ocultos. Los equipos de finanzas y cumplimiento ven exactamente a dónde fueron los R$ 1,50.
- Bloques de construcción reutilizables — las variantes simple y con tarifa comparten las Operation Routes de origen y destino. Solo agregas lo que cambia.
- Control a nivel de ruta — tu sistema puede ofrecer tanto “Transferencia Pix” como “Transferencia Pix con Tarifa” como productos distintos, cada uno respaldado por su propia Transaction Route.
- Evolución fácil — para agregar una tarifa basada en porcentaje o una división entre cuentas de ingresos, crea nuevas Operation Routes y compón una nueva Transaction Route. Los flujos existentes permanecen intactos.
Entender los tipos de regla
Los dos tipos de regla sirven propósitos diferentes. La elección correcta depende de si la cuenta en una ruta es dinámica o fija.
Qué necesitas para comenzar
Debes habilitar la validación de Transaction Route para cada ledger. Consulta Trabajando con las Rutas Contables para los pasos de configuración.
Próximos pasos
Rutas Contables
Entiende cómo funcionan las Operation Routes y Transaction Routes a un nivel más profundo.
Transacciones
Aprende sobre el modelo de transacciones de doble entrada de Midaz y las capacidades N:N.
Pix con tarifas automatizadas
Combina el Plugin Pix con el Fees Engine para la gestión automatizada de tarifas.
Pix Switch
Explora la arquitectura completa del Plugin Pix y los modelos de conexión.