Ctrlk
ДемоОфициальный сайт
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cryptoway

Для регистрации и получения информации об условиях работы перейдите на официальный сайт CryptoWay.

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

Если неправильно указать API-ключ, Callback Key или сеть, адрес для оплаты может не создаться, а автоматическая обработка платежей работать не будет.

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

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

Модуль поддерживает:

  • создание адресов для оплаты;

  • автоматическую проверку поступлений;

  • webhook-уведомления;

  • ручную и автоматическую проверку платежей;

  • работу с несколькими блокчейн-сетями.

Что нужно подготовить

Перед настройкой подготовьте следующие данные из кабинета CryptoWay:

API Key ID

API Key Secret

Для приёма криптовалюты API-ключ должен иметь разрешение Deposits.

Разрешение Withdrawal предназначено для автоматических выплат и для работы мерчанта на приём не требуется.

Регистрация в CryptoWay

Перейдите на официальный сайт: https://cryptoway.com/ru

Создайте аккаунт или войдите в существующий.

После входа:

  1. Перейдите в раздел «API ключи».

  2. Нажмите «Создать API ключ».

  3. Укажите произвольное название ключа.

  4. При необходимости укажите публичный IP-адрес вашего сервера.

  5. Включите разрешение Deposits.

  6. Подтвердите создание ключа.

  7. Скопируйте Key ID и Key Secret.

Сохраните полученные данные в безопасном месте и не передавайте их третьим лицам.

Key Secret показывается только при создании ключа. Повторно посмотреть его не получится. Если ключ не был сохранён, потребуется создать новую пару ключей.

Если список разрешённых IP-адресов оставить пустым, CryptoWay может автоматически сохранить IP-адрес первого успешного API-запроса. Последующие запросы будут приниматься только с этого IP.

После создания API-ключа откройте профиль CryptoWay и скопируйте значение Callback Key.

Он используется для проверки подписи входящих уведомлений о платежах.

Для добавления мерчанта откройте: «Мерчанты и API» → «Список мерчантов»

Нажмите «Добавить».

В списке модулей выберите Cryptoway.

Настройка мерчанта

1

API Key ID

Укажите идентификатор API-ключа из кабинета CryptoWay.

Пример:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Поле обязательно для заполнения.

2

API Key Secret

Укажите секретную часть API-ключа.

Она используется для подписи запросов:

  • создания адресов оплаты;

  • проверки поступления средств;

  • получения списка доступных валют и сетей.

Поле обязательно для заполнения.

Не добавляйте пробелы в начале или конце значения.

3

API Base URL

Оставьте стандартное значение:

https://api.cryptoway.com

Изменяйте это поле только по рекомендации технической поддержки CryptoWay.

Не указывайте здесь адрес личного кабинета или домен вашего обменного пункта.

4

Callback Key

Оставьте поле пустым

Код валюты

Выберите код валюты и блокчейн-сети, который используется в CryptoWay.

Например:

  • USDTTRC20

  • USDTBEP20

  • BNBBEP20

Для USDT в сети TRC20 необходимо выбрать:

  • USDTTRC20

Для USDT в сети BEP20:

  • USDTBEP20

Использовать только общий код валюты, например USDT, нельзя. CryptoWay принимает код валюты, привязанный к конкретной блокчейн-сети.

Автоматизация валют с разными сетями

Сеть должна полностью совпадать с сетью используемой валюты в 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, а заявка автоматически изменила статус.

ПредыдущаяiEXWalletСледующая2328.io

Последнее обновление

Это было полезно?