> ## 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.

# Guia de idempotência reescrito

> O guia de Retries e idempotência foi reescrito com escopo esclarecido, chaves geradas automaticamente, comportamento de erro, tabelas comparativas entre produtos e exemplos atualizados.

<Badge stroke icon="calendar-days" iconType="regular">16 de março de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisão recomendada</Badge>

## Afeta

***

Times implementando retries e idempotência para endpoints de transação.

Esta atualização se aplica ao portal de documentação pública. Não altera o comportamento da API em runtime, a menos que a documentação do produto vinculada indique o contrário.

## O que mudou

***

O guia [**Retries e idempotência**](/pt/reference/retries-idempotency) recebeu uma reescrita relevante com escopo mais claro, melhores exemplos e novas tabelas de referência.

### Principais mudanças

***

* **Escopo esclarecido** — O suporte a idempotência se aplica especificamente a **seis endpoints de transação**, não a todas as APIs do Midaz
* **Chaves geradas automaticamente** — Se você omitir o header `X-Idempotency`, o Midaz gera uma chave automaticamente usando um hash SHA-256 do corpo da requisição
* **Comportamento de erro** — O Midaz exclui as chaves de idempotência em erros de validação e de saldo, permitindo retentar com segurança usando a mesma chave após corrigir o problema
* **Comparação entre produtos** — Uma nova tabela mostra o suporte a idempotência em Midaz, Matcher, TED, Pix Indireto, Pix Direto e Reporter, incluindo nomes de header, TTL e escopo
* **Restrições de unicidade de entidades** — Uma nova tabela lista as regras de unicidade por recurso (Ledger, Asset, Segment, Account, Account Type) com seus códigos de erro correspondentes
* **Exemplos de código atualizados** — Pseudo-código genérico substituído por requisições HTTP concretas usando endpoints e payloads reais
* **Novas FAQs** — "Posso reutilizar uma chave entre endpoints diferentes?" e "Posso reutilizar uma chave entre organizações ou ledgers diferentes?"

## Impacto

***

Esta é uma atualização de documentação. Integrações existentes não precisam de migração apenas com base nesta release note.

## O que você precisa fazer

***

<Steps>
  <Step>
    Revise o escopo esclarecido de idempotência e o comportamento de retry antes de alterar a lógica de retry de transações.
  </Step>
</Steps>

### Prazo

Nenhum.

### Por quê

A reescrita esclarece quais endpoints suportam idempotência e como as chaves se comportam após erros de validação ou de saldo.