Por qué esta combinación importa
Cada componente resuelve una capa específica del problema:
Cuando están conectados, estos tres componentes crean un sistema de circuito cerrado: las transacciones Pix llegan, las tarifas se calculan automáticamente y el Ledger registra cada movimiento — 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 descritos en esta página se aplican igualmente a ambos — la diferencia radica en cómo tu institución se conecta a la infraestructura de BACEN.
Para una comparación detallada, consulta Plugin Pix Directo vs. Indirecto.
Escenario 1: Fintech lanzando Pix con tarifas automatizadas
Una fintech se está preparando para ofrecer Pix a sus clientes. Necesita cobrar una tarifa fija en cada Pix recibido (cash-in) para cubrir costos operacionales y generar ingresos — sin agregar complejidad a la experiencia del cliente. Ya sea operando como participante indirecto (vía BTG) o como participante directo (vía JD), la lógica de tarifas y la estructura del Ledger se mantienen iguales.
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 construir lógica de tarifas personalizada o pipelines de reconciliación
Configurando con Midaz
La fintech comienza estructurando 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. Este Ledger es compartido por el Plugin Pix y el Fees Engine.
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 están sujetas a 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”. Estas se referencian en la configuración del paquete del Fees Engine.
6
Organizar con Segmentos
Usa Segmentos para agrupar clientes por nivel (ej.: Standard, Premium). Esto 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: Los créditos de tarifa se dirigen a la cuenta interna “Ingresos por Tarifas Pix”
- Exenciones: Las cuentas del nivel Premium se agregan a la lista de cuentas exentas
Los paquetes de tarifas se configuran una vez y se aplican 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 ninguna intervención 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. Los datos del CRM y la validez de la clave Pix también se verifican.
3
La liquidación comienza
Una vez confirmada la transacción, el proceso de liquidación inicia. 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:
- La cuenta del cliente se acredita con el valor neto (bruto menos tarifa).
- La cuenta de destino de tarifa se acredita 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. La tarifa se registra de forma transparente, disponible para reportes y reconciliación.
Lo que esto desbloquea
- Sin lógica de tarifas personalizada — el Fees Engine maneja el cálculo, enrutamiento y exenciones.
- Ledger preciso — cada tarifa es un asiento en el ledger, no solo metadato. Los auditores ven los mismos números que tu equipo financiero.
- Segmentación de clientes — los clientes Premium pueden ser exentos automáticamente usando cuentas exentas.
- Flexibilidad de tarifas — cambia valores, agrega tarifas porcentuales o introduce umbrales basados en valor sin cambiar 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 monto restante 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, el valor neto se distribuye 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
Los vendedores pueden agruparse 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: Las tarifas se dividen proporcionalmente entre las cuentas de origen cuando múltiples vendedores participan en una única transacción
- Enrutamiento: Los créditos de tarifa van a la cuenta “Tarifa de Servicio del Marketplace”
- Deducible: La tarifa se deduce del monto recibido por 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 sabe exactamente qué tarifa se cobró y por qué.
- 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. Para detalles de licencia, consulta la documentación de Licencia.
Estimando antes de ir a producción
Antes de procesar transacciones reales, usa la funcionalidad de estimación del Fees Engine para validar tu configuración de tarifas. Las estimaciones te permiten:
- Visualizar exactamente cómo se calcularán las tarifas 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.