Scheduled maintenanceScheduled maintenance: PayWise infrastructure maintenance is planned from Friday, October 9 at 7:00 p.m. ET through Monday, October 12 at 8:00 a.m. ET. Sandbox and Production services may experience intermittent interruptions during this period. Existing PayWise service URLs and SFTP hostnames will remain unchanged.
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>
  • PW-request-id: <caller-generated-uuid>
Breaking changes

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