1.2.2 Core - Catalog & Offers

Документ описывает каталог платежных решений, структуру офферов, политику анонимности и модель ставок платформы PSP Aggregator.

1. Каталог платежных решений

Каталог — витрина офферов для агентов и мерчантов. Бренды провайдеров в каталоге не показываются: виден Alias оффера.

• Список решений: доступные варианты процессинга в виде списка офферов.
• Двухступенчатая фильтрация: каскадный поиск GEO → метод оплаты.
  • Шаг 1: География: страны и регионы (например EU, LATAM, CIS).
  • Шаг 2: Метод оплаты: типы платежей (например банковские карты, локальные APM, криптовалюта).
  • Доступные валюты определяются выбранной географией, отдельный фильтр по валюте не требуется.

2. Политика анонимности

На платформе действует единое правило анонимности: агент не видит Real Name провайдера. Мерчант не видит его до статуса сделки Agreed.

• Маскировка: в каталоге и в Proposal отображается Alias оффера (например Card-EU-01), не название провайдера.
• Уровни доступа:
  • Admin / SuperAdmin: видят Real Name, контакты и Raw Provider Rate всегда.
  • Агент и мерчант: видят условия, ставки своего уровня и Alias. После Agreed Real Name открывается мерчанту.

3. Структура оффера

Оффер — публичный тариф в каталоге на базе провайдера. Один провайдер может иметь несколько офферов.

• Публичные параметры: поддерживаемые страны (GEO), платежные методы, Base Rate (для агента).
• Скрытые параметры (только Admin / SuperAdmin): Real Name, контакты провайдера, Raw Provider Rate, Platform Margin, служебные поля (в том числе источник, кто привёл провайдера).
• Статусы: Active (доступен в каталоге) или Paused (скрыт / временно недоступен).
• Каскадная пауза: Admin может поставить на паузу отдельный оффер или целиком провайдера. Пауза провайдера переводит все его офферы в Paused. Агенты с активными сделками в статусе Negotiation получают Telegram-алерты: условия изменились, нужно пересмотреть отправленные ссылки.

4. Расчёт маржинальности

Система использует двухуровневую модель наценки.

Base Rate  = Raw Provider Rate + Platform Margin
Total Fee  = Base Rate + Agent Margin
           = Raw Provider Rate + Platform Margin + Agent Margin

• Raw Provider Rate: исходная комиссия провайдера. Видят только Admin / SuperAdmin.
• Platform Margin: наценка платформы при заведении оффера. Видят только Admin / SuperAdmin.
• Base Rate: ставка каталога для агента. В Merchant Inbound без агента мерчант видит её же (как Total Fee при Agent Margin = 0).
• Agent Margin: агент добавляет свою наценку при сборке Proposal. Мерчант разбивку не видит.
• Total Fee / Final Fee: единая монолитная ставка для мерчанта.
• Гранулярное управление ставками: оффер может содержать несколько тарифов (payin, payout, settlement). На UI агент задаёт наценку на каждое числовое или процентное значение отдельно. Текстовые и логические условия (GEO, методы, описание) остаются read-only.
• Ограничение агента: снизить Base Rate агент не может. Для этого — кнопка Request Special Terms (см. 1.3 User Stories & Use Cases).

5. Итеративность и переговоры

Торг идёт внутри единой сделки-тикета, а не через набор одноразовых ссылок.

• Переговоры агент — мерчант: если мерчанта не устраивает Total Fee, агент открывает текущий тикет, снижает Agent Margin и генерирует обновлённую Secure-ссылку. Событие пишется в Event Log. Встречные точечные комментарии мерчанта — [Post-MVP].
• Переговоры агент — Admin: агент нажимает Request Special Terms, вводит текстовое обоснование (сохраняется в Event Log), Assignee переключается на Admin. Admin меняет Base Rate и возвращает мяч агенту. Точечные комментарии к цифрам — [Post-MVP].

6. Связанные документы

• 1.1 Vision & Scope
• 1.2.1 Core - Users & Roles
• 1.3 User Stories & Use Cases
• 1.4 Data Models