Skip to main content
25 de março de 2026 Atualização da documentação Revisão recomendada

Afeta


Equipes que conciliam transações Pix com o Matcher. Esta atualização se aplica ao portal público de documentação. Ela não muda o comportamento da API em runtime, a menos que a documentação do produto vinculada diga o contrário.

O que mudou


Publicamos um guia de caso de uso completo para conciliar transações Pix usando o Matcher: Conciliação Pix com o Matcher. Este guia mostra passo a passo:
  • Fluxos de transação: Diagramas de cash-in e cash-out mostrando como as transações Pix vão da iniciação, passando pela liquidação no SPI, até a conciliação no Matcher
  • Configuração passo a passo: Criar contextos, fontes (LEDGER para o Midaz, CUSTOM para os extratos do SPI do BACEN), mapas de campos e regras de correspondência
  • Operações diárias: Fazer upload do extrato do BACEN, rodar DRY_RUN antes do COMMIT, revisar exceções
  • Regras de correspondência: Correspondência EXACT em endToEndId na prioridade 1, com fallback DATE_LAG na prioridade 10 para liquidações D+1
  • Exemplo prático: Um cenário resolvido com quatro transações: correspondências exatas, correspondências com defasagem de data D+1 e casos de exceção
  • Tratamento de exceções: O que fazer quando as transações aparecem em uma fonte e não na outra, ou quando valores ou datas não batem

Correção

O tipo de fonte do Matcher foi corrigido de "type": "MIDAZ" para "type": "LEDGER" no guia de integração com o Midaz.

Impacto


Esta é uma atualização de documentação. As integrações existentes não precisam de migração apenas por esta nota de release.

O que você precisa fazer


1
Revise o caso de uso de conciliação Pix antes de configurar as fontes, os mapas de campos e as regras de correspondência do Matcher para fluxos Pix.

Prazo

Nenhum.

Por quê

O guia documenta um fluxo de conciliação Pix de ponta a ponta e corrige o tipo de fonte do Matcher documentado para a integração com o Midaz.