> 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/help-center/ai-docs/platezhi-integracii-i-uvedomleniya/merchants.md).

# Мерчанты

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

Для работы требуется право «Разрешить доступ к мерчанту». Просмотр закрытых параметров и управление их защитой выдаются отдельными правами.

## Список

В панели управления откройте:

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

В списке видны название, провайдер, статус, поддерживаемые валюты, число заявок, объём, приоритет, состояние подключения и время проверки. Фильтры ищут по названию, провайдеру, статусу и датам.

Состояния «Шлюз доступен», «Ошибка» и «Нет данных» относятся к проверке подключения. Они не заменяют тестовую оплату и callback.

## Создание

1. Нажмите «Добавить мерчант».
2. Выберите «Провайдер».
3. Укажите понятное внутреннее «Название».
4. Оставьте статус отключённым.
5. Нажмите «Добавить».
6. Откройте созданную карточку и завершите настройку.

Нельзя безопасно включить пустую оболочку модуля. Сначала заполните соединение, суммы, лимиты и правила, затем выполните тест.

## Вкладка «Основное»

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

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

## Тексты для клиента

«Инструкция по оплате» отображается клиенту на платёжном этапе. «Примечание для платежа» помогает сотруднику понять особенности провайдера.

Заполните клиентскую инструкцию на всех активных языках. Не помещайте в неё секреты подключения, внутренние пороги или данные другого клиента.

## Суммы и допуски

Настройте:

* «Погрешность суммы платежа»;
* «Сумма к оплате (для клиента)»;
* «Сумма, которая должна быть зачислена».

Для суммы выбирается одна из баз:

* «Сумма (с доп. комиссией)»;
* «Сумма (с комиссией доп. и ПС)»;
* «Сумма (без комиссий)».

Погрешность принимает число или процент в формате, указанном подсказкой. Она используется при сравнении фактического поступления с ожидаемым. Слишком широкий допуск может признать неверную оплату подходящей.

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

Настройте:

* дневной объём;
* месячный объём;
* минимальную сумму одной заявки;
* максимальную сумму одной заявки;
* дневное количество заявок;
* месячное количество заявок.

Нулевое значение означает отсутствие соответствующего ограничения. Лимиты карточки действуют вместе с лимитами правил мерчантов. При отказе выбора проверяйте оба уровня.

## Доступ и безопасность

«Включить кнопку в мерчанте „Отменить заявку“» разрешает клиентское действие на странице провайдера. Проверьте, в какой статус переходит заявка и освобождается ли резерв.

«Запретить управлять заявкой с другого IP адреса» ограничивает управление исходным или разрешённым адресом. В поле «Разрешенные IP адреса» можно вводить IPv4, IPv6 или диапазоны в поддерживаемом формате, разделяя значения запятой или новой строкой.

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

## Приоритет и расхождение суммы

Чем выше «Приоритет», тем раньше мерчант рассматривается при одинаковых условиях. Отдельно задаются действия:

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

Доступные решения включают признание операции мошеннической, пересчёт с проверкой и перевод в один из рабочих статусов. Выбирайте действие по политике контроля риска. Для недоплаты безопаснее требовать проверку, чем автоматически считать заявку оплаченной.

## Вкладка «Соединение»

Набор полей зависит от выбранного провайдера. Панель показывает только параметры установленного модуля. Заполняйте их по названиям формы и инструкции конкретного сервиса.

Callback-адреса «Return URL», «Success URL» и «Failed URL» копируйте кнопками панели. Если используется «Секретный ключ», итоговый callback может включать его. Не отправляйте такие адреса посторонним.

Если карточка сообщает, что файл модуля повреждён, не включайте мерчант. Восстановите или переустановите модуль и повторно проверьте его целостность.

## Вкладка «Настройки» и «Опции»

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

## Общие настройки логирования

Кнопка «Настройки» на странице списка открывает «Общие настройки мерчанта». Флаг «Логирование запросов мерчанта» управляет сохранением запросов к шлюзам приёма платежей.

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

## Подключение к направлению

Создайте правило по инструкции [«Правила мерчантов и выплат»](/help-center/ai-docs/nastroika-obmena/list-and-card/merchant-and-payout-rules.md). Сам статус мерчанта не заставляет направление использовать его.

## Полная проверка

1. Проверьте состояние соединения.
2. Создайте правило только для тестового направления.
3. Создайте заявку внутри лимитов.
4. Сверьте сумму, валюту, сеть и инструкцию.
5. Откройте платёжную страницу.
6. Проверьте успешный callback.
7. Проверьте недоплату и переплату безопасными тестовыми значениями.
8. Проверьте повторный callback.
9. Сверьте карточку заявки и три журнала.
10. Только после этого включайте рабочую область.


---

# 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/help-center/ai-docs/platezhi-integracii-i-uvedomleniya/merchants.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.