Skip to main content
March 16th, 2026 Improved O guia Retries e idempotência recebeu uma reescrita significativa com escopo mais claro, exemplos melhores e novas tabelas de referência.

Principais mudanças


  • Escopo esclarecido — O suporte a idempotência se aplica a seis endpoints de transação especificamente, não a todas as APIs do Midaz
  • Chaves auto-geradas — 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 deleta chaves de idempotência em erros de validação e saldo, então você pode retentar com a mesma chave após corrigir o problema
  • Comparação entre produtos — Uma nova tabela mostra o suporte a idempotência no Midaz, Matcher, TED, Pix Indirect, Pix Direct 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 com endpoints e payloads reais
  • Novos FAQs — “Posso reutilizar uma chave entre endpoints diferentes?” e “Posso reutilizar uma chave entre organizações ou ledgers diferentes?”