Skip to main content

Key types

Each partner has two types of keys:

Generate your keys

1

Log in to the dashboard

Go to the partner dashboard and sign in with your partner account.
2

Navigate to the API section

In the sidebar, click API Keys.
3

Generate a key

Click Generate new key and choose the type (test or live).
4

Copy your key

The key is displayed only once. Copy it and store it securely (environment variables, secret manager).
Never share your API keys. Never commit them in your source code. Always use environment variables.

Usage

Add the Authorization header to every request:

Allowed IP addresses

Your API keys only work from the IP addresses you have declared. This applies to both test and live keys, and the list is mandatory: while it is empty, every request is refused.
1

Open the Allowed IP Addresses section

In the dashboard sidebar, click Allowed IP Addresses.
2

Add the public address of each server

Enter the public IPv4 or IPv6 address of every server that calls the API, with an optional label. You can declare up to 2 addresses on the Découverte plan and up to 10 addresses on a paid plan (Starter, Business, Premium).
3

Confirm with your authenticator app

Adding an address requires a code from your authenticator app.
A request sent from any other address returns 403 IP_NOT_ALLOWED:
The message contains the address KemyCard saw for your request: this is the one to add. If your account returns to the Découverte plan, your addresses are kept, but only the 2 oldest ones keep working.
You are notified by email every time an address is added to or removed from your list. If you did not make the change, remove the address, regenerate your API keys and contact us at hi@kemycard.com.
The Try it panel of this documentation sends requests straight from your browser. To use it with your own key, add the public IP address of the computer you are browsing from to your allowed IP addresses.
Private addresses (such as 10.x.x.x or 192.168.x.x) cannot be added. If your servers have changing addresses, route your API calls through a fixed outbound address (NAT gateway or static egress IP).

Revoking a key

You can revoke a key at any time from the dashboard. Once revoked, any request using that key will return a 401 AUTHENTICATION_FAILED error.

Permissions

Each key gives access to the products included in your plan:
Calling a product that is not included in your plan (virtual accounts, gift cards on Découverte) returns 402 PLAN_UPGRADE_REQUIRED. Each API key is limited to 30 requests per minute on Découverte and 100 requests per minute on a paid plan.
Send your key only in the Authorization header, and never put a key in a URL: an address can be stored by proxies and browsers along the way. If a key ends up in a URL by mistake, KemyCard masks it in its own logs, but you should regenerate it from your dashboard.