16 de março de 2026 Atualização de documentação Revisão recomendadaDocumentation Index
Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
Use this file to discover all available pages before exploring further.
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 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.