Лимиты: настройка ограничений по операциям, оборотам и балансам

Как ограничивать платежи, обороты и балансы

1) Где находится раздел Limits и как он выглядит

Раздел Limits — это список всех действующих лимитов с фильтрами, поиском и кнопкой Add limit.

В таблице обычно отображаются:

Condition — условие лимита в человекочитаемом виде (пример: Failed payment count in 5 min | payeerIdentifier = 3 | €)

Object — к чему привязан лимит (Merchant / Pipeline / Channel / Integration / Gateway)

Created — когда лимит создан

⋮ — действия по лимиту (например, удаление)

2) Когда нужны лимиты: типовые бизнес-кейсы

2.1. Как лимитировать провайдера, если нет полного доверия (или вы хотите “попробовать”)

Используйте лимиты по оборотам и/или балансам, чтобы тестировать провайдера безопасно и не рисковать всем объёмом.

Рекомендуемая настройка

Object: Gateway или Integration (иногда Channel)

Оборот: Turnover1D (быстрый тест) или TurnoverDaily/Weekly/Monthly (календарные caps)

Баланс: MinBalance / Overdraft / MaxBalance

Currency: валюта тестового потока

Важно: чтобы лимиты по балансам работали корректно, укажите актуальные комиссии — иначе расчётный баланс может быть неверным.

2.2. Как ограничить провайдера по обороту (договорной cap на день/неделю/месяц)

Если провайдер дал квоту “не больше X в сутки/неделю/месяц”, задайте календарный лимит.

Рекомендуемая настройка

Object: Integration или Channel

Limit type: TurnoverDaily / TurnoverWeekly / TurnoverMonthly

Currency: нужная валюта

Как считаются календарные периоды (по часовому поясу команды)

День: с 00:00:01 до 23:59:59

Неделя: начинается в понедельник (с 00:00:01)

Месяц: начинается с 1-го числа (с 00:00:01)

2.3. Как ограничить провайдера по балансу (чтобы не уходить в минус или не накапливать остаток)

Балансовые лимиты полезны, когда:

нельзя слать трафик при низком остатке;

нельзя держать слишком большой “флоат” у провайдера;

нужно контролировать допустимый минус (если используется овердрафт).

Рекомендуемая настройка

Object: Gateway / Integration / Channel

Limit type: MinBalance / MaxBalance / Overdraft

Currency: валюта потока/баланса

Важно: корректность балансов зависит от актуальных комиссий.

2.4. Как ограничить количество успешных операций на пользователя (если платёжка не хочет больше)

Если провайдер просит “не больше N успешных транзакций на одного клиента за период”, ставим лимит по успешным с группировкой по “пользователю”.

Рекомендуемая настройка

Object: Gateway / Integration / Channel

Limit type: Success payment count

Interval value: 300 (5 min) / 3600 (1 hour) / 86400 (1 day) — по требованию провайдера

Properties: payeerIdentifier (часто лучший выбор) или cardNumber / phoneNumber

Limit: N (квота)

2.5. Как ограничить количество неуспешных операций пользователя, чтобы не “жечь” реквизиты

Если у пользователя/карты/IP пошла серия отказов — это “сжигает” реквизиты и портит конверсию. Ограничьте попытки в коротком окне.

Рекомендуемая настройка

Object: Gateway / Integration / Channel

Limit type: Failed payment count

Interval value: 60–300 секунд

Properties: cardNumber / payeerIdentifier / ip

Limit: обычно 3–10 (зависит от вашей политики)

2.6. Как защититься от card-testing / бот-атак через лимиты

Для автоматизированного перебора характерны частые попытки и много фейлов. Ограничьте частоту операций по IP и/или картам.

Рекомендуемая настройка

Object: Gateway / Integration / Channel

Limit type: Total payment count и/или Failed payment count

Interval value: 60–300 секунд

Properties: чаще всего ip, иногда дополнительно cardNumber

2.7. Как ограничить суммы на пользователя (AML / внутренние правила)

Если нужно ограничить “сколько денег может провести один пользователь” за день/месяц.

Рекомендуемая настройка

Object: Merchant (правило на весь бизнес) или Gateway/Integration/Channel (правило на конкретного провайдера)

Limit type: Total payment sum или Success payment sum

Interval value: 86400 (1 day) / 2592000 (30 days)

Properties: payeerIdentifier или cardNumber

Currency: нужная валюта

2.8. Как “сгладить” нагрузку на канал, если провайдер нестабилен при высокой частоте

Если провайдер/канал начинает отдавать 5xx/таймауты в пиках — ограничьте количество операций на коротком интервале.

Рекомендуемая настройка

Object: Channel / Integration

Limit type: Total payment count

Interval value: 60–300 секунд

3) На какие объекты можно ставить лимиты

При создании лимита выбирается Object (где действует правило):

Merchant — лимит на уровне мерчанта

Pipeline — лимит в рамках конкретного пайплайна

Channel — лимит на конкретный канал

Integration — лимит на конкретную интеграцию провайдера

Gateway — лимит на провайдера/шлюз в целом

4) Типы лимитов (Limit type) и логика расчёта

4.1. Turnover: обороты

Скользящее окно

Turnover1D — последние 24 часа

Turnover7D — последние 168 часов

Turnover30D — последние 720 часов

Календарные периоды (по часовому поясу команды)

TurnoverDaily — текущий день: 00:00:01 → 23:59:59

TurnoverWeekly — текущая неделя: начинается в понедельник (с 00:00:01)

TurnoverMonthly — текущий месяц: начинается с 1-го числа (с 00:00:01)

4.2. Balance: балансы

MinBalance — не опускаться ниже порога

MaxBalance — не накапливать выше порога

Overdraft — контроль допустимого минуса (если используется)

Чтобы балансы считались корректно, в PayStar должны быть указаны актуальные комиссии (fees).

4.3. Количество операций

Total / Success / Failed payment count

4.4. Суммы операций

Total / Success / Failed payment sum

5) Interval value: что это и как выбрать

Interval value — окно времени (в секундах), за которое считается лимит для типов count/sum.

Типовые значения:

60 — 1 минута

300 — 5 минут

3600 — 1 час

86400 — 1 день

2592000 — 30 дней

5184000 — 60 дней

6) Properties: что это и как выбрать

Properties — это правило, что считать одним пользователем при расчёте лимита (ключ группировки).

Примеры:

cardNumber — один пользователь = одна карта

payeerIdentifier — один пользователь = один плательщик (payeer)

ip — один пользователь = один IP

phoneNumber — один пользователь = один телефон

telecomOperator — один пользователь = один оператор связи

7) Currency: зачем нужна валюта

Currency задаёт валюту расчёта лимита. Обычно лимиты считаются отдельно по каждой валюте, поэтому один и тот же лимит можно настроить для нескольких валют.

8) Как создать лимит (Add limit)

Нажмите Add limit

Выберите Object и конкретный объект (через поиск)

Выберите Limit type

Укажите Interval value (если требуется)

Укажите Properties (если требуется)

Введите Limit (число)

Выберите Currency

Нажмите Add

9) Как управлять лимитами: фильтры и удаление

9.1. Фильтры

Фильтры помогают быстро найти нужный лимит (по валюте, типу, объекту, ID и т. д.).
Кнопка Clear Filters сбрасывает фильтрацию.

9.2. Удаление лимита

Откройте меню ⋮ у строки и выберите Delete.

Лимиты

Как ограничивать платежи, обороты и балансы#

1) Где находится раздел Limits и как он выглядит#

2) Когда нужны лимиты: типовые бизнес-кейсы#

2.1. Как лимитировать провайдера, если нет полного доверия (или вы хотите “попробовать”)#

2.2. Как ограничить провайдера по обороту (договорной cap на день/неделю/месяц)#

2.3. Как ограничить провайдера по балансу (чтобы не уходить в минус или не накапливать остаток)#

2.4. Как ограничить количество успешных операций на пользователя (если платёжка не хочет больше)#

2.5. Как ограничить количество неуспешных операций пользователя, чтобы не “жечь” реквизиты#

2.6. Как защититься от card-testing / бот-атак через лимиты#

2.7. Как ограничить суммы на пользователя (AML / внутренние правила)#

2.8. Как “сгладить” нагрузку на канал, если провайдер нестабилен при высокой частоте#

3) На какие объекты можно ставить лимиты#

4) Типы лимитов (Limit type) и логика расчёта#

4.1. Turnover: обороты#

4.2. Balance: балансы#

4.3. Количество операций#

4.4. Суммы операций#

5) Interval value: что это и как выбрать#

6) Properties: что это и как выбрать#

7) Currency: зачем нужна валюта#

8) Как создать лимит (Add limit)#

9) Как управлять лимитами: фильтры и удаление#

9.1. Фильтры#

9.2. Удаление лимита#

Как ограничивать платежи, обороты и балансы

1) Где находится раздел Limits и как он выглядит

2) Когда нужны лимиты: типовые бизнес-кейсы

2.1. Как лимитировать провайдера, если нет полного доверия (или вы хотите “попробовать”)

2.2. Как ограничить провайдера по обороту (договорной cap на день/неделю/месяц)

2.3. Как ограничить провайдера по балансу (чтобы не уходить в минус или не накапливать остаток)

2.4. Как ограничить количество успешных операций на пользователя (если платёжка не хочет больше)

2.5. Как ограничить количество неуспешных операций пользователя, чтобы не “жечь” реквизиты

2.6. Как защититься от card-testing / бот-атак через лимиты

2.7. Как ограничить суммы на пользователя (AML / внутренние правила)

2.8. Как “сгладить” нагрузку на канал, если провайдер нестабилен при высокой частоте

3) На какие объекты можно ставить лимиты

4) Типы лимитов (Limit type) и логика расчёта

4.1. Turnover: обороты

4.2. Balance: балансы

4.3. Количество операций

4.4. Суммы операций

5) Interval value: что это и как выбрать

6) Properties: что это и как выбрать

7) Currency: зачем нужна валюта

8) Как создать лимит (Add limit)

9) Как управлять лимитами: фильтры и удаление

9.1. Фильтры

9.2. Удаление лимита