PayStar API Documentation
  1. PAYSTAR FEATURES | RU
  • PRODUCTS & FEATURES | EN
    • GATEWAY QUALITY INDEX (GQI)
    • DIRECT CONNECT
    • PAYSTAR CORE
    • Deposits section in PayStar
    • Summary Report
    • Payment Analytics
    • Payment Form Analytics
    • Unified audit log
    • Export reports
    • Black list
    • Commissions
    • Team
    • My Account
    • PayStar in 100 Questions
  • PAYSTAR FEATURES | RU
    • ИНДЕКС КАЧЕСТВА ПЛАТЕЖНЫХ ШЛЮЗОВ
    • ПРЯМОЕ ПОДКЛЮЧЕНИЕ
    • PAYSTAR ЯДРО
    • Депозиты
    • Сводный отчёт
    • Аналитика по платежам
    • Аналитика платёжной формы
    • Единый журнал событий
    • Экспорт отчётов
    • Черный список
    • Комиссии
    • Команда
    • Мой аккаунт
    • PayStar в 100 вопросах
  • MERCHANT API DOC | EN
    • Introduction
    • Glossary
    • Authorization key
    • Sandbox
    • Additional fields
    • Currencies
    • Bank names
    • Telecom operators
    • Callbacks
    • Error descriptions
    • Tech FAQ
    • Events
    • Payment history v2
      • Payment history - backward compatibility (legacy `X.Y.Z.W`)
    • Integratins
      • Stripe
      • Inwizo
      • 2Checkout
      • Adyen
      • AffiniPay
      • Alikassa
      • AlliancePay
      • Amazon Pay
      • AnyMoney
      • AstroPay
      • Aureavia
      • AurisMyChanger
      • Authorize.Net
      • Avatarix
    • Balance H2H
    • Deposit H2H - Card & P2P
    • Deposit H2H - Token
    • Deposit H2C - Card
    • Deposit status H2H - PayStar ID
    • Deposit status H2H - Merch ID
    • Payout H2H
    • Payout status H2H - PayStar ID
    • Payout status H2H - Merch ID
  1. PAYSTAR FEATURES | RU

Комиссии

Как настроить учёт, сверки и роутинг по балансам#

Раздел «Комиссии» — это место, где вы задаёте правила расчёта комиссий, которые будут наследоваться в ордера (депозиты и выплаты) и дальше попадать в платежи, отчёты и сверки.

1. Зачем нужны комиссии (бизнес-логика)#

Комиссии решают две ключевые задачи.

1.1. Учёт, отчёты и сверки#

Если вы укажете актуальные комиссии шлюзов/PSP, то в платежах, отчётах и сверках будет отображаться:
корректная сумма комиссии,
корректная экономика транзакции (net / gross — в зависимости от отчёта),
прозрачные обязательства и расчёты для сеттлмента (взаимозачёта).
Итог: меньше “ручной магии” в Excel и проще финансовый контроль.

1.2. Роутинг и каскадинг по балансам шлюзов#

Баланс шлюза/PSP может использоваться в маршрутизации и каскадинге:
выплата в каскаде автоматически пропустит шлюз с нулевым балансом;
можно настроить лимит, чтобы баланс PSP не превышал X:
при достижении X депозиты направляются в другой шлюз,
после сеттлмента баланс снижается,
и депозиты автоматически возвращаются на этот шлюз.
Это удобно, когда вы управляете ликвидностью, лимитами провайдеров и расписанием взаимозачётов.

2. Термины: что вы настраиваете#

2.1. Что такое комиссия#

Комиссия — это набор правил, который наследуется в Deposit order или Payout order в момент создания ордера.
Важно: после создания ордера комиссия “фиксируется” в его данных.

2.2. Что такое комиссионная группа#

Комиссионная группа — это “контейнер” с базовыми параметрами:
Name (название),
Type (тип: Merchant / Gateway / Referral — в зависимости от вашей модели),
Currency (валюта),
привязка к Channels (один или несколько).
Внутри группы вы создаёте одно или множество комиссионных правил.

2.3. Что такое комиссионное правило#

Комиссионное правило — это конкретная формула расчёта комиссии, обычно завязанная на диапазон суммы ордера:
минимальная комиссия,
фиксированная комиссия,
процент,
максимальная комиссия,
rolling (удерживаемая доля) и срок её “заморозки”.

3. Как работает применение комиссии#

3.1. Какая комиссия применится, если её изменили после создания ордера?#

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

3.2. Пример#

Ордер создан в 11:00, комиссия была 2%.
В 11:07 комиссия изменена на 4%.
Комиссия по этому ордеру будет рассчитана по 2%, потому что действует значение на момент создания.

4. Что можно делать в разделе «Комиссии»#

В разделе вы можете:
1.
Создавать и редактировать группы комиссий.
2.
Создавать и редактировать правила внутри групп.
3.
Искать комиссии по данным и работать с фильтрами.

5. Как найти комиссионную группу#

1.
Перейдите в раздел Комиссии через меню.
2.
Введите значение в поиск Name or ID.
3.
При необходимости используйте фильтры:
Commission type
Currency
Channel
4.
Чтобы сбросить условия, нажмите Clear Filters.

6. Колонки в списке комиссионных групп#

В таблице групп обычно отображаются:
Name — название группы комиссии;
Type — тип комиссии (Merchant / Gateway / Referral);
Currency — валюта комиссии;
Channels — каналы, к которым относится группа;
Default — признак группы “по умолчанию” (если используется);
ID (GUID) — идентификатор группы;
⋮ (Actions) — действия (Update / Delete).

7. Как создать комиссионную группу#

1.
Откройте раздел Комиссии.
2.
Нажмите + New commission (правый верхний угол).
3.
Заполните поля формы (Name / Type / Currency / Channels).
4.
Нажмите Save/Add.

8. Как отредактировать или удалить комиссионную группу#

1.
Найдите нужную группу в списке.
2.
Нажмите ⋮ (кебаб-меню) в конце строки.
3.
Выберите:
Update — изменить параметры,
Delete — удалить группу.
4.
При обновлении нажмите Save.

9. Как найти и посмотреть комиссионные правила#

1.
В списке групп нажмите на строку нужной группы.
2.
Откроется вложенность со списком комиссионных правил.

10. Как создать комиссионное правило#

1.
Откройте нужную группу (клик по строке).
2.
Нажмите + Add commission rule.
3.
Заполните параметры правила.
4.
Нажмите Save.
5.
Чтобы добавить ещё правила — нажмите + Add commission rule снова.

11. Колонки в списке правил комиссий (и как их понимать)#

Обычно в правилах доступны такие поля:
1.
Order Amount — сумма/диапазон суммы ордера.
2.
Minimum Commission — минимальная комиссия (сумма).
3.
Fixed Commission — фиксированная комиссия (сумма).
4.
Percent Commission — процент комиссии.
5.
Maximum Commission — максимальная комиссия (сумма).
6.
Rolling Commission — удерживаемая (замораживаемая) доля на срок (rolling reserve).
7.
Rolling Expire days — срок удержания rolling-доли в днях.
Подсказка: fixed и percent часто работают вместе, а min/max ограничивают итоговую комиссию.

12. Практические рекомендации#

Держите комиссии актуальными: иначе отчёты и сверки будут расходиться с провайдером.
Делайте отдельные группы под разные сценарии (разные каналы, валюты, типы операций).
Используйте правила по диапазонам суммы — это помогает моделировать условия PSP и контролировать экономику.

13. Где это используется дальше#

После настройки комиссий они начинают “жить” в:
платежах и деталях транзакций,
отчётах,
финансовых сверках,
логике роутинга/каскадинга (если баланс провайдера учитывается в правилах).
Previous
Черный список
Next
Команда
Built with