Idempotencia

Para operaciones críticas (pagos, órdenes), usa el header Idempotency-Key:

POST /api/v1/orders
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

Si la misma key se usa dos veces, el servidor devuelve la respuesta original cacheada (HTTP 200) sin crear un duplicado. Las keys expiran tras 24 horas.

Usa un UUID v4 único por intento de operación.