Por qué importa esta combinación
Cada componente resuelve una capa específica del problema:
Juntas, estas tres partes forman un sistema de ciclo cerrado. Llegan transacciones Pix, el Fees Engine calcula las comisiones automáticamente y el ledger registra cada movimiento (montos bruto, neto y de comisión) en una sola operación auditable.
Cómo elegir tu modelo de participación en Pix
El Pix Plugin admite 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. Solo cambia la conexión con BACEN.
Para una comparación detallada, consulta modelos de participación en Pix.
Escenario 1: 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 de forma transparente para informes y conciliación.
Qué habilita esto
- 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, no solo metadatos. 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.
Escenario 2: marketplace con Pix y comisiones proporcionales
Un marketplace B2B conecta compradores y vendedores. Los compradores pagan con Pix y el marketplace cobra una comisión de servicio en cada transacción antes de distribuir el resto a los vendedores.
El objetivo de negocio
- Aceptar pagos Pix de los compradores
- Cobrar una comisión de servicio porcentual en cada pago
- Distribuir el monto neto proporcionalmente entre varios vendedores cuando un solo pago cubre bienes de distintos vendedores
- Mantener un registro de auditoría claro de cada división y cada comisión
Configuración con Midaz
El marketplace estructura su entorno de Midaz para reflejar la naturaleza multiparte de sus operaciones:1
Crea la Organización
Registra al marketplace como Organización en Midaz.
2
Configura el Ledger
Crea un solo Ledger para gestionar todos los flujos de pago: pagos de compradores, créditos de vendedores y comisiones del marketplace.
3
Define el Activo
Registra BRL como el activo operativo.
4
Crea cuentas de vendedores
Cada vendedor recibe una cuenta en el ledger. Cuando un comprador paga con Pix, Midaz distribuye el monto neto entre las cuentas de vendedor correspondientes.
5
Crea la cuenta de comisiones del marketplace
Una cuenta interna (por ejemplo, “Marketplace Service Fee”) recibe la parte de comisión de cada transacción.
6
Usa Segmentos para niveles de vendedor
Agrupa a los vendedores en segmentos (por ejemplo, Standard Sellers, Partner Sellers) para aplicar distintas tasas de comisión por grupo.
Configuración del Fees Engine
El marketplace configura un paquete de comisiones con distribución proporcional:- Tipo de comisión: 3% del valor de la transacción
- Alcance: se aplica a todos los pagos Pix entrantes en el ledger del marketplace
- Distribución: el Fees Engine divide las comisiones proporcionalmente entre las cuentas de origen cuando una sola transacción cubre a varios vendedores
- Enrutamiento: los créditos de comisiones van a la cuenta “Marketplace Service Fee”
- Deducible: el Fees Engine descuenta la comisión del monto de los vendedores (
isDeductibleFrom: true), así el comprador siempre envía el monto completo
Cómo fluye una transacción
Un comprador compra R$ 1,000 en bienes de tres vendedores:1
El comprador envía el Pix
El comprador escanea un QR Code o usa una clave Pix para enviar R$ 1,000 al marketplace.
2
El Pix llega al Plugin
El proveedor de conectividad procesa la transacción y notifica al Pix Plugin.
3
Las comisiones se calculan con división proporcional
El Fees Engine calcula una comisión del 3% (R$ 30.00) y la distribuye proporcionalmente:
- Vendedor A: R 485.00 netos)
- Vendedor B: R 291.00 netos)
- Vendedor C: R 194.00 netos)
4
El ledger registra cada movimiento
Midaz crea la transacción con la distribución completa:
- Cuenta del Vendedor A: acreditada con R$ 485.00
- Cuenta del Vendedor B: acreditada con R$ 291.00
- Cuenta del Vendedor C: acreditada con R$ 194.00
- Cuenta de comisiones del marketplace: acreditada con R$ 30.00
- Total: R$ 1,000.00 (totalmente balanceado)
5
Se liquidan los vendedores y el marketplace
Cada vendedor ve su crédito neto. El marketplace ve los ingresos por comisiones. Cada número corresponde a un asiento del ledger.
Qué habilita esto
- División de ingresos automatizada: el Fees Engine se encarga de la distribución proporcional entre cualquier cantidad de cuentas.
- Precios transparentes para los vendedores: cada vendedor ve la comisión exacta y su motivo.
- Ledger balanceado: el monto bruto que entra es igual a la suma de todos los créditos que salen. Sin huecos de redondeo, sin ajustes manuales.
- Tasas configurables: cambia el porcentaje de comisión, agrega mínimos fijos o exime a socios específicos, todo desde la configuración del paquete de comisiones.
Qué necesitas para empezar
Para operar esta configuración, tu institución necesita:
El Pix Plugin y el Fees Engine requieren una licencia Lerian válida. El Fees Engine está dentro del nivel Midaz Enterprise. 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.