Primeros pasos

Ids de petición

Cada respuesta lleva una cabecera x-request-id que identifica esa petición.

Todas las respuestas de la API, también las de error y las de rutas públicas, incluyen la cabecera x-request-id con un identificador único: req_ seguido de 24 caracteres hexadecimales.

HTTP/1.1 200 OK
x-request-id: req_f96b8763d193e6a199ab9d99
content-type: application/json; charset=utf-8

Regístralo en tus logs junto con el código de estado, sobre todo cuando la respuesta no es 2xx.
Inclúyelo al escribir a soporte: identifica la petición exacta.
El id lo genera el servidor en cada petición. No se puede enviar uno propio y no sirve para deduplicar: repetir la petición da un id distinto.

Los webhooks no llevan x-request-id: su identificador es el id del evento, que viaja en el cuerpo y en X-Pasarela-Event-Id.