Мерчант 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" (либо нажмите тут для быстрого перехода к данной странице) - далее "" - введите 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-адрес v4 (также IPv6, если есть. IPv6 может быть не доступен тогда его можно пропустить и вставить только IPv4) back-end сервера - нажмите "" - введите 2FA.

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

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

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

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

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

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

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

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

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

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

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

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

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

Webhook

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

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

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

Настройка webhook

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

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

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

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

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

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

7. Добавьте публичный ключ в TXT запись домена, указанного при создании ключа. Разберем на примере добавления записи в Cloudflare. а) Зайдите в ЛК Cloudflare -> на странице "Websites" на страницу настроек домена, который вы указывали при создании ключа. б) Перейдите на страницу "DNS" -> "Records" -> нажмите "" -> "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.

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

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

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

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

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

• - выбор провайдера через который будет осуществляться прием фиатной валюты. На данный момент 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-> нажмите "".

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

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

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

Верификация

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

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

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

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

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

• .

• .

• и обязательно сохраните все изменения. (см. примеры ниже)

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

##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. ##

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

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

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

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

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

• .

• .

• (см. пример ниже) и обязательно сохраните изменения

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

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

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

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

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

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

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

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

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

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

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

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

7. Готово! ##

• После проделанных действий, на клиентской части на этапе оплаты заявки появится .