Saltar al contenido principal
Pix Lerian es la interfaz que conecta Midaz con Lerian SPI, la mensajería Pix propia de Lerian. Expone las API de DICT, SPI, COB y Pix Automático, y registra en Midaz el movimiento de dinero que requiere cada flujo compatible.

​
Qué hace el plugin

  • DICT: gestiona claves Pix, reclamaciones, casos MED 2.0, marcadores de fraude y conciliación de VSync.
  • SPI: inicia retiros, procesa pagos, programa pagos, recibe callbacks del adaptador, crea devoluciones y gestiona retenciones de saldo MED 2.0.
  • COB: crea BR Codes estáticos y cobros inmediatos y con fecha de vencimiento.
  • Pix Automático: decide solicitudes de autorización de pagos recurrentes por el pagador, gestiona autorizaciones y cancela débitos programados.
  • Integración con Midaz: valida el contexto de la cuenta y crea el débito, crédito, retención, liberación o reversión que requiere el flujo.
Empieza por Integración con Pix Lerian y luego usa las guías funcionales de DICT, SPI, COB y Pix Automático.

​
Plugin, adaptador y riel

El plugin es la capa de aplicación. Mantiene el estado de sus operaciones locales y llama a Midaz para el trabajo del ledger. Llama a un adaptador de conectividad para el lado del proveedor. El adaptador envía callbacks asíncronos al plugin. El adaptador de conectividad Lerian llama a Lerian SPI. El proveedor mock incluido simula el lado del proveedor para las pruebas de integración. No uses el mock como evidencia de que un proveedor de producción o una participación directa están certificados o habilitados.

​
Quién usa Pix Lerian

Pix Lerian es una interfaz para instituciones que son dueñas de su ledger y de sus reglas de cuentas. No es un PSP ni un PSTI. La institución sigue siendo responsable de su participación regulatoria y de su acuerdo de conectividad. Midaz es obligatorio para la validación de cuentas y los efectos contables del plugin. El plugin coordina la operación Pix y registra el débito, crédito, retención, liberación o reversión correspondiente mediante Midaz. No reemplaza el ledger de la institución.

​
Modelo de despliegue

Despliega Pix Lerian en el entorno BYOC de la institución y opera allí sus dependencias. Tu equipo es dueño del despliegue, la observabilidad, el control de acceso y la continuidad.

​
Elige una ruta funcional

​
Referencia de la API

Usa la referencia generada para consultar los esquemas de solicitud y respuesta: Las guías funcionales explican la secuencia y la responsabilidad. La referencia de la API sigue siendo el contrato para la validación de campos y las respuestas de cada operación.