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).
Usage
Add theAuthorization 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.
403 IP_NOT_ALLOWED:
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.
Revoking a key
You can revoke a key at any time from the dashboard. Once revoked, any request using that key will return a401 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.