> ## 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 Novas tentativas e idempotência foi reescrito com escopo esclarecido, chaves geradas automaticamente, comportamento em erros, tabelas de comparação entre produtos e exemplos.

16 de março de 2026Atualização da documentaçãoRevisão recomendada

## Afeta

***

Equipes que implementam novas tentativas e idempotência para endpoints de transação.

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

***

O guia [**Novas tentativas e idempotência**](https://docs.lerian.studio/pt/reference/retries-idempotency.md) recebeu uma reescrita ampla, com escopo mais claro, exemplos melhores e novas tabelas de referência.

### Mudanças principais

***

* **Escopo esclarecido**: O suporte a idempotência se aplica 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 em erros**: O Midaz apaga as chaves de idempotência em erros de validação e de saldo, então você pode repetir com segurança a mesma chave depois de 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 headers, 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 os códigos de erro correspondentes
* **Exemplos de código atualizados**: O pseudocódigo genérico foi substituído por requisições HTTP concretas, com endpoints e payloads reais
* **Novas perguntas frequentes**: "Posso reutilizar uma chave em endpoints diferentes?" e "Posso reutilizar uma chave em organizações ou ledgers diferentes?"

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

***

**Step 1**

Revise o escopo de idempotência esclarecido e o comportamento de novas tentativas antes de mudar a lógica de repetição das transações.

### Prazo

Nenhum.

### Por quê

A reescrita esclarece quais endpoints aceitam idempotência e como as chaves se comportam depois de erros de validação ou de saldo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.