Request Structure

Request URL structure

Pay.io APIs use a straightforward URL naming convention, consisting of two parts, a base URL and endpoint path.

Base URL for API requests in staging environment

https://gateway.stage.pay.io/

Request structure example

Structure

https://{base-url}/{endpoint-path}

Example full request URL for staging environment

https://gateway.stage.pay.io/v1/merchant/currencies

---

Required Headers

• X-API-Key: Your unique API key obtained from your account settings in Merchant Console or provided by support team.

• X-API-Nonce: A unique identifier (UUID) for each request to prevent replay attacks. See Creating a Merchant Signature (nonce) guide for more.

• X-API-Signature: Signature generated using RSA-SHA256. See more in Authorisation guide.