Skip to main content
March 16th, 2026 Improved La guía Reintentos e idempotencia recibió una reescritura importante con alcance más claro, mejores ejemplos y nuevas tablas de referencia.

Cambios principales


  • Alcance clarificado — el soporte de idempotencia aplica a seis endpoints de transacción específicamente, no a todas las APIs de Midaz
  • Claves auto-generadas — si omites el header X-Idempotency, Midaz genera una clave automáticamente usando un hash SHA-256 del cuerpo de la solicitud
  • Comportamiento en errores — Midaz elimina las claves de idempotencia en errores de validación y saldo, así puedes reintentar de forma segura con la misma clave después de corregir el problema
  • Comparación entre productos — una nueva tabla muestra el soporte de idempotencia en Midaz, Matcher, TED, Pix Indirect, Pix Direct y Reporter, incluyendo nombres de header, TTL y alcance
  • Restricciones de unicidad de entidades — una nueva tabla lista las reglas de unicidad por recurso (Ledger, Asset, Segment, Account, Account Type) con sus códigos de error correspondientes
  • Ejemplos de código actualizados — pseudo-código genérico reemplazado con solicitudes HTTP concretas usando endpoints y payloads reales
  • Nuevas FAQs — “¿Puedo reutilizar una clave entre diferentes endpoints?” y “¿Puedo reutilizar una clave entre diferentes organizaciones o ledgers?”