> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Midaz con Pix y comisiones automatizadas > Lanza Pix con comisiones automatizadas al combinar Midaz, el Pix Plugin y el Fees Engine para cash-in y cash-out con registros de auditoría completos de partida doble. Para convertir un riel de pago en un producto, gestionas comisiones, divides ingresos y mantienes un registro de auditoría claro de cada transacción. Combinas **Midaz** (el ledger), el **Pix Plugin** (conectividad Pix) y el **Fees Engine** (lógica de comisiones automatizada, parte de Midaz). Juntos lanzan operaciones Pix con gestión de comisiones integrada, sin middleware a medida, sin conciliación manual y sin huecos en tu contabilidad. Esta página recorre dos escenarios. ## Por qué importa esta combinación *** Cada componente resuelve una capa específica del problema: | Componente | Función | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Midaz** | Ledger principal — registra cada débito, crédito y movimiento de comisión con precisión de partida doble | | **Pix Plugin** | Conectividad Pix — gestiona la orquestación de transacciones, DICT, QR Codes y la liquidación mediante el modelo de participación que elijas | | **Fees Engine** | Automatización de comisiones — calcula, divide y enruta comisiones según paquetes configurables | 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. | | Pix Indirecto | Pix Directo | | ------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | **Cómo se conecta** | A través de un Participante Directo (por ejemplo, BTG) | Directamente a SPI/DICT, mediante un PSTI certificado (por ejemplo, JD) o Lerian SPI | | **Ideal para** | Fintechs e instituciones de pago que buscan un onboarding rápido | Bancos e instituciones financieras reguladas con autonomía operativa total | | **Carga regulatoria** | Compartida con el Participante Directo | Asumida por completo por la institución | | **Tiempo de salida al mercado** | Semanas | Más largo, pero con control máximo | | **Integración con Fees Engine** | Nativa | Nativa | | **Integración con Midaz** | Obligatoria | Obligatoria | **Pix Indirecto vía BTG** está listo para producción. Tu institución se conecta a través de la infraestructura de BTG, así que omites la certificación de ISPB y la conectividad directa con BACEN. **Pix Directo vía JD**: explora sus capacidades en la [guía de participación directa](/es/interfaces/pix-jd/direct-pix-via-jd). Para una comparación detallada, consulta [modelos de participación en Pix](/es/interfaces/pix/pix-modalities). ## 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: Registra a la fintech como Organización en Midaz. Es la entidad de nivel superior que posee todos los ledgers, cuentas y transacciones. 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. Registra **BRL** como el activo operativo. Todas las transacciones Pix y los cálculos de comisiones usan este activo. Cada cliente recibe una cuenta bajo el ledger. Estas cuentas reciben créditos Pix y siguen las reglas 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. 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 El Fees Engine admite varios métodos de cálculo: comisiones fijas, comisiones porcentuales o una regla "max between" que aplica el valor mayor. En este escenario, una comisión fija mantiene precios predecibles para los clientes. 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: 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. 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. 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. 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. 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. 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: Registra al marketplace como Organización en Midaz. Crea un solo Ledger para gestionar todos los flujos de pago: pagos de compradores, créditos de vendedores y comisiones del marketplace. Registra **BRL** como el activo operativo. 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. Una cuenta interna (por ejemplo, "Marketplace Service Fee") recibe la parte de comisión de cada transacción. 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: | Vendedor | Participación | Monto bruto | | ---------- | ------------- | ----------- | | Vendedor A | 50% | R\$ 500.00 | | Vendedor B | 30% | R\$ 300.00 | | Vendedor C | 20% | R\$ 200.00 | El comprador escanea un QR Code o usa una clave Pix para enviar R\$ 1,000 al marketplace. El proveedor de conectividad procesa la transacción y notifica al Pix Plugin. El Fees Engine calcula una comisión del 3% (R\$ 30.00) y la distribuye proporcionalmente: * Vendedor A: R$ 15.00 de comisión (R$ 485.00 netos) * Vendedor B: R$ 9.00 de comisión (R$ 291.00 netos) * Vendedor C: R$ 6.00 de comisión (R$ 194.00 netos) 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) 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: | Requisito | Detalles | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | **Midaz** (v4.x.x+) | Ledger principal para la gestión de cuentas y el registro de transacciones | | **Pix Plugin** | Conectividad Pix — elige Indirecto (vía BTG) o Directo (vía JD) según tu modelo de participación | | **Fees Engine** | Cálculo y enrutamiento de comisiones automatizados — una capacidad de Midaz Enterprise, desplegada de forma independiente | | **CRM** | Datos de clientes y cuentas para la validación de Pix — parte de Midaz | | **Infraestructura** | Nube autogestionada (BYOC) o entorno on-premise | | **Contrato de conectividad** | Acuerdo con BTG (indirecto) o JD/PSTI (directo) según tu modelo | 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](/es/start-here/evaluate-and-deploy/lerians-license). ## 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 Esto ayuda sobre todo durante el onboarding, antes de fijar las estructuras de comisiones finales con los responsables de negocio. Usa el endpoint [Estimate Transaction Fees](/es/reference/products/midaz/v2/estimate-fee-calculation) para probar paquetes de comisiones específicos sin escribir en el ledger. ## Próximos pasos *** Conoce los paquetes de comisiones, las reglas de cálculo y las opciones de enrutamiento. Guía paso a paso para crear paquetes y procesar comisiones. Compara los modelos de participación y elige la ruta de conectividad adecuada. Explora la interfaz unificada para pagos, claves, cobros y devoluciones.