Skip to main content

Authentication & Required Headers

Authentication & Required Headers​

Every PayWise API call must include authenticated and traceable request metadata.

Required headers​

  • PW-subscription-key: <key>
  • PW-origin-country: <ISO2>
  • PW-request-date: YYYY-MM-DD HH:mm:ss (UTC)
  • PW-ip-address: <client_ip>
  • User-Agent: <service>/<version>
  • Idempotency-Key: <unique-key-per-mutation>
  • X-Request-Id: <caller-generated-trace-id>
Breaking changes

Header requirements can evolve by gateway policy. Pin versions and review changelog entries before production cutovers.