> ## 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. # Pix Lerian > Pix Lerian es el plugin de Pix unificado de Lerian: una capa de aplicación, cualquier proveedor, que cubre orquestación, claves, QR Codes y disputas. Pix Lerian es el plugin de Pix de Lerian. Le da a tu institución lo que necesita para operar Pix en la capa de aplicación. Un único producto unificado cubre la orquestación de transacciones, la gestión de claves, los QR Codes, las devoluciones y la resolución de disputas. Pix Lerian es **un plugin para cualquier proveedor**. Eliges el proveedor de conectividad que corresponde a tu modelo de participación. Pix Lerian se encarga del resto. Lerian es un **proveedor de tecnología**. No somos un PSP ni un PSTI. La conectividad regulada está por debajo de Pix Lerian. Tu institución elige qué la provee: un participante directo, un PSTI certificado que contrates, o [Lerian SPI](/es/rails/spi/what-is-lerian-spi). Lerian SPI es el conector propio de Lerian con BACEN, para una institución que participa de forma directa. La arquitectura y los contratos que describe esta página reflejan el diseño actual del producto Pix Lerian. # Por qué Pix Lerian *** Históricamente, admitir Pix en distintos proveedores de conectividad significaba mantener **plugins separados y aislados**, uno por proveedor, cada uno con su propia base de código, contratos de API y patrones de integración. Esto creó problemas: * **Lógica de negocio duplicada**: cada plugin tenía que implementar y mantener las mismas reglas de Pix de forma independiente * **Contratos de API diferentes**: cada integración de proveedor exponía una API distinta al cliente, lo que dificultaba cambiar o agregar proveedores * **Mayor costo de mantenimiento**: tenías que aplicar correcciones de errores, actualizaciones regulatorias y funcionalidades nuevas por separado a cada plugin * **Sin portabilidad**: pasar de un proveedor a otro exigía una reintegración completa Pix Lerian resuelve esto al centralizar toda la lógica de Pix en un solo producto con una **API unificada** y una **Provider Adapter Layer** que se encarga de la traducción específica de cada proveedor. Obtienes una integración para cualquier proveedor, sin retrabajo cuando cambian tus necesidades de conectividad. # Qué ofrece Pix Lerian *** Pix Lerian ofrece una **capa de orquestación de Pix** que maneja todo el ciclo de vida de negocio de las operaciones de Pix: * **Flujos de cash-out y cash-in**: envía y recibe pagos Pix con gestión completa del ciclo de vida del mensaje * **Gestión de claves Pix (DICT)**: crea, actualiza, elimina y resuelve la titularidad de las claves Pix * **Generación de QR Codes estáticos y dinámicos**: emite QR Codes para iniciar pagos * **Orquestación del ciclo de vida del MED**: administra el Mecanismo Especial de Devolución (Mecanismo Especial de Devolucao) de punta a punta * **Tratamiento de devoluciones**: procesa devoluciones totales y parciales con la secuencia regulatoria correcta * **Webhooks, procesamiento de eventos y workers en segundo plano**: reacciona a los eventos del proveedor en tiempo real y ejecuta trabajos asíncronos de forma confiable * **Integración nativa con Midaz**: Midaz es el ledger obligatorio de Pix Lerian y aporta validación de cuentas, verificación de saldos, registro de débitos/créditos y enrutamiento # Cómo funciona *** Pix Lerian usa una **Provider Adapter Layer** para separar tu integración de las particularidades de cualquier proveedor de conectividad concreto. El plugin expone una **única API** a tu aplicación. Detrás de esa API, un adaptador de proveedor traduce cada operación (transacciones, consultas de claves, registros de QR Code, devoluciones) al protocolo y el formato que exige el proveedor que configuraste. Tu institución selecciona qué proveedor usar durante la configuración. El plugin resuelve todo lo demás. Esta arquitectura significa que cambiar de proveedor o admitir modelos de participación adicionales no exige reescribir tu integración. Cambias la configuración. La API sigue igual. Pix Lerian no habla con BACEN por sí mismo. Opera por encima de la capa de gateway SPI/DICT y maneja la lógica de negocio de Pix. Ese gateway es un **participante directo**, un **PSTI certificado** o **Lerian SPI**. # Modelos de participación *** BACEN define dos modelos regulatorios de participación en Pix: **directo** (tu institución se conecta a BACEN por su cuenta) e **indirecto** (te conectas a través de un participante directo autorizado). Para una explicación detallada de cada modelo, consulta [¿Qué es Pix?](/es/interfaces/pix/pix-overview). En Pix Lerian, el modelo de participación es una **configuración**, no un producto distinto. La **Provider Adapter Layer** admite ambos modelos. Eliges un proveedor que corresponde a tu estatus regulatorio y la API del plugin sigue igual. Cambiar de proveedor o evolucionar tu modelo de participación no exige reintegrar el plugin. # Integraciones en el ecosistema Lerian *** Pix Lerian requiere **Midaz** como su ledger principal. Esta integración nativa simplifica: * Validación de cuentas * Verificación de saldos * Registro de débitos/créditos * Enrutamiento * Reglas de negocio (comisiones, autorizaciones) Pix Lerian también se conecta con otros productos del ecosistema Lerian: * **CRM (Midaz CRM)**: gestión de relaciones con clientes y de entidades * **Fees Engine**: cálculo y cobro automatizados de comisiones * **Access Manager**: autenticación y autorización # Modelo de despliegue *** Pix Lerian se entrega bajo el modelo **BYOC** (Bring Your Own Cloud). Tu institución despliega y opera los binarios que provee Lerian en su propia infraestructura, en una nube pública, una nube privada u on-premises. Tu equipo es responsable de la operación de la infraestructura. Lerian provee el software, las actualizaciones y el soporte acordado. # Público objetivo *** Pix Lerian está diseñado para instituciones que: * Participan en el arreglo Pix (o tienen la intención de hacerlo) * Tienen un **ISPB** válido (identificador que BACEN asigna a las instituciones financieras en Brasil) * Son dueñas del ledger en el nivel de negocio: tu institución controla las cuentas y los saldos, sin importar dónde corre la infraestructura Pix Lerian está pensado para instituciones preparadas para operar el producto bajo el modelo BYOC. **No es adecuado para** instituciones en las que un tercero controla el ledger o la gestión de cuentas en el nivel de negocio. Si tus cuentas y saldos viven dentro del dominio de un proveedor de BaaS (no solo de su infraestructura), Pix Lerian no es la opción correcta. La institución debe ser dueña de la capa de ledger en términos lógicos, sin importar el modelo de despliegue. # Requisitos para operar *** Antes de adoptar Pix Lerian, tu institución debe tener: * Un **ISPB** válido registrado en BACEN * **Conectividad con el riel**. Para la participación indirecta, un contrato con un participante directo. Para la participación directa, o bien un contrato con un PSTI certificado o bien Lerian SPI como tu propio conector * **Propiedad lógica del ledger**: Midaz debe estar desplegado y operativo, con tu institución controlando las cuentas y los saldos **Requisitos adicionales para BYOC:** * Tu propio **entorno de nube u on-premise** para alojar el plugin * **Preparación de DevOps y SRE**: tu equipo gestiona el despliegue, el monitoreo, las actualizaciones y la respuesta a incidentes * **Responsabilidad de seguridad y cumplimiento**: tu institución responde por el control de acceso, la redundancia, la observabilidad y los registros de auditoría # Ventajas *** ### Integraciones nativas del ecosistema Conecta con Midaz, CRM, Fees Engine y Access Manager de fábrica. Cada integración viene incorporada en la plataforma. ### Personalización Extiende o modifica la lógica de negocio para que coincida con los requisitos específicos de tu institución. Adáptate a los cambios regulatorios a tu propio ritmo. ### Eficiencia económica Elimina la dependencia de intermediarios de varias capas que agregan costo sin agregar control. En BYOC, dimensiona la infraestructura según tu demanda real. ### Control total y soberanía de datos (BYOC) Ejecuta todo en tu propia infraestructura. Aplica tus propias políticas de IAM, estándares de cifrado y marcos de gobernanza. Define reglas de enrutamiento, políticas de negocio y prácticas operativas. Tu ledger, tus saldos y los datos almacenados quedan en tu entorno. Como Pix es un riel de pago, el plugin sigue intercambiando los mensajes de liquidación y de directorio que se necesitan para mover dinero con el sistema de pagos brasileño (la red RSFN que opera el Banco Central), de forma directa o a través de tu proveedor de participación. Ser dueño del entorno significa que eres dueño de los datos y de la infraestructura, no que nunca salga tráfico de él. # Contrapartidas *** El modelo BYOC tiene las siguientes contrapartidas: * **Exige madurez técnica**: tu institución necesita capacidades de DevOps, herramientas de observabilidad y experiencia en gestión operativa. * **Exige disciplina de gobernanza**: tu equipo debe mantener la seguridad, la disponibilidad, el cumplimiento y la preparación para auditorías. * **Más configuración por adelantado**: la flexibilidad implica más orquestación y parametrización durante la configuración inicial. Planifica un proceso de onboarding estructurado. * **Responsabilidad operativa**: tu institución gestiona las actualizaciones de software, los parches, el escalamiento y los planes de continuidad. Lerian provee el software y las herramientas. Tu equipo lo opera. # Referencia técnica *** * [**Endpoints DICT**](/es/reference/interfaces/pix-lerian/dict/create-entry): claves Pix, reclamaciones, infracciones, devoluciones y recuperación de fondos. * [**Endpoints SPI**](/es/reference/interfaces/pix-lerian/spi/initiate-transfer): transferencias Pix y devoluciones. * [**Endpoints COB**](/es/reference/interfaces/pix-lerian/cob/create-immediate-collection): cobros inmediatos, cobros con vencimiento y BR Codes. * [**Variables de entorno**](/es/interfaces/pix-lerian/pix-lerian-environment-variables): configuración del binario entregado en despliegues BYOC. # Casos de uso de Pix con Midaz *** Mira cómo Pix Lerian y Midaz trabajan juntos en la práctica: Modela flujos de transferencia Pix validados y reutilizables con rutas de transacción y rutas de operación, desde transferencias simples hasta el cobro de comisiones. Combina Pix Lerian con el Fees Engine para una gestión de comisiones transparente y automatizada en fintechs y marketplaces.