Skip to main content
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. 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?. 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

​
Casos de uso de Pix con Midaz

Mira cómo Pix Lerian y Midaz trabajan juntos en la práctica:

Pix con rutas de transacción

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.

Pix con comisiones automatizadas

Combina Pix Lerian con el Fees Engine para una gestión de comisiones transparente y automatizada en fintechs y marketplaces.