Skip to main content
Pix Directo vía JD es el camino de conectividad para participantes directos en Pix. La infraestructura regulada de JD conecta tu institución al SPI y al DICT del BACEN. Tu institución es dueña de su participación en Pix. JD proporciona la conectividad certificada que alcanza la red del BACEN. La integración de Pix de Lerian abstrae el proveedor de conectividad detrás de una única API. La misma documentación de Pix aplica a todos los proveedores:
  • ¿Qué es Pix? — el riel en sí: modalidades, SPI, DICT y modelos de participación.
  • Pix Switch — la capa de orquestación que maneja la gestión del DICT, transacciones, QR Codes y MED a través de una única API.
  • Casos de uso de plugins — escenarios de extremo a extremo que combinan Pix con tarifas, rutas de transacción y el ledger.

​
Cómo llegan los movimientos Pix a Midaz

El plugin de participación directa registra cada movimiento Pix liquidado — cash-out, cash-in, devoluciones, las piernas de efectuación del MED y la liquidación de Pix Automático — en Midaz como una transacción de ledger, con la pierna externa contra la cuenta de clearing (por ejemplo, @external/BRL). Midaz guarda el asiento contable; la identidad del pagador y del receptor (banco, sucursal, cuenta, nombre y documento del titular, clave Pix) y todas las referencias BACEN viven solo en el registro de transacción del propio plugin. La correlación entre los dos sistemas funciona por identificadores, no por metadatos:
  • El end-to-end ID (E2E) es la clave de idempotencia del asiento en Midaz, así que una liquidación reintentada nunca duplica el asiento en el ledger. Las piernas posteriores del mismo E2E — una devolución o una efectuación de MED — derivan su clave del E2E con un sufijo de flujo, así que nunca colisionan con el asiento original.
  • El plugin almacena el id del asiento de Midaz en su propio registro de transacción, y lo usa para confirmar o cancelar el débito pendiente de un cash-out en dos fases.
Para ver el detalle bancario detrás de un asiento del ledger, consulta la API de transacciones del plugin por el id de la transacción del plugin o por el E2E ID. La transacción de Midaz en sí no lleva datos de contraparte ni metadatos personalizados — por diseño, el ledger se mantiene como contabilidad pura.
Lerian aprovisiona la configuración específica del proveedor para la participación directa vía JD con tu integración. Para configurar la participación directa en Pix, habla con nuestro equipo.