Rate limits & errors
How many requests you can send, and what to do when something fails.
Rate limits
Each API key can make 120 requests per 60-second window. Every response includes:
| Header | Meaning |
|---|---|
X-RateLimit-Limit | Requests allowed in the window |
X-RateLimit-Remaining | Requests left in the current window |
X-RateLimit-Reset | Seconds until the window resets |
Going over returns 429 with a Retry-After header:
{ "success": false, "message": "Too many requests, please try again later." }Prefer webhooks over polling to stay well under the limit.
Status codes
| Code | Meaning | What to do |
|---|---|---|
200 | Success | |
400 | Invalid request (for example a missing x-seller-id or invalid amount) | Fix the request; do not retry as-is. |
401 | Missing or wrong API key | Check the Authorization header. |
404 | Task, merchant or branch not found | Check the id and seller. |
429 | Rate limited | Wait Retry-After seconds. |
500 / 502 | Error on our side or at the payment gateway | Retry with backoff. Contact support if it persists. |