ROKIConnect

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:

  1. 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.

  2. external_reference no es único. Sin un Idempotency-Key, enviarlo dos veces crea dos pagos distintos. La llave de idempotencia es la única protección contra duplicados.