> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de idempotencia reescrita

> La guía de Retries e Idempotencia ahora está reescrita con un alcance aclarado, claves auto-generadas, comportamiento de errores, tablas de comparación entre productos y ejemplos actualizados.

<Badge stroke icon="calendar-days" iconType="regular">16 de marzo de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de documentación</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisión recomendada</Badge>

## 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**](/es/reference/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.

## Qué necesitas hacer

***

<Steps>
  <Step>
    Revisa el alcance de idempotencia aclarado y el comportamiento de retry antes de cambiar la lógica de retry de transacciones.
  </Step>
</Steps>

### Plazo

Ninguno.

### Por qué

La reescritura aclara qué endpoints soportan idempotencia y cómo se comportan las claves después de errores de validación o saldo.
