> 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/knowledge-base/platezhi/merchants.md).

# Мерчанты

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

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

Для работы требуется право «Разрешить доступ к мерчанту» из блока «Мерчанты и выплаты». Для открытия скрытых значений соединения отдельно выдаётся «Просмотр закрытых ключей мерчантов» из того же блока. Права находятся по пути **«Пользователи» — «Список групп пользователей»**.

## Список

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

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

В карточке списка отдельно показываются внутреннее название, название провайдера, версия установленного модуля и количество поддерживаемых валют. Здесь же видны статус, число заявок, объём, приоритет, состояние подключения и время проверки. Кнопка «Логи» быстро открывает журнал именно этого мерчанта. Фильтры ищут по названию, провайдеру, статусу и датам.

Число заявок и объём увеличиваются по новым успешно обработанным операциям. Повторная обработка той же операции не должна создавать вторую запись в этих итогах. Если статистика выглядит завышенной, сопоставьте её с уникальными заявками и журналом мерчанта до ручной корректировки данных.

На телефоне данные карточки переносятся на несколько строк. Не принимайте количество валют за версию модуля: это самостоятельные значения.

Карточка разделяет доступность API и безопасность callback. Состояния относятся к последней проверке и не заменяют тестовую оплату.

Над списком находятся рабочие группы. Вкладка «Все» возвращает полный доступный список, а выбранная группа оставляет только включённых в неё мерчантов. Кнопка с плюсом создаёт группу; в редакторе можно изменить её название, видимость, порядок и состав. Запись остаётся одним мерчантом, поэтому удаление группы не удаляет подключение и не меняет его правила. Для групп действует то же право «Разрешить доступ к мерчанту» из блока «Мерчанты и выплаты».

## Состояние мерчанта в списке

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

### Доступность API

| Состояние                | Как понимать                                                |
| ------------------------ | ----------------------------------------------------------- |
| «API: доступен»          | Последняя проверка завершилась успешно                      |
| «API: частично доступен» | Ответ получен, но обнаружена ограниченная работоспособность |
| «API: ошибка»            | Последняя проверка завершилась ошибкой                      |
| «API: не проверен»       | Сохранённого результата ещё нет                             |
| «API: проверка устарела» | Старый результат не подтверждает текущую доступность        |
| «API: без проверки»      | Модуль не поддерживает такой способ диагностики             |
| «Модуль недоступен»      | Установленный модуль нельзя использовать или прочитать      |
| «API: статус неизвестен» | Текущий результат нельзя определить надёжно                 |

Панель также показывает время проверки, последний результат, HTTP-статус, время ответа, последнюю успешную проверку и число ошибок подряд, если эти данные доступны. Для выключенного мерчанта фоновая проверка не выполняется. Старый успешный результат не доказывает, что сервис работает сейчас.

### Проверки безопасности

Состояние **«Защита: OK»** означает, что применимые проверки настроек пройдены. **«Проблемы: N»** требует открыть список замечаний. **«Без callback»** означает, что модуль не принимает входящие уведомления; **«Защита: неизвестно»** — что отчёт получить нельзя.

Проверяются:

* доступность модуля мерчанта;
* наличие маршрута приёма уведомлений;
* секрет в URL уведомлений, если он требуется модулю;
* список IP-адресов отправителей, если модуль требует такое ограничение.

Состояния **«Готово»**, **«Исправить»**, **«Не требуется»** и **«Не проверено»** относятся к отдельному пункту. Исправьте все обязательные замечания до включения мерчанта. Этот отчёт не проверяет правильность API-ключа и не проводит денежную операцию — соединение, платёж и повторный callback тестируются отдельно.

## Создание мерчанта

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

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

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

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

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

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

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

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

Редактор этих полей предлагает разрешённые теги заявки. Используйте их для номера, сумм и других динамических значений вместо ручного копирования данных. Перед рабочим включением проверьте подстановки на тестовой заявке: недоступный или ошибочно написанный тег может остаться пустым либо отображаться как текст. Пользовательские подстановки описаны в статье [«Обработчики тегов»](https://docs.iexexchanger.com/knowledge-base/sait-i-prodvizhenie/reviews/tag-processors.md).

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

Настройте:

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

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

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

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

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

Настройте:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для провайдера iEXWallet используются точные поля «API domain», «API ID», «API Key», «API secret» и «Callback secret». Порядок создания депозита, настройки callback и проверки сети описан в статье [«Подключение iEXWallet»](https://docs.iexexchanger.com/knowledge-base/platezhi/merchants/iexwallet.md).

Для Waltix используются «API Key ID», «API Key Secret», «Валюта и сеть Waltix» и отдельные сроки регистрации и подтверждения перевода. Полный безопасный тест приведён в статье [«Подключение Waltix»](https://docs.iexexchanger.com/knowledge-base/platezhi/merchants/waltix.md).

У мерчанта Exnode на вкладке «Опции» доступно поле «Срок действия счёта (в часах, от 1 до 168)». Оно задаёт срок создаваемого счёта отдельно от таймера заявки. После изменения проверьте оба значения на тестовой оплате и не обещайте клиенту более длинный срок, чем показывает фактический счёт.

## Настройка актуальных подключений

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

{% tabs %}
{% tab title="001k" %}
На вкладке «Соединение» заполните «Access Key» и «Secret Key». На вкладке «Опции» выберите «Валюта и сеть 001k», затем задайте «Макс. время регистрации в сети (мин.)» и «Макс. время подтверждения в сети (часы)».

Выбранный метод должен совпадать с входящей валютой и сетью направления. Система выдаёт адрес для конкретной заявки, сохраняет его вместе с сетью и проверяет поступление по сохранённым данным. Если ответ при создании адреса потерян, сначала восстановите уже созданные реквизиты; не запрашивайте новый адрес вслепую. Наличие поступления без достаточного числа подтверждений или с состоянием AML-карантина не означает успешную оплату.
{% endtab %}

{% tab title="Cryptoway" %}
На вкладке «Соединение» заполните «API Key ID», «API Key Secret», «API Base URL» и «Callback Key». Значение «API Base URL» меняйте только по официальному адресу вашего подключения. На вкладке «Опции» задайте «Код валюты», «Макс. время регистрации в блокчейне (в мин.)» и «Макс. время получения 1-го подтверждения (в часах.)».

После тестовой оплаты проверьте создание адреса, появление внешнего идентификатора, callback и последующую проверку статуса. Повторный callback не должен создавать второе поступление.
{% endtab %}

{% tab title="BestMerchant" %}
На вкладке «Соединение» заполните «API Token». На вкладке «Опции» выберите «Способ оплаты» и задайте «Макс. время ожидания поступления (в мин.)» и «Макс. время подтверждения поступления (в часах)».

Проверьте, что выбранный способ действительно доступен вашему аккаунту и соответствует реквизитам направления. На тестовой заявке сравните сумму и точность, выданные реквизиты и результат проверки статуса. BestMerchant используется для входящих платежей и не создаёт автовыплаты.
{% endtab %}

{% tab title="ByDEX" %}
На вкладке «Соединение» заполните «API Key». Подключение принимает RUB по номеру телефона и переводит клиента на страницу оплаты. В заявке должны быть корректный телефон, положительная сумма и валюта RUB.

Проверьте переход по выданной ссылке, возврат клиента, входящее уведомление и ручную проверку существующего платежа. Если ответ при создании страницы потерян, сначала восстановите ссылку и состояние уже созданной операции; повторный запрос не должен создавать отдельный платёж для той же заявки.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Поля одного и того же провайдера в мерчанте и автовыплате сохраняются раздельно. Заполнение входящего подключения не означает, что исходящая выплата уже настроена.
{% endhint %}

## Тест соединения

Для запуска проверки сотруднику одновременно нужны точные права:

* **«Разрешить доступ к мерчанту»** из блока **«Мерчанты и выплаты»**;
* **«Разрешить доступ к логам мерчантов и api»** из блока **«Админпанель»**.

Откройте **«Мерчанты и API» — «Список мерчантов»**, выберите мерчант и перейдите на вкладку **«Соединение»**. Если установленный модуль поддерживает диагностику, нажмите **«Тест соединения»**. Откроется окно **«Проверка соединения»**.

{% hint style="warning" %}
Проверка использует сохранённые настройки. Если форма содержит несохранённые изменения, сначала решите, нужно ли их сохранить; иначе тест выполнится с прежними значениями.
{% endhint %}

Проверка проходит последовательные этапы:

1. **«Настройки мерчанта»** — заполнены ли обязательные сохранённые поля;
2. **«Ключ доступа»** — можно ли использовать ключ или подпись;
3. **«Доступ к аккаунту»** — принял ли сервис авторизацию;
4. **«Получение данных»** — удалось ли прочитать и проверить ответ;
5. **«Дополнительная проверка»** — предусмотренная модулем проверка, если она есть.

Состояния **«В очереди»**, **«Выполняется»**, **«Успешно»**, **«С предупреждением»** и **«Ошибка»** относятся к конкретному запуску. Если журнал временно не обновился, проверка может продолжаться в фоне — нажмите **«Обновить журнал»**, а не запускайте несколько одинаковых тестов подряд.

{% tabs %}
{% tab title="Результат" %}
Показывает общий итог, каждый этап и понятную причину проблемы. Исправляйте первый неуспешный этап: последующие могут отображаться как **«Не проверялось»**, потому что проверка остановилась раньше.

Типичные причины:

* неверные или незаполненные данные подключения;
* отклонённый ключ или недостаточные разрешения в кабинете сервиса;
* запрет IP-адреса сервера;
* недоступный прокси, DNS, TLS или тайм-аут;
* ограничение частоты запросов;
* неожиданный ответ внешнего API.
  {% endtab %}

{% tab title="Для поддержки" %}
Показывает **«Номер проверки»**, полную цепочку запросов, ответов и сетевые измерения. Секретные значения скрываются.

При обращении передайте номер проверки, время запуска, название мерчанта, первый неуспешный этап и безопасный текст ошибки. Не добавляйте к отчёту открытые ключи из кабинета провайдера.
{% endtab %}
{% endtabs %}

Тест проверяет соединение и чтение данных. Он **не создаёт платёж, не выполняет выплату и не подтверждает возможность денежных операций**. Даже после результата **«Соединение работает, данные получены»** проведите отдельный безопасный сквозной тест оплаты и callback.

Кнопка отображается только у сервисов, для которых подключён диагностический сценарий. Первым готовым сценарием является Rapira; для остальных модулей отсутствие кнопки не означает ошибку настройки.

## Прокси для мерчантов

Централизованная маршрутизация настраивается по пути **«Утилиты» — «Сервисы» — «Прокси-менеджер»**. Для этой страницы требуется право «Разрешить управление proxy менеджером в админпанели» из блока «Базовое управление».

На вкладке **«Назначения пулов»** выберите пул для назначения «Мерчанты». Если пул не назначен, сохраняется обычное поведение конкретного подключения: используется его индивидуальный прокси, а при отсутствии такого прокси — прямое соединение. Сохранённый индивидуальный прокси, который сотрудник выключил вручную в общем каталоге, временно пропускается с переходом на прямой маршрут; автоматически заблокированный после ошибок узел останавливает запрос.

Если пул назначен, запросы мерчантов должны проходить через доступные записи этого пула. Пустой или выключенный назначенный пул и отсутствие работоспособного прокси останавливают запрос; прямое соединение в обход назначенного пула не используется. Система сохраняет текущий прокси и при ошибке выбирает следующий с учётом состояния и порядка пула.

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

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

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

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

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

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

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

Создайте правило по инструкции [«Правила мерчантов и выплат»](https://docs.iexexchanger.com/knowledge-base/obmen/list-and-card/merchant-and-payout-rules.md). Сам статус мерчанта не заставляет направление использовать его.

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

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

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