Concepts
Authentication
Authenticate every request with a secret API key sent as a bearer token.
Send your API key in the Authorization header of every request, as a bearer token:
API keys
Create and revoke keys under Developers in the dashboard. Each key belongs to one project and one environment:
| Prefix | Environment |
|---|---|
pay_test_ | Sandbox |
pay_live_ | Production |
The key alone decides the environment; there is no header or parameter for it. See Sandbox and production.
Keep keys secret
- The full key is shown once, when you create it. Camel stores only a keyed hash.
- Use keys only from your server. Never put them in a browser, a mobile app, or a public repository.
- If a key leaks, create a new one, deploy it, and revoke the old one. Revoked keys stop working at once.
Errors
A missing, malformed, or revoked key returns 401:
{
"detail": "Invalid API key"
}The Request log in the dashboard shows the requests made with each key, for 30 days.