Get your API keys

To call the payment API, you need two API keys: a public key and a private key. They authenticate your requests and link them to your account.

Key types

KeyUse it inKeep it
Public keyIdentifies your application.Client-side code, for example Hosted Elements or tokenization from the browser.Can be exposed in the browser. It has restricted privileges.
Private keyGrants full access to your account.Server-side code only: checkouts, orders, maintenance operations.Confidential. Never expose it in frontend code, repositories, emails or tickets.

Environments

API keys belong to one environment. Each environment has its own set of keys, found in the same place in your account.

EnvironmentWhat it is forMoney
SandboxDevelopment and testing.No real money is moved.
ProductionLive payments.Real payments are processed.
Use the right key set

Sandbox keys do not work in Production, and Production keys do not work in Sandbox. Check which environment you are logged in to before you copy a key.

Find your API keys

  1. Log in to your merchant account, in Sandbox or Production.
  2. In the left sidebar, open the Integration section.
  3. Go to API keys. The table lists the API keys of all your merchant accounts.

API keys table

  1. Select the key you need and select Show key. The action is logged, and you are told so.

API key details

Show key confirmation

Create an API key

  1. In the API keys table, select Create in the bottom right corner.

Create an API key

  1. Fill in the name, type and merchant account, then select Create in the top right corner.

New API key details

Security

Security guidelines
  • Keep the private key server-side. Never put it in frontend code, public repositories or any message (emails, tickets).
  • Use environment variables. Load keys from your server environment, not from source code.
  • Revoke compromised keys. If a key is exposed, revoke it immediately and create a new one.
  • Rotate private keys. Replace them periodically.

Next steps

  1. Set up webhooks so your server receives payment status updates.
  2. Choose your integration type: Hosted Payment Page, Hosted Elements or Direct API integration.
  3. Before going live, work through the Go-live checklist.