Authentication

Amos Pay API supports API key authentication through request headers.

Supported Headers

• X-Api-Key

Use the authentication panel in the API reference to set your API key when testing requests.

Security Notes

• Use sandbox credentials against sandbox servers.
• Never commit secret API keys to the docs repository.
• Prefer environment-scoped keys and rotate keys regularly.

Troubleshooting Auth Errors

• 401 Unauthorized: verify the key is present and active.
• 403 Forbidden: verify the key has access to the requested resource.
• 429 Too Many Requests: apply retries with exponential backoff.