Pix Lerian

Usa el plugin Pix Lerian v1.0.0 para probar claves Pix, pagos, cobros y flujos de disputas con Midaz y el proveedor mock incluido.

Pix Lerian v1.0.0 es un plugin para integrar flujos de negocio de Pix con Midaz. Expone las API de DICT, SPI y COB, y registra en Midaz el movimiento de dinero que requiere cada flujo compatible.

Esta versión admite integración y pruebas con el proveedor mock incluido. No pone a disposición un conector nativo del riel ni promete conectividad de producción mediante un proveedor arbitrario.

​

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, 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.
• 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 y COB.

​

Plugin, mock y conectividad del 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. El proveedor mock incluido simula el lado externo y envía callbacks asíncronos para que pruebes la ruta de integración completa.

La integración de mensajería nativa de SPI es una capacidad de conectividad independiente. No está disponible en esta ruta de integración v1.0.0. No uses el mock como evidencia de que un proveedor de producción, una participación directa o una conectividad futura están certificados o habilitados.

​

Quién usa Pix Lerian

Pix Lerian es un plugin tecnológico 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; esta documentación v1.0.0 cubre el plugin y su ruta de pruebas con el proveedor mock, no la integración de mensajería nativa de SPI.

Midaz es obligatorio para la validación de cuentas y los efectos contables del plugin. El plugin no reemplaza el ledger de la institución: coordina la operación Pix y registra el débito, crédito, retención, liberación o reversión correspondiente mediante Midaz.

​

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 del entorno de pruebas o del cliente. El proveedor mock es el simulador externo compatible para las pruebas de integración v1.0.0.

​

Elige una ruta funcional

Necesidad	Empieza aquí
Registrar, resolver o mover una clave Pix	Guía de DICT
Enviar un Pix, recibir una entrada de efectivo o devolver una transferencia	Guía de SPI
Crear un payload QR o un cobro	Guía de COB
Entender los headers de solicitud, las repeticiones y los límites de los callbacks	Guía de integración
Observar estados asíncronos y recuperar fallos de pruebas	Guía de operaciones

​

Referencia de la API

Usa la referencia generada para consultar los esquemas de solicitud y respuesta:

• Endpoints de DICT
• Endpoints de transferencias SPI
• Endpoints de cobros inmediatos COB
• Errores de Pix Lerian

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.