Por qué esta combinación importa
Cada componente resuelve una capa específica del problema:
Juntos, estos tres componentes forman un sistema de circuito cerrado. Las transacciones Pix llegan, el Fees Engine calcula las tarifas automáticamente y el ledger registra cada movimiento — los valores bruto, neto y de tarifa — en una única operación auditable.
Eligiendo tu modelo de participación Pix
El Plugin Pix soporta ambos modelos de participación definidos por BACEN. La integración de tarifas y el flujo del ledger de esta página se aplican a ambos. Solo cambia la conexión con BACEN.
Para una comparación detallada, consulta Plugin Pix Directo vs. Indirecto.
Escenario 1: Fintech lanzando Pix con tarifas automatizadas
Una fintech planea ofrecer Pix a sus clientes. Quiere cobrar una tarifa fija en cada Pix recibido (cash-in). La tarifa cubre los costos operacionales y suma ingresos sin complejidad adicional para el cliente. La lógica de tarifas y la estructura del ledger se mantienen iguales en ambos modelos. Esto vale 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 clientes finales
- Cobrar una tarifa transparente y configurable en transferencias recibidas
- Registrar cada tarifa en el ledger para compliance y reportes financieros
- Lanzar rápidamente, sin lógica de tarifas personalizada ni pipelines de reconciliación
Configurando con Midaz
La fintech primero estructura su entorno Midaz:1
Crear la Organización
Registra la fintech como una Organización en Midaz. Esta es la entidad de nivel superior que posee todos los ledgers, cuentas y transacciones.
2
Configurar el Ledger
Crea un Ledger para rastrear todas las transacciones de clientes y movimientos de tarifas. El Plugin Pix y el Fees Engine comparten este ledger.
3
Definir el Activo
Registra BRL como el activo operacional. Todas las transacciones Pix y cálculos de tarifas usan este activo.
4
Crear cuentas de clientes
Cada cliente recibe una cuenta en el ledger. Estas cuentas reciben créditos Pix y siguen las reglas de tarifas.
5
Crear cuentas de destino de tarifas
Configura cuentas internas para recibir créditos de tarifas — por ejemplo, una cuenta “Ingresos por Tarifas Pix”. La configuración del paquete del Fees Engine referencia estas cuentas.
6
Organizar con Segmentos
Usa Segmentos para agrupar clientes por nivel (ej.: Standard, Premium). Esto te permite aplicar diferentes paquetes de tarifas a diferentes grupos.
Configurando el Fees Engine
Con la estructura del ledger lista, la fintech configura un paquete de tarifas:- Tipo de tarifa: Tarifa fija de R$ 1,50 por Pix recibido
- Alcance: Aplicada a todas las transacciones de cash-in en el ledger principal
- Enrutamiento: El Fees Engine enruta los créditos de tarifa a la cuenta interna “Ingresos por Tarifas Pix”
- Exenciones: Agrega las cuentas del nivel Premium a la lista de cuentas exentas
Configuras los paquetes de tarifas 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 valor), el Fees Engine calcula y enruta la tarifa sin ningún paso manual.
Cómo fluye una transacción
Cuando un cliente recibe una transferencia Pix, esto es lo que sucede detrás de escena:1
Pix llega
La institución remitente inicia un Pix. Tu proveedor de conectividad (BTG para indirecto, JD para directo) recibe la transacción y notifica al Plugin Pix.
2
La transacción es validada
El plugin valida al destinatario: verifica que la cuenta existe, está activa y puede recibir fondos. El plugin también verifica los datos del CRM y la validez de la clave Pix.
3
La liquidación comienza
Después de que el plugin confirma la transacción, la liquidación comienza. El plugin obtiene los detalles de la cuenta de destino desde Midaz.
4
Las tarifas se calculan automáticamente
El Fees Engine evalúa la transacción contra los paquetes de tarifas disponibles. Encuentra un paquete coincidente y calcula la tarifa fija de R$ 1,50.
5
El Ledger registra el cuadro completo
Midaz registra la transacción con la distribución de tarifas en una única operación:
- Midaz acredita la cuenta del cliente con el valor neto (bruto menos tarifa).
- Midaz acredita la cuenta de destino de tarifa con R$ 1,50.
- Cada movimiento es rastreable, con precisión de partida doble.
6
Transacción completa
El cliente ve el crédito Pix en su cuenta. El ledger registra la tarifa de forma transparente para reportes y reconciliación.
Lo que esto desbloquea
- Sin lógica de tarifas personalizada — el Fees Engine maneja el cálculo, el enrutamiento y las exenciones.
- Ledger preciso — cada tarifa es un asiento en el ledger, no solo un metadato. Los auditores ven los mismos números que tu equipo financiero.
- Segmentación de clientes — el Fees Engine exime a los clientes Premium automáticamente mediante cuentas exentas.
- Flexibilidad de tarifas — cambia los valores, agrega tarifas porcentuales o introduce umbrales basados en valor sin cambios en tu pipeline de transacciones.
Escenario 2: Marketplace con Pix y tarifas proporcionales
Un marketplace B2B conecta compradores y vendedores. Los compradores pagan vía Pix, y el marketplace cobra una tarifa de servicio en cada transacción antes de distribuir el resto a los vendedores.
El objetivo de negocio
- Aceptar pagos Pix de compradores
- Cobrar una tarifa de servicio porcentual en cada pago
- Distribuir el valor neto proporcionalmente entre múltiples vendedores cuando un único pago cubre productos de diferentes vendedores
- Mantener un rastro de auditoría claro para cada split y tarifa
Configurando con Midaz
El marketplace estructura su entorno Midaz para reflejar la naturaleza multi-parte de sus operaciones:1
Crear la Organización
Registra el marketplace como una Organización en Midaz.
2
Configurar el Ledger
Crea un único Ledger para gestionar todos los flujos de pago — pagos de compradores, créditos de vendedores y tarifas del marketplace.
3
Definir el Activo
Registra BRL como el activo operacional.
4
Crear cuentas de vendedores
Cada vendedor recibe una cuenta en el ledger. Cuando un comprador paga vía Pix, Midaz distribuye el valor neto entre las cuentas de los vendedores relevantes.
5
Crear la cuenta de tarifa del marketplace
Una cuenta interna (ej.: “Tarifa de Servicio del Marketplace”) recibe la porción de tarifa de cada transacción.
6
Usar Segmentos para niveles de vendedores
Agrupa a los vendedores en segmentos (ej.: Vendedores Standard, Vendedores Socios) para aplicar diferentes tarifas por grupo.
Configurando el Fees Engine
El marketplace configura un paquete de tarifas con distribución proporcional:- Tipo de tarifa: 3% del valor de la transacción
- Alcance: Aplicada a todos los pagos Pix recibidos en el ledger del marketplace
- Distribución: El Fees Engine divide las tarifas proporcionalmente entre las cuentas de origen cuando una única transacción cubre múltiples vendedores
- Enrutamiento: Los créditos de tarifa van a la cuenta “Tarifa de Servicio del Marketplace”
- Deducible: El Fees Engine deduce la tarifa del monto de los vendedores (
isDeductibleFrom: true), así el comprador siempre envía el monto total
Cómo fluye una transacción
Un comprador adquiere R$ 1.000 en productos de tres vendedores:1
Comprador envía Pix
El comprador escanea un QR Code o usa una clave Pix para enviar R$ 1.000 al marketplace.
2
Pix llega al Plugin
El proveedor de conectividad procesa la transacción y notifica al Plugin Pix.
3
Las tarifas se calculan con split proporcional
El Fees Engine calcula una tarifa de 3% (R$ 30,00) y la distribuye proporcionalmente:
- Vendedor A: R 485,00 neto)
- Vendedor B: R 291,00 neto)
- Vendedor C: R 194,00 neto)
4
El Ledger registra cada movimiento
Midaz crea la transacción con distribución completa:
- Cuenta del Vendedor A: acreditada R$ 485,00
- Cuenta del Vendedor B: acreditada R$ 291,00
- Cuenta del Vendedor C: acreditada R$ 194,00
- Cuenta de tarifa del marketplace: acreditada R$ 30,00
- Total: R$ 1.000,00 — totalmente balanceado
5
Vendedores y marketplace son liquidados
Cada vendedor ve su crédito neto. El marketplace ve los ingresos por tarifas. Cada número tiene respaldo en un asiento del ledger.
Lo que esto desbloquea
- Split de ingresos automatizado — el Fees Engine maneja la distribución proporcional entre cualquier número de cuentas.
- Fijación de precios transparente para vendedores — cada vendedor ve la tarifa exacta y su motivo.
- Ledger balanceado — el valor bruto de entrada es igual a la suma de todos los créditos de salida. Sin diferencias de redondeo, sin ajustes manuales.
- Tarifas configurables — cambia el porcentaje, agrega mínimos fijos o exime socios específicos — todo a través de la configuración del paquete de tarifas.
Lo que necesitas para comenzar
Para ejecutar esta configuración, tu institución necesita:
El Plugin Pix y el Fees Engine requieren una licencia Lerian válida — el Fees Engine bajo el nivel Enterprise de Midaz. Para detalles de licencia, consulta la documentación de Licencia.
Estimando antes de ir a producción
Antes de procesar transacciones reales, usa la estimación del Fees Engine para verificar tu configuración de tarifas. La estimación te permite:
- Visualizar la tarifa exacta para un monto de transacción dado
- Verificar que las exenciones funcionan como se espera
- Confirmar que los splits proporcionales producen la distribución correcta
- Probar casos extremos como valores límite y cuentas exentas
Próximos pasos
Visión general del Fees Engine
Comprende paquetes de tarifas, reglas de cálculo y opciones de enrutamiento.
Usando el Fees Engine
Guía paso a paso para crear paquetes y procesar tarifas.
Pix Directo vs. Indirecto
Compara modelos de participación y elige el plugin correcto.
Pix Switch
Explora la arquitectura completa del Plugin Pix y modelos de conexión.