For the complete documentation index, see llms.txt. This page is also available as Markdown.

Общие настройки

Раздел «Настройки» внутри карточки мерчанта позволяет управлять логикой приёма платежей, проверкой сумм, лимитами, безопасностью и поведением системы при недоплате или переплате.

Настройки применяются только к текущему мерчанту и не влияют на другие платёжные системы.

Где находится раздел

Откройте: «Мерчанты и API» — «Список мерчантов»

Далее:

  1. Выберите нужный мерчант.

  2. Откройте его карточку.

  3. Перейдите во вкладку «Настройки».


Для чего нужен раздел

Через этот раздел можно настроить:

  • инструкции для клиента на странице оплаты;

  • допустимую погрешность платежа;

  • ожидаемую сумму оплаты;

  • лимиты по обороту и количеству заявок;

  • ограничения по IP-адресам;

  • правила обработки недоплаты и переплаты;

  • приоритет выбора мерчанта;

  • параметры безопасности.


Инструкция для клиента

1

Описание / инструкция по оплате

Это текст, который клиент увидит на странице оплаты заявки.

Обычно здесь размещают:

  • порядок оплаты;

  • важные предупреждения;

  • рекомендации по оплате;

  • действия после перевода средств.

Пример

Инструкция поддерживает несколько языков и отображается клиенту только для данного мерчанта.

2

Примечание для платежа

Используется как назначение платежа или комментарий.

Чаще всего сюда добавляют номер заявки.

Пример: Заявка №[public_id]

Если платёжная система поддерживает комментарии к платежам, это помогает автоматически сопоставлять оплату с нужной заявкой.

Проверка суммы платежа

1

Погрешность суммы платежа

Позволяет указать допустимую недоплату.

Можно использовать:

  • фиксированную сумму;

  • процент.

Пример

Ожидаемая сумма: 100 USDT

Погрешность: 2%

Минимально допустимая сумма: 98 USDT

Если клиент оплатит: 99 USDT платёж будет считаться допустимым.

Если клиент оплатит: 97 USDT система применит правила обработки недоплаты.

2

Сумма к оплате для клиента

Определяет сумму, которую клиент увидит на странице оплаты.

Доступны варианты:

Вариант
Описание

Сумма без комиссий

Только сумма обмена

Сумма с дополнительной комиссией

С учётом комиссии обменника

Сумма с дополнительной комиссией и комиссией ПС

С учётом всех комиссий

Рекомендуется показывать клиенту итоговую сумму, которую он действительно должен оплатить.

3

Сумма, которая должна быть зачислена

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

Именно эта сумма используется при автоматической проверке платежей.

Обычно её значение совпадает с суммой, показанной клиенту.


Лимиты мерчанта

Лимиты позволяют ограничить использование конкретного мерчанта.

Важно: значение 0 означает отсутствие ограничения.

1

Суточный объём

Максимальный оборот через мерчант за сутки.

Если лимит достигнут, система перестанет использовать этот мерчант для новых заявок.

2

Месячный объём

Максимальный оборот через мерчант за месяц.

После достижения лимита мерчант перестаёт участвовать в автоматическом выборе.

3

Минимальная сумма заявки

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

Пример

Если указано: 100 USD то заявка на: 50 USD не сможет использовать этот мерчант.

4

Максимальная сумма заявки

Максимальная сумма для одной заявки.

Если сумма превышает установленный лимит, система выберет другой доступный мерчант.

5

Дневной лимит заявок

Максимальное количество заявок за сутки.

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

6

Месячный лимит заявок

Максимальное количество заявок за месяц.

Работает аналогично дневному ограничению.


Безопасность

1

Разрешить кнопку отмены заявки

Если включено, клиент сможет отменить платёж на стороне мерчанта, если такая возможность поддерживается платёжной системой.

Если отключено, кнопка отмены клиенту не показывается.

2

Запретить управление заявкой с другого IP

Если включено, клиент сможет работать со страницей оплаты только с того IP-адреса, с которого была создана заявка.

Это повышает безопасность, но может создавать неудобства при использовании мобильного интернета или VPN.

Используйте настройку только если она действительно необходима.

3

Разрешённые IP-адреса

Позволяет ограничить список IP-адресов, с которых мерчант может отправлять уведомления о платеже.

Указывайте здесь IP-адреса платёжной системы, если они предоставлены её технической поддержкой.

Пример

Если включена проверка IP, а адрес отправителя отсутствует в списке, уведомление будет отклонено.


Приоритет выбора мерчанта

Поле «Приоритетность» влияет на автоматический выбор мерчанта.

Чем выше значение, тем раньше система попытается использовать этот мерчант.

Пример

Мерчант
Приоритет

Мерчант A

10

Мерчант B

50

При прочих равных условиях система выберет Мерчант B.

Обработка недоплаты

Настройка: «Если сумма поступления меньше чем требуется в заявке»

Определяет действия системы при недоплате.

Доступные варианты:

Вариант
Что произойдёт

Признать мошеннической

Заявка будет отклонена

Пересчитать и проверить

Система попытается пересчитать заявку

Ожидает обработки

Заявка перейдёт оператору

Оплаченная заявка

Заявка будет считаться оплаченной

Проверка поступления

Требуется ручная проверка

Для большинства проектов рекомендуется использовать:

Проверка поступления или Ожидает обработки

Обработка переплаты

Настройка: «Если сумма поступления больше чем требуется в заявке»

Определяет дальнейший статус заявки при переплате.

Чаще всего используют:

Вариант
Назначение

Оплаченная заявка

Продолжить обработку автоматически

Ожидает обработки

Передать оператору

Проверка поступления

Требуется ручная проверка

Callback и секретный ключ

Если платёжная система поддерживает автоматические уведомления (Callback/Webhook), в карточке мерчанта будет доступна отдельная вкладка.

Там отображаются:

  • Return URL;

  • Success URL;

  • Failed URL;

  • Секретный ключ.

1

Секретный ключ

Используется для защиты уведомлений от подделки.

Если мерчант работает через Callback, секретный ключ рекомендуется обязательно заполнить.

Без него система может отклонять входящие уведомления или снижать уровень безопасности проверки.

2

Return URL

Это адрес, на который платёжная система отправляет информацию об успешной оплате.

Именно этот адрес обычно указывается в настройках платёжного шлюза.


Логирование мерчанта

В настройках мерчантов доступен параметр: «Логирование запросов мерчанта»

Если включено, система сохраняет:

  • запросы к платёжной системе;

  • ответы провайдера;

  • callback-запросы;

  • ошибки подключения;

  • диагностическую информацию.

Логирование рекомендуется оставлять включённым, особенно при первоначальной настройке мерчанта.

Это значительно упрощает поиск и устранение проблем.

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

После создания мерчанта выполните следующие шаги:

  1. Заполните данные подключения.

  2. Настройте инструкцию для клиента.

  3. Укажите сумму оплаты и ожидаемую сумму поступления.

  4. Настройте лимиты при необходимости.

  5. Укажите разрешённые IP-адреса платёжной системы.

  6. Настройте обработку недоплаты и переплаты.

  7. Заполните секретный ключ для Callback.

  8. Сохраните настройки.

  9. Выполните тестовую оплату.


Коротко

Вкладка «Настройки» отвечает за логику работы мерчанта: какие суммы показывать клиенту, какие суммы считать корректными, как обрабатывать переплату и недоплату, какие ограничения применять и каким образом защищать взаимодействие с платёжной системой.

Последнее обновление

Это было полезно?