Idempotencia

La cabecera X-IDEMPOTENCY-KEY: evita facturas duplicadas por un doble click o un reintento.

Los endpoints de creación aceptan la cabecera opcional X-IDEMPOTENCY-KEY: una clave única por operación lógica (un UUID generado al pintar el checkout, o tu propio identificador de pedido). Si la misma clave llega dos veces — un doble click, un reintento tras un timeout de red —, la segunda petición no crea nada: recibe exactamente la misma respuesta que la primera, con la cabecera X-Idempotent-Replay: 1.

curl -X POST 'https://api.afer.pro/crearFactura' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -H 'X-IDEMPOTENCY-KEY: pedido-web-006520' \
  -d '{ … }'

Reglas de la clave:

• Ámbito: por cuenta y endpoint. Máximo 190 caracteres. Caduca a las 72 horas.
• Solo se guardan respuestas con éxito: si la petición falla (validación, error), la clave queda libre y puedes reintentar con la misma.
• Si la primera petición sigue en curso cuando llega la repetición, la segunda recibe 409 — reintenta en unos segundos.
• Reutilizar una clave con un cuerpo distinto devuelve 422: señala un error de integración.
• Sin la cabecera, todo funciona como siempre (es opcional). Los endpoints de consulta la ignoran.