Qué hace cada componente
Cada componente resuelve una capa específica del problema:
Juntas, estas tres partes conectan el flujo de la aplicación Pix, el cálculo de comisiones y las contabilizaciones en el ledger. Valida el comportamiento exacto de las comisiones y la forma de las contabilizaciones contra el contrato del Fees Engine de tu despliegue.
Cómo elegir tu modelo de participación en Pix
El contrato de aplicación del Pix Plugin está diseñado para los dos modelos de participación que define BACEN. La integración de comisiones y el flujo del ledger de esta página aplican a ambos.
Para una comparación detallada, consulta modelos de participación en Pix.
Fintech que lanza Pix con comisiones automatizadas
Una fintech planea ofrecer Pix a sus clientes. Quiere cobrar una comisión fija en cada Pix entrante (cash-in). La comisión cubre costos operativos y suma ingresos sin complejidad extra para el cliente. La lógica de comisiones y la estructura del ledger son las mismas en los dos modelos. Esto se cumple tanto si la fintech es un participante indirecto (vía BTG) como si es un participante directo (vía JD).
El objetivo de negocio
- Ofrecer pagos Pix instantáneos a los clientes finales
- Cobrar una comisión transparente y configurable sobre las transferencias entrantes
- Registrar cada comisión en el ledger para cumplimiento e informes financieros
- Lanzar rápido, sin lógica de comisiones a medida ni pipelines de conciliación
Configuración con Midaz
La fintech primero estructura su entorno de Midaz:1
Crea la Organización
Registra a la fintech como Organización en Midaz. Es la entidad de nivel superior que posee todos los ledgers, cuentas y transacciones.
2
Configura el Ledger
Crea un Ledger para dar seguimiento a todas las transacciones de clientes y a los movimientos de comisiones. El Pix Plugin y el Fees Engine comparten este ledger.
3
Define el Activo
Registra BRL como el activo operativo. Todas las transacciones Pix y los cálculos de comisiones usan este activo.
4
Crea cuentas de clientes
Cada cliente recibe una cuenta bajo el ledger. Estas cuentas reciben créditos Pix y siguen las reglas de comisiones.
5
Crea cuentas de destino de comisiones
Configura cuentas internas para recibir los créditos de comisiones, por ejemplo una cuenta “Pix Fee Revenue”. La configuración del paquete del Fees Engine referencia estas cuentas.
6
Organiza con Segmentos
Usa Segmentos para agrupar clientes por nivel (por ejemplo, Standard, Premium). Esto permite aplicar distintos paquetes de comisiones a distintos grupos.
Configuración del Fees Engine
Con la estructura del ledger lista, la fintech configura un paquete de comisiones:- Tipo de comisión: comisión fija de R$ 1.50 por cada Pix entrante
- Alcance: se aplica a todas las transacciones de cash-in en el ledger principal
- Enrutamiento: el Fees Engine enruta los créditos de comisiones a la cuenta interna “Pix Fee Revenue”
- Exenciones: agrega las cuentas de nivel Premium a la lista de cuentas exentas
Configuras los paquetes de comisiones una vez y el Fees Engine los aplica automáticamente. Cuando una transacción Pix coincide con los criterios del paquete (ledger, segmento, rango de monto), el Fees Engine calcula y enruta la comisión sin ningún paso manual.
Cómo fluye una transacción
Cuando un cliente recibe una transferencia Pix, esto es lo que ocurre:1
Llega el Pix
La institución emisora inicia un Pix. Tu proveedor de conectividad (BTG para el indirecto, JD para el directo) recibe la transacción y notifica al Pix Plugin.
2
Se valida la transacción
El plugin valida al receptor: comprueba que la cuenta existe, está activa y puede recibir fondos. El plugin también comprueba los datos del CRM y la validez de la clave Pix.
3
Empieza la liquidación
Después de que el plugin confirma la transacción, empieza la liquidación. El plugin obtiene los datos de la cuenta de destino desde Midaz.
4
Las comisiones se calculan automáticamente
El Fees Engine evalúa la transacción contra los paquetes de comisiones disponibles. Encuentra un paquete coincidente y calcula la comisión fija de R$ 1.50.
5
El ledger registra el cuadro completo
Midaz registra la transacción con la distribución de comisiones en una sola operación:
- Midaz acredita en la cuenta del cliente el monto neto (bruto menos comisión).
- Midaz acredita R$ 1.50 en la cuenta de destino de comisiones.
- Cada movimiento es rastreable, con precisión de partida doble.
6
La transacción se completa
El cliente ve el crédito Pix en su cuenta. El ledger registra la comisión para informes y conciliación.
Qué obtiene la fintech
- Sin lógica de comisiones a medida: el Fees Engine se encarga del cálculo, el enrutamiento y las exenciones.
- Ledger exacto: cada comisión es un asiento del ledger. Los auditores ven los mismos números que ve tu equipo financiero.
- Segmentación de clientes: el Fees Engine exime a los clientes Premium automáticamente mediante cuentas exentas.
- Flexibilidad de comisiones: cambia valores de comisión, agrega comisiones porcentuales o introduce umbrales por monto sin cambios en tu pipeline de transacciones.
Qué necesitas para empezar
Para operar esta configuración, tu institución necesita:
El Pix Plugin requiere una licencia Lerian válida. Para los detalles de licencia, consulta la documentación de licencia.
Estimar antes de entrar en producción
Antes de procesar transacciones reales, usa la estimación del Fees Engine para revisar tu configuración de comisiones. La estimación permite:
- Ver de antemano la comisión exacta para un monto de transacción dado
- Comprobar que las exenciones funcionan como se espera
- Confirmar que las divisiones proporcionales producen la distribución correcta
- Probar casos límite como montos en el borde y cuentas exentas
Próximos pasos
Resumen del Fees Engine
Conoce los paquetes de comisiones, las reglas de cálculo y las opciones de enrutamiento.
Uso del Fees Engine
Guía paso a paso para crear paquetes y procesar comisiones.
Pix Directo vs. Pix Indirecto
Compara los modelos de participación y elige la ruta de conectividad adecuada.
Pix Lerian
Explora la interfaz unificada para pagos, claves, cobros y devoluciones.