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

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

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

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

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

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

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

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

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

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

Создайте сайт в iEXWallet, разрешите нужные активы и сети и получите данные Public API. Официальная страница продукта открывается из подсказки провайдера в панели: iEXWallet.

Для рабочего подключения нужны домен 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 для совместимости

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

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

1

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

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

2

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

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

3

Настройте callback

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

4

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

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

5

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

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

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

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

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

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

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. Повторное событие не создаёт второй депозит или выплату.

Общие поля, лимиты и правила описаны в статьях «Мерчанты», «Автоматические выплаты» и «Логи платёжных шлюзов».