> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/integracii/merchanty-i-api/merchanty/obshie-nastroiki.md).

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

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

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

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

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

<figure><img src="/files/3xMk7rxNLQASGxRX22x5" alt=""><figcaption></figcaption></figure>

Далее:

1. Выберите нужный мерчант.
2. Откройте его карточку.
3. Перейдите во вкладку **«Настройки».**

<figure><img src="/files/AXycRPFtMJmxMvVBQDeY" alt="" width="563"><figcaption></figcaption></figure>

***

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

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

* инструкции для клиента на странице оплаты;
* допустимую погрешность платежа;
* ожидаемую сумму оплаты;
* лимиты по обороту и количеству заявок;
* ограничения по IP-адресам;
* правила обработки недоплаты и переплаты;
* приоритет выбора мерчанта;
* параметры безопасности.

***

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

{% stepper %}
{% step %}

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

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

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

* порядок оплаты;
* важные предупреждения;
* рекомендации по оплате;
* действия после перевода средств.

#### Пример

```
Оплатите заявку по указанным реквизитам.
После перевода средств нажмите кнопку «Я оплатил».
Если оплата не подтвердилась автоматически, обратитесь в поддержку.
```

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

{% step %}

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

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

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

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

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

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

{% stepper %}
{% step %}

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

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

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

* фиксированную сумму;
* процент.

#### Пример

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

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

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

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

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

{% step %}

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

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

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

<table><thead><tr><th width="314.2578125">Вариант</th><th>Описание</th></tr></thead><tbody><tr><td>Сумма без комиссий</td><td>Только сумма обмена</td></tr><tr><td>Сумма с дополнительной комиссией</td><td>С учётом комиссии обменника</td></tr><tr><td>Сумма с дополнительной комиссией и комиссией ПС</td><td>С учётом всех комиссий</td></tr></tbody></table>

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

{% step %}

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

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

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

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

***

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

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

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

{% stepper %}
{% step %}

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

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

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

{% step %}

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

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

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

{% step %}

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

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

#### Пример

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

{% step %}

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

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

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

{% step %}

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

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

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

{% step %}

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

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

Работает аналогично дневному ограничению.
{% endstep %}
{% endstepper %}

***

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

{% stepper %}
{% step %}

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

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

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

{% step %}

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

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

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

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

{% step %}

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

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

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

#### Пример

```
192.168.1.10
192.168.1.11
10.0.0.0/24
```

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

***

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

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

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

#### Пример

<table><thead><tr><th width="208.375">Мерчант</th><th>Приоритет</th></tr></thead><tbody><tr><td>Мерчант A</td><td>10</td></tr><tr><td>Мерчант B</td><td>50</td></tr></tbody></table>

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

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

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

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

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

<table><thead><tr><th width="307.46484375">Вариант</th><th>Что произойдёт</th></tr></thead><tbody><tr><td>Признать мошеннической</td><td>Заявка будет отклонена</td></tr><tr><td>Пересчитать и проверить</td><td>Система попытается пересчитать заявку</td></tr><tr><td>Ожидает обработки</td><td>Заявка перейдёт оператору</td></tr><tr><td>Оплаченная заявка</td><td>Заявка будет считаться оплаченной</td></tr><tr><td>Проверка поступления</td><td>Требуется ручная проверка</td></tr></tbody></table>

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

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

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

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

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

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

<table><thead><tr><th width="242.4375">Вариант</th><th>Назначение</th></tr></thead><tbody><tr><td>Оплаченная заявка</td><td>Продолжить обработку автоматически</td></tr><tr><td>Ожидает обработки</td><td>Передать оператору</td></tr><tr><td>Проверка поступления</td><td>Требуется ручная проверка</td></tr></tbody></table>

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

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

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

* Return URL;
* Success URL;
* Failed URL;
* Секретный ключ.

{% stepper %}
{% step %}

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

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

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

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

{% step %}

### Return URL

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

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

***

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

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

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

* запросы к платёжной системе;
* ответы провайдера;
* callback-запросы;
* ошибки подключения;
* диагностическую информацию.

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

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

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

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

1. Заполните данные подключения.
2. Настройте инструкцию для клиента.
3. Укажите сумму оплаты и ожидаемую сумму поступления.
4. Настройте лимиты при необходимости.
5. Укажите разрешённые IP-адреса платёжной системы.
6. Настройте обработку недоплаты и переплаты.
7. Заполните секретный ключ для Callback.
8. Сохраните настройки.
9. Выполните тестовую оплату.

***

## Коротко

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/integracii/merchanty-i-api/merchanty/obshie-nastroiki.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.