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