Rate limits

Each endpoint allows a number of requests per minute for your project.

• Reads and payment creation allow 1,200 requests a minute. Creating payouts, canceling payouts and listing disputes allow 600.
• Every answer on a limited route carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (seconds until the window resets).
• Past the limit the answer is 429 rate_limited with a Retry-After header. Wait that many seconds, then retry with the same Idempotency-Key.
• Prefer webhooks to polling. Reading a payment in a loop until it is paid spends your limit and is slower than the payment.paid event.