Limits

The request rate limit, the number of keys, the request size and the caching rules.

Request rate

No more than 300 requests per 60 seconds from one sender address, separately for each of five counters:

  • the reference endpoints GET /api/v1/me and GET /api/v1/services together;
  • creating a payment;
  • reading a payment and looking it up by order number: polling statuses does not use up the creation limit;
  • creating a refund;
  • reading refunds.

The count is kept per IP address the request came from, not per key: several of your servers behind one address share the limit. Requests rejected because of the key count too.

The remainder is shown in the headers of every response:

HeaderWhat it holds
RateLimit-LimitThe limit
RateLimit-RemainingHow many requests are left until the end of the window
RateLimit-ResetIn how many seconds the count starts over
RateLimit-PolicyThe limit and the window length in one line

A request over the limit gets a 429 error. Wait as many seconds as RateLimit-Reset says: until the end of the window the response stays the same.

Keys

A merchant can have no more than 10 keys at a time. Details: Authentication.

Request size

A request body is accepted only as JSON and no larger than 256 KB. Only payment creation and refund creation have a body.

Caching

API responses must not be cached: each has the Cache-Control: no-store header. This applies to intermediate nodes on your side too: a stale copy of the service list would show the payer a payment method that no longer exists.

API v1 · built 2026-11-18 · release f13e6bf

The API reference is built from the server code: it never describes an endpoint that does not exist.