Rate limits
Each secret key has its own allowance of requests, so one busy integration does not slow another.
The limit#
By default a key can make 300 requests a minute. Requests beyond that are refused with 429 until the minute resets. If you need more, contact us with your use case.
Headers#
RateLimit-Remaining: how many requests you have left in the current window.Retry-After: on a429, how many seconds to wait before trying again.
Staying under it#
- Do not poll for a payment's outcome. Use webhooks instead.
- When you do get
429, wait forRetry-Afterand then retry with growing delays. - Use
limit=200when reading long lists, rather than many small pages.