Skip to content

Authentication

Every request carries your API key in the X-Api-Key header:

X-Api-Key: 2109ebc98a52c66fb73e406b52425b8fa45398cb5a2ebc5e

A request without a key, with a wrong key, or for a merchant the operator has switched off gets 401 unauthorized.

Your keys

You have two secrets:

What it does
API key Authenticates your requests to the API.
Callback secret Signs the callbacks we send to your server, so you can check they are ours.

Both are on the Account page of the merchant portal. They do not change. If one leaks, ask your account manager for new ones.

Keep them on your server

The API key lets anyone create payments as you. Keep both secrets in your server's environment variables: never in client-side code, a mobile app or a public repository.