Мерчант whitebit

Поддерживаемые валюты

  • Банковские карты: EUR, USD, KTZ, UAH (временно недоступно)

  • Криптовалюты: BTC, ETH, LTC, USDT...

Установка мерчанта

Используя параметры ниже, установите мерчант через функционал "Install plugin" по инструкции Install plugin.

Параметры для Install Plugin

Plugin type: Merchant module

Plugin URL: @boxexchanger-plugins/merchant-whitebit

Directory path: whitebit

Auth: (Deploy token): оставляем пустым

Package tag: latest

Регистрация и подготовка аккаунта whitebit

  • Зарегистрируйтесь на бирже whitebit - пройдите верификацию личности - включите 2FA.

  • Обратитесь в поддержку whitebit. В сообщении укажите: - Username вашего аккаунта - Запрос на активацию генерации адресов для депозита для работы онлайн обменного сервиса (ссылка на ваш обменный сервис) на движке BoxExchanger.

Создание API ключа на прием на whitebit

Убедитесь, что у вас включена 2FA для аккаунта whitebit. В противном случае вы не сможете создать API ключ.

  1. Перейдите в настройки аккаунта - раздел "API" - ключи API - нажмите "Редактировать" в блоке "Ключи API" (либо нажмите тут для быстрого перехода к данной странице) - далее "Сгенерировать ключ API" - введите 2FA.

  2. Скопируйте в надежное место Ключ (публичный) и Секретный ключ (данные понадобятся для настройки модуля в админ панели).

  3. Введите имя ключа - активируйте эндпоинты (см. список ниже) - нажмите "Подтвердить" - введите 2FA.

Эндпоинты для мерчанта

Раздел "Пополнить" /api/v4/main-account/fiat-deposit-url /api/v4/main-account/create-new-address

Раздел "Перевод между балансами" /api/v4/main-account/transfer

Раздел "Баланс и история кошелька" /api/v4/main-account/balance /api/v4/main-account/history

Раздел "Торговый баланс и история ордеров" /api/v4/trade-account/balance

Раздел "Управление ордерами" /api/v4/order/new /api/v4/order/market

  1. На странице "Ключи API" нажмите "IP-доступ" - далее переведите ползунок в активное положение - введите IP-адрес v4 (также IPv6, если есть. IPv6 может быть не доступен тогда его можно пропустить и вставить только IPv4) back-end сервера - нажмите "Добавить" - введите 2FA.

IP-адрес формате v4 и v6 можно узнать

  1. В админ панеле на странице настроек мерчанта whitebit. Для этого перейдите на страницу "Мерчант и API" - раздел "MERCHANT SYSTEM" - настройки (значок настроек) в блоке с мерчантом "WhiteBit Exchanger" - внизу страницы "PUBLIC IP" и "PUBLIC IPV6".

  2. В ЛК лицензий - поле "Back-end server".

Обратите внимание, что ваш ключ API будет автоматически деактивирован со стороны whitebit в случае отсутствия активности API в течение 14 дней. Его можно будет активировать повторно на странице "Ключи API".

Конфигурация мерчанта в админ панели

Основные настройки

  1. В админ панели перейдите на страницу настроек мерчанта whitebit. Для этого перейдите на страницу "Мерчант и API" - раздел "MERCHANT SYSTEM" - настройки (значок настроек) в блоке с мерчантом "WhiteBit Exchanger".

  2. В поле "API Secret" вставьте ранее скопированный Секретный ключ - нажмите "Save". (после перезагрузки страницы API Secret будет скрыт и перестанет отображаться в админ панели в целях безопасности).

  3. В поле "API Key" вставьте ранее скопированный Ключ (публичный) - нажмите "Save".

  4. Вы можете включить отображение QR-кода с адресом для депозита. Для этого в поле "Payment with QR-code?" выставьте значение "Yes" - нажмите "Save".

  5. Вы можете включить авто конвертацию валюты, которая поступила на ваш баланс whitebit от клиента по заявке. Для этого вам необходимо в разделе "AUTO SELL (AFTER ACCEPT PAYMENT)" для "Convert to" выбрать валюту (USDT/USDC/EUR) в которую будет происходить автоматическая конвертация средств по заявке - нажать "Save".

В случае, если вы хотите использовать связку мерчанта и модуля выплаты whitebit для автоматизации процесса обмена и использования ликвидности биржи, вам необходимо будет включить авто конвертацию в настройках мерчанта whitebit. Обычно включается авто конвертация в USDT.

Также обратите внимание, что валюта в которую будет производиться авто конвертация ("Convert to" в настройках мерчанта) и валюта из которой будет происходить выплата ("Withdraw from" в настройка модуля выплат) должны совпадать для автоматизации процесса.

Webhook

Настройка Webhook важна для:

  • Моментального перевода статуса заявки "На выплату" сразу после получения депозита на whitebit

  • Отображения на странице заявки количества подтверждений сети для зачисления депозита

Настройка webhook

  1. Справа сверху наведите на иконку профиля -> нажмите на "API".

  2. На странице "API" в блоке "Webhook" нажмите "Редактировать".

  3. На открывшейся странице нажмите "Продолжить" -> ваc перенаправит на страницу "Соединение".

  4. Перейдите в админ панель BoxExchanger -> страница "Мерчант и API" -> настройки мерчанта whitebit -> на странице настроек в разделе "WEBHOOK SETTINGS" скопируйте URL.

  5. Вернитесь на страницу "Соединение" в ЛК whitebit -> в поле "Адрес webhook" вставьте URL из шага 4 -> нажмите "Сгенерировать ключ" -> введите 2FA.

  6. Скопируйте в надежное место "Секретный ключ" и "Ключ" (публичный ключ) -> нажмите "Подтвердить".

  7. Добавьте публичный ключ в TXT запись домена, указанного при создании ключа. Разберем на примере добавления записи в Cloudflare. а) Зайдите в ЛК Cloudflare -> на странице "Websites" зайдите на страницу настроек домена, который вы указывали при создании ключа. б) Перейдите на страницу "DNS" -> "Records" -> нажмите "Add record" -> "Type" выберите "TXT" -> "Name" введите "www", если у вас домен формата www.exchanger.com либо "@" если в формате exchanger.com либо субдомен, если в формате subdomain.exchanger.com -> в поле "Content" вставьте публичный ключ webhook из шага 6 -> нажмите "Save".

  8. Вернитесь на страницу "Webhook" в ЛК whitebit -> включите webhook, переведя ползунок в активное состояние -> доступ "Коды" можно отключить.

  9. После того как webhook будет активирован, перейдите обратно в настройки домена Cloudflare из шага 7 б) -> удалите добавленную TXT запись (нажмите "Edit" в поле с TXT записью -> Delete -> подтвердите удаление).

  10. Перейдите в админ панель BoxExchanger -> страница "Мерчант и API" -> настройки мерчанта whitebit -> на странице настроек в разделе "WEBHOOK SETTINGS" -> в поле "Webhook key" вставьте публичный ключ из шага 6 -> нажмите "Save" -> в поле "Webhook Secret" вставьте секретный ключ из шага 6 -> нажмите "Save".

  11. Добавьте IP, с которого whitebit отправляет webhook, в белый список CloudFlare. Инструкция:IP в белый список CloudFlare. IP вы можете уточнить у поддержки BoxExchanger.

  12. Протестируйте работу мерчанта whitebit.

Дополнительные настройки

  • Enable debug mode - значение "1" включает отправку дополнительных логов для разработчиков. Может быть полезно для анализа логов при возникновении трудностей с модулем. Без крайней необходимости рекомендуем не включать и оставить значение "0".

  • Enable Wallet deposit cron - значение "1" активирует возможность генерации статического адреса для депозита в ЛК пользователя. По умолчанию выставлено "0".

  • Add hours to expires time (when find tx with 0 confirms) - настройка увеличения времени заявки после того как система определит транзакцию (будет 0 подтверждений у транзакции). 0.25 = 15min. К пример, если вы укажите 0.5, то время заявки будет увеличено на 30 минут после определения транзакции.

  • BTC/LTC type address - выбор формата адреса (p2sh-segwit/bech32) для депозита для валют BTC и LTC.

  • Provider fiat USD/EUR/UAH/KZT - выбор провайдера через который будет осуществляться прием фиатной валюты. На данный момент whitebit по API поддерживает только VISAMASTER.

Проксирование запросов

Для конфигурации SOCKS5-прокси на вашем сервере, вы можете воспользоваться инструкцией: Установка SOCKS5-прокси.

Перед настройкой проксирования запросов в админ панели скрипта BoxExchanger, зайдите в ЛК whitebit и добавьте IP-адрес сервера, на котором сконфигурированы прокси, в белый список API ключа для приема. В противном случае, whitebit деактивирует ваш API ключ после первого запроса с IP-адреса, которого нет в белом списке ключа.

Для отправки запросов через SOCKS5 proxy, на странице настроек мерчанта whitebit в поле "Socks Proxy URI" укажите ссылку на SOCKS5 proxy в формате socks5://username:password@host:port-> нажмите "Save".

Прием фиатных валют

Для работы с фиатными валютами - обратитесь в поддержку whitebit с запросом активации фиатного шлюза для необходимой валюты.

Внимание! Для приема EUR,USD в настройке данных направлений - шаг "Отображение полей" - обязательно включите созданное по-умолчанию поле "E-mail". Со стороны whitebit требование запрашивать от клиента ввод Email адреса.

Верификация

  • Требования по верификации вы всегда можете уточнить у представителей whitebit

Для локализации текста используйте символ решётки и код языка перед текстом и "##" после текста. Например: ##ua## Текстова інформація ##

Текст, который находится между открывающими и закрывающими тегами будет отображаться только на украинской версии сайта. К примеру если клиент зайдет на сайт на украинском языке то он будет видеть только "Текстова інформація"

Верификация пользователя

Ручная верификация пользователя настраивается в направлении: Ручная верификация Инструкцию по созданию и настройке направления вы можете найти тут: Направление

  • Перейдите в админ панель - вкладка "Направления" - "Настройки направлений" - нажмите "Изменить" в строке с нужным направлением.

  • В настройках направления перейдите к шагу "Верификация" - нажмите "Включить" напротив "ВЕРИФИКАЦИЯ: (IDENT DOCUMENTS PASSPORT ETC)".

  • В поле "Count verification photos" введите кол-во требуемых от пользователя изображений для верификации - в поле редактора текста введите текст с инструкцией для верификации пользователя и обязательно сохраните все изменения. (см. примеры ниже)

Примеры текста для верификации личности на разных языках

##ru## Для прохождения верификации личности предоставьте: 1. Фотографию одного из документов удостоверяющих личность - Паспорт (первая страница) - ID-карта (передняя сторона) - Документ удостоверяющий личность (передняя сторона) 2. Фотографию (селфи) с документом, удостоверяющим вашу личность. В кадре должно быть видно ваше лицо и документ в соответствующем формате. ## ##ua## Для проходження верифікації особи надайте: 1. Фотографію одного з документів, що засвідчують особу - Паспорт (перша сторінка) - ID-карта (лицьова сторона) - Документ, що засвідчує особу (лицьова сторона) 2. Фотографію (селфі) з документом, що засвідчує вашу особу. У кадрі має бути видно ваше обличчя та документ у відповідному форматі. ## ##en## To pass identity verification, please, provide: 1. Photo of one of the identity documents - Passport (first page) - ID card (front side) - driver's license (front side) 2. Photo (selfie) of a person with an identity document. The frame must show the face of the person and the document in the appropriate format. ##

  • После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "Пройти верификацию" напротив поля "Проверка личности". При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображения для верификации.

Верификация валюты

Ручная верификация валюты включается в настройках валюты и позволяет запросить у клиента только одно изображение. Инструкцию по созданию и настройке валюты вы можете найти тут: Валюты

  • Данный тип верификации можно использовать для верификации банковской карты клиента.

  • Верификация "Валюты А" будет запрашиваться во всех направлениях, в которых клиент отдает обменному сервису "Валюту А".

  • Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: Верификация

  • Перейдите в админ панель - вкладка "Валюты" - "Настройка валют" - нажмите "Изменить" в поле нужной валюты.

  • В настройках валюты перейдите к шагу "Другие настройки" - нажмите "Включить" напротив поля "ВЕРИФИКАЦИЯ".

  • В поле редактора текста введите текст с инструкцией для прохождения верификации (см. пример ниже) и обязательно сохраните изменения

Пример текста для верификации банковской карты

##ru## Для того, чтобы верифицировать виртуальную карту Вам необходимо сделать следующие шаги:

  1. Необходимо сделать скриншот из Вашего личного кабинета (в банкинге), на котором должно быть видно: - 4 последние цифры номера карты - срок действия карты

  2. Сделать фото на котором будет написано ФИО, дата и подпись владельца карты, а также видна виртуальная карта с банкинга.

  3. Загрузить фото в поле верификации валюты.

Для того чтобы верифицировать физическую карту:

  1. Возьмите белый лист бумаги.

  2. Расположите на листе банковскую карту так, чтобы было видно номер карты и дату.

  3. Карта и ее тень должны быть видны полностью.

  4. Напишите от руки название сервиса "yourExchangerName".

  5. Поставьте дату и подпись.

  6. Сфотографируйте и загрузите изображение.

  7. Готово! ##

  • После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "Пройти верификацию" напротив поля с названием валюты. При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображение для верификации.

Last updated

Was this helpful?