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

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

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

Waltix можно использовать в двух независимых ролях:

* как мерчант для создания входящего криптовалютного инвойса и проверки оплаты;
* как автовыплату для отправки криптовалюты клиенту и последующей проверки статуса.

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

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

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

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

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

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

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

## Что подготовить

До настройки получите в кабинете Waltix пару **API Key ID** и **API Key Secret**, уточните разрешённые активы и сети и подготовьте минимальную безопасную сумму теста. Никогда не передавайте секрет в заявку, чат, комментарий или снимок экрана.

Код актива сам по себе недостаточен. Например, одинаковая валюта в разных сетях должна выбираться как разные варианты поля **«Валюта и сеть Waltix»**.

## Входящий мерчант

{% stepper %}
{% step %}

### Создайте выключенную запись

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

{% step %}

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

На вкладке **«Соединение»** укажите **«API Key ID»** и **«API Key Secret»**. После сохранения закрытое значение может не показываться полностью — это не означает, что оно удалено.
{% endstep %}

{% step %}

### Настройте опции

На вкладке **«Опции»** выберите **«Валюта и сеть Waltix»** и проверьте:

* **«Макс. время регистрации в сети (мин.)»** — сколько ждать появления перевода в сети;
* **«Макс. время подтверждения в сети (часы)»** — сколько ждать необходимого подтверждения.

Начальные значения формы — 30 минут и 2 часа. Меняйте их только с учётом фактической скорости выбранной сети и клиентского таймера заявки.
{% endstep %}

{% step %}

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

Разрешите нужную валюту в карточке мерчанта, затем создайте отдельное правило по пути **«Основное» — «Направление обмена» — «Правила мерчантов»**. Сеть правила, валюта «Отдаю» и «Валюта и сеть Waltix» должны совпадать.
{% endstep %}

{% step %}

### Проведите тест

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

## Состояния входящего инвойса

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

Система проверяет состояние через API. Отсутствие отдельной настройки callback в карточке Waltix не является ошибкой. Не завершайте заявку только по словам клиента — нужен подтверждённый результат проверки и данные сети.

## Автоматическая выплата

1. По пути **«Мерчанты и API» — «Список автовыплат»** нажмите «Добавить» и выберите Waltix.
2. Оставьте запись выключенной.
3. На вкладке «Соединение» заполните **«API Key ID»** и **«API Key Secret»**.
4. На вкладке «Опции» выберите точную **«Валюту и сеть Waltix»**.
5. Разрешите соответствующую валюту в карточке автовыплаты.
6. Создайте правило по пути **«Основное» — «Направление обмена» — «Правила выплат»** с минимальными тестовыми лимитами.
7. Проведите одну выплату, сверив адрес, memo/tag, сумму, сеть и внешний идентификатор.
8. Дождитесь конечного состояния по проверке уже созданной выплаты.

Waltix отправляет получателю сумму, указанную в заявке; комиссия сервиса списывается сверх неё. До включения рабочего потока убедитесь, что доступного баланса хватает и на сумму клиенту, и на комиссию.

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

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

## Защита от повторной выплаты

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

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

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

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

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