Afecta a
Equipos que implementan reintentos e idempotencia para endpoints de transacción. Esta actualización aplica al portal de documentación pública. No cambia el comportamiento de la API en tiempo de ejecución, a menos que la documentación de producto enlazada indique lo contrario.
Qué cambió
La guía Reintentos e idempotencia recibió una reescritura mayor con un alcance más claro, mejores ejemplos y nuevas tablas de referencia.
Cambios principales
- Alcance aclarado — El soporte de idempotencia aplica específicamente a seis endpoints de transacción, no a todas las APIs de Midaz
- Claves autogeneradas — Si omites el header
X-Idempotency, Midaz genera una clave automáticamente con un hash SHA-256 del cuerpo de la solicitud - Comportamiento ante errores — Midaz elimina las claves de idempotencia en errores de validación y de saldo, por lo que puedes reintentar con seguridad 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 headers, el TTL y el ámbito
- 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 pseudocódigo genérico se reemplazó por solicitudes HTTP concretas con endpoints y payloads reales
- Nuevas preguntas frecuentes — “¿Puedo reutilizar una clave en endpoints diferentes?” y “¿Puedo reutilizar una clave en organizaciones o ledgers diferentes?”
Impacto
Esta es una actualización de documentación. Las integraciones existentes no necesitan una migración solo por esta nota de versión.
Qué debes hacer
1
Revisa el alcance de idempotencia aclarado y el comportamiento de reintento antes de cambiar la lógica de reintentos de transacciones.