Idempotencia y duplicados
Opcional pero siempre recomendado al crear:
Idempotency-Key: order-1001-create
Repetir la misma petición con la misma llave devuelve el mismo pago, sin duplicado.
Dos comportamientos verificados que difieren del estándar de la industria:
La misma llave con un cuerpo distinto devuelve el pago original, sin error. (Stripe devolvería 422.) La llave manda y el cuerpo se ignora al repetir. Si un bug reutiliza una llave para un monto distinto, recibís un 201 que describe un cobro que nadie pidió. -> Derivá la llave del contenido de la orden (por ejemplo un hash de id, monto y moneda), no solo de su identificador.
external_referenceno es único. Sin unIdempotency-Key, enviarlo dos veces crea dos pagos distintos. La llave de idempotencia es la única protección contra duplicados.
