> 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/guide/integracii/merchanty-i-api/avtovyplaty/cryptoway.md). # CryptoWay {% hint style="danger" %} Перед настройкой автоматических выплат обязательно ознакомьтесь с предупреждением о рисках. Автоматическая выплата отправляет реальные средства без дополнительного подтверждения. Ошибка в настройках валюты, сети или направления может привести к потере средств. {% endhint %} {% hint style="warning" %} Перед включением автоматических выплат обязательно выполните тестовую выплату на небольшую сумму. API-ключ должен иметь разрешение **Withdrawal**. Если для ключа разрешены только депозиты, выплаты выполняться не будут. {% endhint %} CryptoWay — криптовалютный сервис, который позволяет автоматически отправлять криптовалюту клиентам через API. После подключения iEXExchanger самостоятельно создаёт выплату, отслеживает её статус и автоматически завершает заявку после успешной отправки средств. Модуль поддерживает: * автоматическую отправку криптовалюты; * проверку статуса выплаты; * получение хеша транзакции; * передачу Memo или Tag; * работу с несколькими блокчейн-сетями; * обработку промежуточных и ошибочных статусов. ### Что нужно подготовить Перед настройкой подготовьте следующие данные из кабинета CryptoWay: `API Key ID` `API Key Secret` Для автоматических выплат API-ключ должен иметь разрешение: **Withdrawal — операции с выводом средств** Разрешение **Deposits** используется для приёма платежей и для работы автовыплаты не требуется. Один API-ключ можно использовать одновременно для приёма и выплат, если для него включены оба разрешения. В целях безопасности рекомендуется создать отдельный ключ для автоматических выплат. *** ### Регистрация в CryptoWay Перейдите на официальный сайт:
Создайте аккаунт или войдите в существующий. После входа: 1. Перейдите в раздел **«API ключи»**. 2. Нажмите **«Создать API ключ»**. 3. Укажите произвольное название ключа. 4. При необходимости укажите публичный IP-адрес вашего сервера. 5. Включите разрешение **Withdrawal**. 6. Подтвердите создание ключа. 7. Скопируйте `Key ID` и `Key Secret`. Сохраните полученные данные в безопасном месте и не передавайте их третьим лицам. {% hint style="warning" %} `Key Secret` показывается только при создании ключа. Повторно посмотреть его не получится. Если ключ не был сохранён, потребуется создать новую пару ключей. {% endhint %} Если список разрешённых IP-адресов оставить пустым, CryptoWay может автоматически сохранить IP-адрес первого успешного API-запроса. Последующие запросы будут приниматься только с этого IP. Для рабочего подключения рекомендуется сразу указать публичный IP Backend-сервера обменного пункта. *** Для добавления модуля откройте: **«Мерчанты и API» → «Список автовыплат»**
Нажмите **«Добавить»**. В списке модулей выберите **Cryptoway**. ### Настройка автовыплаты
{% stepper %} {% step %} #### API Key ID Укажите идентификатор API-ключа из кабинета CryptoWay. Пример: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` Поле обязательно для заполнения. У API-ключа должно быть включено разрешение **Withdrawal**. {% endstep %} {% step %} #### API Key Secret Укажите секретную часть API-ключа. Она используется для подписи запросов: * создания выплаты; * проверки статуса выплаты; * получения списка доступных валют и сетей. Поле обязательно для заполнения. Не добавляйте пробелы в начале или конце значения. {% endstep %} {% step %} #### API Base URL Оставьте стандартное значение: `https://api.cryptoway.com` Изменяйте это поле только по рекомендации технической поддержки CryptoWay. Не указывайте здесь адрес личного кабинета или домен вашего обменного пункта. {% endstep %} {% endstepper %}
#### Код валюты Выберите код валюты и блокчейн-сети, в которой будет выполняться выплата. Например: * `USDTTRC20` * `USDTBEP20` * `BNBBEP20` Для выплаты USDT в сети TRC20 необходимо выбрать: * `USDTTRC20` Для выплаты USDT в сети BEP20: * `USDTBEP20` Использовать только общий код валюты, например `USDT`, нельзя. CryptoWay принимает код валюты, привязанный к конкретной блокчейн-сети. Сеть должна полностью совпадать с сетью валюты, которую клиент получает по заявке. Если выбрано значение **«Автоматически»**, система будет использовать код сети из настроек валюты. Перед запуском обязательно убедитесь, что этот код соответствует идентификатору валюты в CryptoWay. {% hint style="info" %} Если в заявке указан адрес сети TRC20, а в модуле выбрана сеть BEP20, выплата может завершиться ошибкой или привести к потере средств. {% endhint %} *** ### Привязка автовыплаты к валюте После сохранения автовыплаты её необходимо назначить валюте, которую клиент получает по заявке. Откройте: **«Основное» → «Валюты» → «Список валют»** Выберите необходимую валюту и перейдите в раздел автоматизации.
В качестве автовыплаты выберите **Cryptoway**. Проверьте соответствие: * валюты в iEXExchanger; * блокчейн-сети; * кода валюты в настройках автовыплаты. Если одна валюта используется в нескольких сетях, рекомендуется создать отдельную копию автовыплаты для каждой сети. {% content-ref url="/pages/zEyPL7CgzEo11hFHLWrh" %} [Автоматизация валют с разными сетями](/guide/integracii/merchanty-i-api/avtomatizaciya-valyut-s-raznymi-setyami.md) {% endcontent-ref %} *** ### Проверка статуса выплаты Статус выплаты проверяется через API CryptoWay. Для корректной проверки статуса необходимо: * чтобы API-ключ оставался активным; * чтобы у ключа было разрешение **Withdrawal**; * чтобы публичный IP сервера был разрешён; * чтобы время на сервере было синхронизировано; * чтобы Backend имел доступ к `https://api.cryptoway.com`; * чтобы на сервере выполнялись фоновые задачи iEXExchanger. ### Что проверить перед запуском Перед использованием автоматических выплат убедитесь, что: * `API Key ID` заполнен правильно; * `API Key Secret` заполнен правильно; * для API-ключа включено разрешение **Withdrawal**; * `API Base URL` имеет значение `https://api.cryptoway.com`; * код валюты и сеть указаны без ошибок; * не используется виртуальный код без сети, например `USDT`; * публичный IP сервера разрешён в настройках API-ключа; * автовыплата привязана к нужной валюте или направлению; * на балансе CryptoWay достаточно средств; * на балансе есть дополнительная сумма для оплаты комиссии; * сумма выплаты не ниже минимального лимита CryptoWay; * адрес получателя соответствует выбранной сети; * для валют с Memo или Tag настроено соответствующее поле; * во время тестирования включено логирование запросов. ### Проверка работы Перед использованием на реальных заявках рекомендуется выполнить тестовую выплату. Порядок проверки: 1. Создайте тестовое направление. 2. Привяжите автовыплату **Cryptoway**. 3. Выберите правильный код валюты и сети. 4. Укажите небольшую сумму. 5. Создайте тестовую заявку. 6. Запустите выплату. 7. Проверьте появление операции в кабинете CryptoWay. 8. Дождитесь изменения статуса на `executed`. 9. Проверьте получение хеша транзакции. 10. Убедитесь, что клиент получил правильную сумму. 11. Проверьте сумму комиссии, списанную с баланса. 12. Убедитесь, что заявка успешно завершилась. Журнал запросов находится в разделе: **«Журнал событий» → «Мерчанты и API» → «Лог запросов автовыплат»** *** ### Рекомендации Используйте отдельный API-ключ CryptoWay только для автоматических выплат. Разрешите для него только операцию **Withdrawal** и ограничьте доступ публичным IP-адресом Backend-сервера. Не публикуйте `API Key ID` и `API Key Secret` в переписках и на скриншотах. Перед включением автоматических выплат всегда выполняйте несколько тестовых операций с небольшими суммами. Отдельно протестируйте каждую используемую валюту и блокчейн-сеть. Отдельно протестируйте валюты, для которых требуется Memo или Tag. Не запускайте выплату повторно, если первая операция имеет неизвестный или промежуточный статус. После успешной проверки можно отключить расширенное логирование запросов. *** ### Коротко Для подключения автоматических выплат через CryptoWay необходимо: 1. Зарегистрироваться в CryptoWay. 2. Создать API-ключ с разрешением **Withdrawal**. 3. Получить `API Key ID` и `API Key Secret`. 4. Добавить модуль **Cryptoway** в разделе автовыплат. 5. Заполнить обязательные поля. 6. Оставить стандартный `API Base URL`. 7. Выбрать правильный код валюты и сети. 8. Привязать автовыплату к валюте или направлению. 9. Проверить баланс, комиссию и минимальную сумму. 10. Выполнить тестовую выплату. 11. Убедиться, что выплата получила статус `executed`. 12. Проверить хеш транзакции и успешное завершение заявки. --- # 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/guide/integracii/merchanty-i-api/avtovyplaty/cryptoway.md?ask=&goal= ``` `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.