Rate limits
Stay within the request limit and recover when you reach it.
The API allows 60 requests per minute per IP address. The limit applies across all Business API endpoints.
Successful responses include your current usage:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59When you reach the limit
The API returns 429 Too Many Requests. Wait for the number of seconds in the Retry-After header before you retry.
HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0{
"status": "error",
"message": "Too many attempts, please try again later.",
"timestamp": 1793404800000
}Stay within the limit
- Use webhooks instead of polling for payment updates.
- Add increasing delays between retries.
- Use
X-RateLimit-Remainingto slow down before you reach the limit. - Remember that servers sharing one outbound IP address share one limit.