Skip to main content
You integrate with all Pagos services via RESTful APIs, secured and authenticated by a unified API key. This guide outlines how to request your API key and authenticate against the APIs:

Generate an API Key

To generate an API key:
1

Click your settings icon in the top-right corner of your Pagos Service Panel.
2

Under Developers, click API Keys.
3

In the API Keys tab, click Create API Key to add a new key to your account.
4

In the side panel that opens, set your Key Name, then click Create API Key.
5

Copy your new API Key and store it somewhere secure.
This is the only time you can view this key!
6

Click I’ve Copied My Keys to confirm and exit the side panel.
You’ll provide this API key with all API requests. Pagos uses this value alone to authenticate requests to our servers; you don’t need to provide a password.

Authentication

The Pagos platform uses API keys to authenticate requests to all our services. To access the API, you must authenticate via Bearer Authentication (e.g. for a cross-origin request). When you make any API request, pass an Authorization header in the following format:
"Authorization: Bearer <api key>”
All API requests must be made over HTTPS; calls made over plain HTTP will fail. API requests without authentication will also fail.
I