Rate limits

The number of call to the PayFit partner API is limited per client application (and not by valid access_token).

The default rate limit is 50 requests per second for any READ requests and 20 requests per second for write request.

If any of the limits configured is being reached, the API will return a 429 status code with the following JSON body:

{ "message": "API rate limit exceeded" }

Don't worry, we will send some additional headers back to you telling what are the limits allowed and how many requests are available:

X-RateLimit-Limit-Second:20
X-RateLimit-Remaining-Second: 4

We will also send headers telling the limits in the time frame and the number of requests remaining:

💡 We strongly suggest that you handle this error and add a "wait and retry" mechanism.