Idempotencia
El endpoint de creación de transacciones soporta el header opcionalIdempotency-Key para garantizar que un mismo cobro no se procese más de una vez, incluso ante reintentos de red.
- Si se envía una
Idempotency-Keyy 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 Conflictcon detalle"concurrent request". Reintentar en 1–2 segundos resuelve la condición de carrera. - Se recomienda usar UUIDs v4 como valor de la key.