> 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).


---

# 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/knowledge-base/platezhi/merchants/iexwallet.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.