Тарифы и лимиты — полный справочник

Коротко

В Qut Pay действуют три разных ограничения, и их важно не путать:

1. Месячный лимит счетов — сколько счетов разрешает ваш тариф. Закончился — приходит tariff_limit_reached (HTTP 429).
2. Суточная защита — это не бизнес-лимит, а страховка от интеграции, ушедшей в цикл. Превышена — приходит tariff_daily_burst (HTTP 429).
3. Частота запросов — сколько HTTP-запросов в секунду вы можете отправлять. Превышена — rate_limited или request_rate_limited.

Процент с оборота не взимается: оплата сервиса — месячная подписка. Деньги приходят напрямую на ваш счёт в Kaspi.

Таблица тарифов

Тариф меняется в разделе Тариф в кабинете: https://qut.kz/app

Как считается месячный лимит

Месячный лимит — это количество созданных счетов, а не оплаченных. Неоплаченный, истёкший или отменённый счёт тоже попадает в счётчик. Поэтому если код выставляет несколько счетов на один заказ, лимит закончится быстрее ожидаемого — включите идемпотентность.

При достижении лимита останавливается только создание новых счетов. Уже созданные продолжают работать: покупатель платит, вебхук приходит, возврат и чтение статуса тоже работают.

Суточная защита

Суточное число — не бизнес-лимит. Оно защищает от цикла в коде, от бесконечных повторов при обработке ошибок и от сломанной интеграции. Нормально работающий магазин до него не доходит: при месячном лимите 800 на тарифе Бастау суточные 200 — это 6 000 в месяц, то есть порог стоит намного выше реальных продаж.

Если вы видите tariff_daily_burst, проверяйте в первую очередь свой код, а не тариф: где-то повторяется цикл, где-то бесконечный retry в обработке ошибок, или на один заказ создаётся несколько счетов.

Разница между двумя ошибками

Есть и третья ошибка: tariff_inactive (HTTP 403) — тариф не оплачен или закончился пробный период. Это не лимит, а неактивная подписка.

Пробный период

Значит, интеграцию можно писать в песочнице сколько угодно долго — семь дней начинают идти только тогда, когда вы принимаете первую настоящую оплату. Подробнее: Пробный период.

Песочница в лимит не входит

Песочница — режим с ключом qp_test_…. Запросы не уходят в Kaspi, настоящие деньги не движутся, оплату вы симулируете сами. Поэтому:

• счета песочницы не попадают в месячный лимит;
• счета песочницы не попадают в суточную защиту;
• как бы часто ни гоняли автотесты в песочнице, на боевой лимит это не влияет.

Разница режимов: Песочница и боевой режим.

Ограничения частоты запросов

Это не количество счетов, а количество HTTP-запросов. Точные значения меняются в зависимости от нагрузки, поэтому пишите код не по фиксированному числу, а по признакам в ответе.

Правильная тактика — растущая пауза (backoff): 1, 2, 4, 8 секунд, с добавлением случайных сотен миллисекунд на каждом шаге. Повтор с постоянным интервалом только продлевает ограничение.

async function withRetry(fn, tries = 5) {
  for (let i = 0; i < tries; i++) {
    const res = await fn();
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get('Retry-After')) || 2 ** i;
    await new Promise((r) => setTimeout(r, wait * 1000 + Math.random() * 300));
  }
  throw new Error('rate limited');
}

Подробнее: Ограничения частоты запросов.

Что делать при приближении к лимиту

1. Посмотрите текущее число за месяц в разделе Тариф в кабинете.
2. Проверьте, нормальное ли это число: совпадает ли количество продаж с количеством счетов? Если разрыв большой — есть дубли.
3. Есть дубли — включите идемпотентность, это заодно экономит лимит.
4. Дублей нет, бизнес действительно вырос — повышайте тариф.
5. Если объём выше 15 000 счетов в месяц, напишите в поддержку о партнёрском тарифе: WhatsApp +7 778 881 3333, Telegram @qutpaybot.

Вопросы и ответы

Если повысить тариф в середине месяца, лимит вырастет сразу? Да, месячный лимит и суточное число нового тарифа применяются с этого момента.

Неоплаченные счета входят в лимит? Да. Лимит считается по созданным счетам, а не по оплаченным.

У меня несколько организаций — лимиты складываются? Нет. У каждой организации свой тариф и свой лимит, они не переносятся между организациями.

Что происходит с уже созданными счетами при достижении лимита? Ничего. Покупатель платит, вебхук приходит, возврат работает. Не создаются только новые счета.

Можно ли отключить суточную защиту? Нет. Это ограничение защищает и вас, и ваших покупателей, если интеграция уйдёт в цикл.