> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Midaz: guia de extrato de conta

> Um novo guia do Midaz explica como transformar operações de conta em extratos voltados ao cliente.

<Badge stroke icon="calendar-days" iconType="regular">19 de maio de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="green" size="lg" stroke icon="circle-check" iconType="regular">Sem migração necessária</Badge>

## Afeta

***

Times que constroem experiências de extrato com operações de conta do Midaz, incluindo integradores, arquitetos de solução, engenheiros de backend e times de produto que definem visões de atividade da conta.

Esta atualização se aplica ao portal público de documentação. Não altera o comportamento da API do Midaz em runtime.

## O que mudou

***

### Novo guia para construir extratos

O Midaz agora tem um guia dedicado para construir extratos de conta a partir das operações do ledger.

O guia explica como:

* Recuperar as operações de conta de um período específico
* Aplicar filtros de consulta e paginação
* Transformar cada operação em uma linha do extrato
* Usar `direction` para exibir valores de entrada e saída
* Tratar `ON_HOLD` e `RELEASE` como eventos de bloqueio e liberação de saldo
* Manter as visões de extrato liquidado focadas em operações com `balanceAffected=true`
* Adicionar contexto de negócio por meio de metadata de transação

### Enquadramento mais claro voltado ao cliente

A página deixa explícito o modelo central: o Midaz retorna eventos do ledger. O sistema integrador transforma esses eventos na experiência de extrato que os usuários finais veem.

Isso evita tratar o endpoint de operações como uma tela de extrato pronta. Ele é a fonte de dados de um extrato.

### Exemplos práticos

O guia inclui uma visão do fluxo, mapeamento de campos, regras de exibição, orientação sobre paginação, exemplos de metadata e uma saída de extrato de exemplo.

**Antes**

Os times tinham a referência da API para listar operações de conta, mas nenhum guia único que conectasse essas operações a um extrato voltado ao usuário.

**Depois**

Os times podem seguir uma única página para passar das operações de conta a uma visão de extrato renderizada.

## Impacto

***

Esta é uma atualização exclusiva de documentação.

Nenhuma migração é necessária. As integrações existentes do Midaz continuam funcionando como hoje.

Use o novo guia ao projetar, implementar ou revisar experiências de extrato de conta que utilizem operações de conta do Midaz.

## O que você precisa fazer

***

<Steps>
  <Step>
    Revise o novo guia de extrato de conta se seu produto exibe atividade da conta, saldos ou histórico de transações para usuários finais.
  </Step>

  <Step>
    Use `direction`, não `type`, para decidir se um valor aparece como entrada ou saída no extrato.
  </Step>

  <Step>
    Adicione metadata de negócio ao criar transações se seu extrato precisa de descrições amigáveis ao usuário, contrapartes, canais, categorias ou referências de pagamento.
  </Step>

  <Step>
    Mantenha as visões de extrato liquidado focadas em operações onde `balanceAffected=true`.
  </Step>
</Steps>

### Prazo

Nenhum.

### Por quê

Extratos de conta precisam tanto de precisão contábil quanto de contexto para o usuário. O novo guia mostra como preservar o modelo de ledger ao mesmo tempo em que apresenta a atividade da conta de uma forma que os clientes conseguem ler.

## Recursos

***

* [Construir um extrato de conta](/pt/midaz/building-account-statements)
* [List Operations by Account](/pt/reference/midaz/list-operations-by-account)