16 de marzo de 2026 Actualización de documentación Revisión 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.
Afecta
Equipos que implementan retries e idempotencia para endpoints de transacciones. Esta actualización aplica al portal público de documentación. No cambia el comportamiento de la API en tiempo de ejecución a menos que la documentación del producto enlazada indique lo contrario.
Qué cambió
La guía Retries & Idempotency recibió una reescritura importante con un alcance más claro, mejores ejemplos y nuevas tablas de referencia.
Cambios clave
- Alcance aclarado: el soporte de idempotencia aplica específicamente a seis endpoints de transacciones, 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 de errores: Midaz elimina las claves de idempotencia en errores de validación y de saldo, por lo que puedes reintentar 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, incluidos los 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: el pseudo-código genérico fue reemplazado por solicitudes HTTP concretas con endpoints y payloads reales
- Nuevas FAQs: “¿Puedo reutilizar una clave entre diferentes endpoints?” y “¿Puedo reutilizar una clave entre diferentes organizaciones o ledgers?”
Impacto
Esta es una actualización de documentación. Las integraciones existentes no requieren migración a partir de esta nota de versión.