Request IDs & Observability

Request IDs & Observability

Use caller-generated and PayWise-generated request identifiers together for troubleshooting:

1. Log the request ID on inbound traffic, along with headers that affect routing (environment, api key).
2. Send PW-request-id on requests as the caller-generated trace ID.
3. Record PayWise request_id values returned in error payloads and any response correlation headers.
4. Surface mission-critical errors in dashboards, and correlate with Prometheus/Grafana alerts.
5. When tracing distributed systems, annotate spans with both values so PayWise support can help join the dots.

Pairs well with our rate-limit headers; when you aggregate metrics per request ID you expose hotspots without storing sensitive payloads.