Who it serves
Lerian SPI serves financial institutions that participate in Pix under their own ISPB. Those participants send and receive instant payments, register and resolve Pix keys, issue immediate and due-date charges as BR Code QR, run Pix Automático recurring mandates, and open and resolve MED disputes — all directly, without a connectivity partner in the money path.
Four API surfaces
The rail is organized into four API surfaces, each speaking the messaging contract of a specific part of the Pix ecosystem.
| Surface | What it covers |
|---|---|
| Payments | Sending and receiving Pix, payment status and history, returns (devoluções), and Pix Automático recurring authorizations |
| DICT | The Pix key lifecycle, lookups and batch existence checks, antifraud statistics, and portability and ownership claims (reivindicações) |
| BR Code | Pix charges — immediate (Cob), due-date (CobV), and batch — and the EMV QR payloads that resolve to them |
| Core & MED | Participant registration and lifecycle, MED disputes and refunds, and Conta PI settlement reporting |
Settlement is real-time and asynchronous
The SPI settles each Pix individually, in real time, around the clock. When you submit a payment, the platform dispatches an ISO 20022 credit-transfer message (
pacs.008) and returns an accepted-but-not-settled state — dispatch was accepted, not that BACEN has settled it. BACEN confirms asynchronously through a status reply (pacs.002), which the rail validates and applies to move the payment to settled or rejected. Every payment is tracked by its end-to-end ID (E2EID).
Money-neutrality
Lerian SPI is money-neutral by design. It forwards the amounts you declare exactly as declared and computes no balance or position of its own. Every accounting position lives in Midaz; Lerian SPI carries the message and its settlement state, and Midaz records the money.
Glossary
| Term | Meaning |
|---|---|
| Lerian SPI | Lerian’s native Pix Direto rail — a direct BACEN integration over the SPI. |
| Pix | Brazil’s instant-payment system, operated by BACEN and settling 24/7. |
| SPI — Sistema de Pagamentos Instantâneos | BACEN’s instant-payment settlement infrastructure. |
| DICT — Diretório de Identificadores de Contas Transacionais | BACEN’s Pix key directory. |
| Pix key | An alias — phone, email, tax ID, or random EVP — that resolves to an account. |
| ISPB | 8-digit code identifying a participant institution in the Brazilian payment system. |
| End-to-end ID (E2EID) | The 32-character identifier tracking a single Pix payment across the rail. |
| BR Code | Brazil’s EMV QR standard (QRCPS-MPM) for Pix, static or dynamic. |
| Cob / CobV | An immediate Pix charge (Cob) or a due-date charge with interest and fine (CobV). |
| Pix Automático | Recurring and scheduled Pix authorizations — recorrência and agendamento. |
| MED — Mecanismo Especial de Devolução | BACEN’s dispute and refund mechanism for fraud or error. |
| Devolução | A Pix return sent back to the payer against a settled payment. |
| Reivindicação (claim) | A portability or ownership claim to move a Pix key between participants. |
| Conta PI | A participant’s instant-payment settlement account at BACEN, reported via camt.05x. |
| ISO 20022 | The messaging standard (pacs / pain / camt) BACEN uses for Pix over the RSFN. |
| Participant | A financial institution connected to Pix, identified by its ISPB. |