Evita operaciones duplicadas

Una llave de idempotencia asocia un comando de negocio con un resultado. Reutilízala cuando repitas la misma solicitud después de un timeout.

Envía una llave estable

Idempotency-Key: order_1001_checkout_v1

Deriva el valor desde el ID de tu sistema y la acción. No uses timestamps aleatorios para un retry del mismo comando.

SimplePay compara el fingerprint de la solicitud. La misma llave con parámetros diferentes devuelve un conflicto.

Caso	Resultado esperado
Misma llave y mismo body	Devuelve el resultado original o converge al mismo recurso
Misma llave y body diferente	`409 idempotency_conflict`
Llave nueva	Ejecuta un comando nuevo

Conserva la misma llave ante timeouts, 429 y errores retryable. No reintentes errores de validación sin corregir la solicitud.

Última modificación el 22 de agosto de 2026