> 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/iexwallet.md).

# Подключение iEXWallet

Подключение iEXWallet для приёма криптовалюты и автоматических выплат

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

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

Для приёма средств откройте:

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

Для выплаты откройте:

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

Мерчант требует право «Разрешить доступ к мерчанту», автовыплата — «Разрешить доступ к выплатам» из блока «Мерчанты и выплаты». Для раскрытия сохранённых значений нужны соответственно права «Просмотр закрытых ключей мерчантов» и «Просмотр закрытых ключей автовыплат» из того же блока. Права выдаются по пути **«Пользователи» — «Список групп пользователей»**. Порядок временного открытия полей приведён в статье [«Доступ к закрытым параметрам»](/knowledge-base/platezhi/merchants/secret-access.md).

## Подготовка в iEXWallet

Создайте сайт в iEXWallet, разрешите нужные активы и сети и получите данные Public API. Официальная страница продукта открывается из подсказки провайдера в панели: [iEXWallet](https://iexexchanger.com/wallet).

Для рабочего подключения нужны домен API, идентификатор и секрет. Для входящих уведомлений также подготовьте адрес callback, который показывает карточка мерчанта, и отдельный секрет callback, если он задан в iEXWallet.

## Поля соединения

| Поле панели       | Что указать                                      | Важно                                                                                            |
| ----------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| «API domain»      | Базовый публичный HTTP(S)-адрес вашего iEXWallet | Не добавляйте произвольный путь операции                                                         |
| «API ID»          | Значение `apiId` из iEXWallet                    | Обязательное поле                                                                                |
| «API Key»         | Значение `apiKey`                                | Поле можно оставить пустым: тогда используется API ID; если заполнить, значения должны совпадать |
| «API secret»      | Секрет подписи запросов                          | Обязательное закрытое поле                                                                       |
| «Callback secret» | Отдельный секрет подписи исходящих webhook       | Есть только у мерчанта; если оставить пустым, используется API secret для совместимости          |

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

## Настройка входящего мерчанта

{% stepper %}
{% step %}

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

Нажмите «Добавить мерчант», выберите провайдер «iEXWallet», задайте внутреннее название и оставьте статус выключенным.
{% endstep %}

{% step %}

### Заполните соединение

Откройте вкладку «Соединение» и внесите API domain, API ID, API Key, API secret и при необходимости Callback secret.
{% endstep %}

{% step %}

### Настройте callback

Скопируйте callback-адрес из карточки мерчанта и укажите его для сайта в iEXWallet. Не набирайте адрес вручную и не передавайте его вместе с секретом посторонним.
{% endstep %}

{% step %}

### Выберите валюты и правила

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

{% step %}

### Проведите тест депозита

Создайте заявку: iEXWallet должен вернуть адрес и, если сеть требует, memo. Проверьте ожидаемую сумму, поступление транзакции, подтверждения и конечное состояние заявки.
{% endstep %}
{% endstepper %}

## Состояния депозита

| Состояние                                                               | Что означает менеджеру                                                                     |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| «Депозит создан, ожидается входящая транзакция»                         | Адрес выдан, но поступление в сети ещё не найдено                                          |
| «Транзакция найдена, ожидаются подтверждения сети»                      | Поступление обнаружено, завершать заявку рано                                              |
| «Подтверждения получены, проверяется сумма»                             | Сеть подтверждена, система сопоставляет фактическую и ожидаемую суммы                      |
| «Депозит оплачен точной суммой»                                         | Поступила ожидаемая сумма                                                                  |
| «Депозит оплачен с переплатой»                                          | Поступило больше ожидаемого                                                                |
| «Депозит финализирован с отличающейся суммой»                           | Средства поступили, но сумма отличается; дальнейшее действие определяют настройки мерчанта |
| «Возврат депозита находится в процессе»                                 | Запущен возврат, нужен контроль до конечного состояния                                     |
| «Возврат депозита отправлен»                                            | Возврат передан в сеть                                                                     |
| «Окно мониторинга депозита истекло»                                     | Поступление не подтверждено в предусмотренный срок                                         |
| «Депозит отменён»                                                       | Депозит закрыт без подтверждённой оплаты                                                   |
| «Депозит завершился ошибкой» или «Депозит завершился системной ошибкой» | Нужно открыть журнал и установить причину                                                  |
| «Возврат депозита завершился ошибкой»                                   | Возврат не подтверждён; не создавайте повторный до сверки состояния                        |

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

## Настройка автовыплаты

1. В «Списке автовыплат» нажмите «Добавить» и выберите iEXWallet.
2. Оставьте подключение выключенным и заполните API domain, API ID, API Key и API secret.
3. Разрешите одну тестовую валюту и нужную сеть.
4. Создайте отдельное правило выплаты с малыми безопасными лимитами.
5. Проверьте адрес получателя и memo/tag в тестовой заявке.
6. Запустите выплату и найдите её внешний идентификатор в журнале.
7. Дождитесь финального подтверждения сети и только затем считайте выплату завершённой.

## Состояния выплаты

| Состояние                                | Что делать                                                                               |
| ---------------------------------------- | ---------------------------------------------------------------------------------------- |
| «Выплата создана»                        | Дождаться следующего этапа, не повторять запрос                                          |
| «Выплата ожидает ручного одобрения»      | Проверить операцию в iEXWallet и выполнить предусмотренное согласование                  |
| «Выплата одобрена»                       | Продолжать контроль до отправки в сеть                                                   |
| «Выплата поставлена в очередь»           | Проверить очередь и фоновые процессы при чрезмерном ожидании                             |
| «Выплата ожидает пополнения ликвидности» | Проверить доступный баланс нужного актива и сети                                         |
| «Выплата подписывается»                  | Не создавать повторную выплату                                                           |
| «Выплата отправлена в сеть»              | Проверить хэш и ссылку на обозреватель, затем ждать подтверждения                        |
| «Выплата подтверждена сетью»             | Финальный успешный результат                                                             |
| «Выплата отклонена оператором»           | Проверить причину отклонения                                                             |
| «Выплата завершилась ошибкой»            | Сверить журнал, внешний идентификатор и состояние iEXWallet до нового запроса            |
| «Выплата отменена»                       | Убедиться, что транзакция не была отправлена, и только затем принимать решение о повторе |

Принятие запроса iEXWallet ещё не означает перевод средств. Выплата может ожидать ручного одобрения, очереди, ликвидности, подписи и подтверждения сети. Только состояние «Выплата подтверждена сетью» является финальным успешным результатом.

## Что поддерживает подключение

Коннектор обслуживает создание и проверку депозитов, подписанные webhook, создание и проверку выплат, получение справочников активов и сетей, балансов, оценки комиссии, списков депозитов и выплат, а также тест и повторную отправку webhook. Часть служебных операций используется системой и не обязана отображаться отдельной кнопкой в карточке.

Подключение iEXWallet не заменяет AML, KYC, выставление внешних счетов или отдельную конвертацию активов. Эти проверки и правила настраиваются в соответствующих разделах iEXExchanger.

## Защита от повторной операции

Номер заявки связывает запрос iEXExchanger с депозитом или выплатой iEXWallet. Повторный webhook с тем же событием и повторная проверка состояния не должны создавать второй платёж.

Если панель потеряла связь после запуска выплаты:

1. не нажимайте выплату повторно;
2. откройте **«Журнал событий» — «Логи платёжных шлюзов»**, выберите вкладку «Автовыплаты» и найдите внешний идентификатор;
3. проверьте состояние операции в iEXWallet;
4. обновите карточку заявки;
5. создавайте новый запрос только после подтверждения, что предыдущий не был принят.

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

1. Подключение проходит штатную проверку без раскрытия секретов.
2. Актив и сеть совпадают в валюте, правиле и iEXWallet.
3. Депозит возвращает правильный адрес и memo.
4. Точная сумма, недоплата и переплата дают ожидаемые состояния.
5. Webhook и фоновая проверка приводят к одному результату без дубля.
6. Выплата использует правильный адрес, memo, сумму и сеть.
7. В журнале видны внешний идентификатор, состояние, хэш транзакции, ссылка на обозреватель и число подтверждений, когда провайдер их вернул.
8. Баланс и резерв изменяются один раз.
9. Повторное событие не создаёт второй депозит или выплату.

Общие поля, лимиты и правила описаны в статьях [«Мерчанты»](/knowledge-base/platezhi/merchants.md), [«Автоматические выплаты»](/knowledge-base/platezhi/merchants/automatic-payouts.md) и [«Логи платёжных шлюзов»](/knowledge-base/platezhi/merchants/gateway-logs.md).