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

# Idempotencia

> Header Idempotency-Key con ventana de 24 h para evitar cobros duplicados en reintentos.

## Idempotencia

El endpoint de creación de transacciones soporta el header opcional `Idempotency-Key` para garantizar que un mismo cobro no se procese más de una vez, incluso ante reintentos de red.

```http theme={"system"}
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000
```

**Comportamiento:**

* Si se envía una `Idempotency-Key` y la misma key ya fue usada en las últimas **24 horas** por el mismo comercio, la API devuelve la respuesta original sin generar una nueva transacción.
* Si una request con esa key está **en curso concurrentemente**, la API responde `409 Conflict` con detalle `"concurrent request"`. Reintentar en 1–2 segundos resuelve la condición de carrera.
* Se recomienda usar UUIDs v4 como valor de la key.