Headers
Every response tells you where you stand:When you go over
The API returns429 with a Retry-After header, in seconds:
Retry-After seconds, then send the request again. For a money call, send it with the same Idempotency-Key.
Stay under the limit
- Use webhooks, not polling, to learn when a transaction finishes.
- Use bulk payouts to send up to 100 payouts in one request. See Bulk payouts.
- Cache reference data. Bank and operator lists change rarely.
- Spread batch jobs out. A job that sends 500 requests in a burst will be limited. Pace it.
The limit is per IP address, not per key. Several services behind one outbound address share one
allowance.
Hosted checkout limits
The public checkout behind a payment link has its own limits: 120 payment attempts per link and 20 per payer IP address in any 10 minutes. Over that, the checkout returns429.
