Zenso Docs
Errors
Understand common API errors and how to retry safely.
Error shape
Example
json
{
"detail": "Invalid request body."
}Common errors
| Status | Meaning | Action |
|---|---|---|
| 400 | Invalid request body. | Check amount, currency, URLs, customer details, and metadata. |
| 401 | Missing, invalid, or revoked secret key. | Check the Authorization header and dashboard key status. |
| 403 | The key or merchant cannot perform the action. | Check live approval and payment permissions. |
| 429 | Too many requests. | Retry later with the same Idempotency-Key where appropriate. |