Ограничения

Предел частоты запросов, число ключей, размер запроса и правила кеширования ответов.

Частота запросов

Не больше 300 запросов за 60 секунд с одного адреса отправителя, отдельно на каждый из пяти счётчиков:

  • справочные ручки GET /api/v1/me и GET /api/v1/services вместе;
  • создание платежа;
  • чтение платежа и поиск по номеру заказа: опрос статусов не тратит предел создания;
  • создание возврата;
  • чтение возвратов.

Счёт ведётся по IP-адресу, с которого пришёл запрос, а не по ключу: несколько ваших серверов за одним адресом делят предел между собой. В счёт идут и запросы, отклонённые из-за ключа.

Остаток виден в заголовках каждого ответа:

ЗаголовокЧто в нём
RateLimit-LimitПредел
RateLimit-RemainingСколько запросов осталось до конца окна
RateLimit-ResetЧерез сколько секунд счёт начнётся заново
RateLimit-PolicyПредел и длина окна одной строкой

Запрос сверх предела получает отказ 429. Подождите столько секунд, сколько названо в RateLimit-Reset: до конца окна ответ будет тем же.

Ключи

У мерчанта может быть не больше 10 ключей одновременно. Подробно: Авторизация.

Размер запроса

Тело запроса принимается только в JSON и не больше 256 КБ. Тело есть у создания платежа и у создания возврата.

Кеширование

Ответы API нельзя кешировать: у каждого стоит заголовок Cache-Control: no-store. Это относится и к промежуточным узлам на вашей стороне: устаревшая копия списка сервисов показала бы плательщику способ оплаты, которого уже нет.

API v1 · собрано 18.11.2026 · выпуск f13e6bf

Справочник методов собирается из кода сервера: он не описывает адрес, которого нет.