> ## 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

`POST /qr` acepta el header opcional `Idempotency-Key` para que un mismo cobro no se genere dos veces, incluso ante reintentos de red.

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

**Comportamiento:**

* Si repites la misma key dentro de **24 horas**, la API devuelve el mismo QR que la primera vez, sin crear otro.
* Si una request con esa key todavía está en curso, responde `409 Conflict`. Reintenta en 1–2 segundos con la misma key.
* Usa un UUID v4 por cobro.