> For the complete documentation index, see [llms.txt](https://manual.boxexchanger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/merchant-whitebit.md).
# Мерчант whitebit
## Поддерживаемые валюты
* Банковские карты: EUR, USD, KTZ, UAH (*временно недоступно*)
* Криптовалюты: BTC, ETH, LTC, USDT...
## Установка мерчанта
Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin.md).
Параметры для Install Plugin
**Plugin type**: **`Merchant module`**
**Plugin URL**: **`@boxexchanger-plugins/merchant-whitebit`**
**Directory path**: **`whitebit`**
**Auth: (Deploy token)**: оставляем пустым
**Package tag**: **`latest`**
## Регистрация и подготовка аккаунта whitebit
{% hint style="success" %}
* [Зарегистрируйтесь](https://whitebit.com/referral/27d3a06d-9f07-4753-a1e0-257c9817b26e) на бирже whitebit - пройдите верификацию личности - включите 2FA.
* Обратитесь в поддержку whitebit. В сообщении укажите:\
\- Username вашего аккаунта\
\- Запрос на **активацию генерации адресов для депозита** для работы онлайн обменного сервиса (*ссылка на ваш обменный сервис*) на движке BoxExchanger.
{% endhint %}
### Создание API ключа на прием на whitebit
{% hint style="warning" %}
Убедитесь, что у вас включена 2FA для аккаунта whitebit. В противном случае вы не сможете создать API ключ.
{% endhint %}
1. Перейдите в **настройки аккаунта** - раздел "**API**" - **ключи API** - нажмите "**Редактировать**" в блоке "**Ключи API"** (либо [**нажмите тут**](https://whitebit.com/ru/settings/api/api-keys) для быстрого перехода к данной странице) **-** далее **"**[**Сгенерировать ключ API**](#user-content-fn-1)[^1]**" -** введите 2FA.
2. [**Скопируйте** ](#user-content-fn-2)[^2]**в надежное место** **Ключ (публичный)** и **Секретный ключ** (данные понадобятся для [настройки модуля](#osnovnye-nastroiki) в админ панели).
3. Введите имя ключа - активируйте эндпоинты (см. список ниже) - нажмите "[**Подтвердить**](#user-content-fn-3)[^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`
4. На странице "[**Ключи API**](https://whitebit.com/ru/settings/api/api-keys)" нажмите "[**IP-доступ**](#user-content-fn-4)[^4]" - далее переведите ползунок в активное положение - введите IP-адрес v4 (также IPv6, если есть. IPv6 может быть не доступен тогда его можно пропустить и вставить только IPv4) back-end сервера - нажмите "[**Добавить**](#user-content-fn-5)[^5]" - введите 2FA.
{% hint style="info" %}
IP-адрес формате v4 и v6 можно узнать
1. В **админ панеле** на странице настроек мерчанта whitebit. Для этого перейдите на страницу "**Мерчант и API**" - раздел "**MERCHANT SYSTEM**" - настройки ([**значок настроек**](#user-content-fn-6)[^6]) в блоке с мерчантом "**WhiteBit Exchanger**" - внизу страницы "[**PUBLIC IP**](#user-content-fn-7)[^7]" и "**PUBLIC IPV6**".
2. В ЛК [лицензий](https://licence.boxexchanger.net/ru/licenses/) - поле "**Back-end server**".
{% endhint %}
{% hint style="danger" %}
Обратите внимание, что ваш ключ API будет автоматически деактивирован со стороны whitebit в случае отсутствия активности API в течение 14 дней. Его можно будет активировать повторно на странице "**Ключи API**".
{% endhint %}
## Конфигурация мерчанта в админ панели
### Основные настройки
1. В админ панели перейдите на страницу настроек мерчанта whitebit. Для этого перейдите на страницу "**Мерчант и API**" - раздел "**MERCHANT SYSTEM**" - настройки ([**значок настроек**](#user-content-fn-6)[^6]) в блоке с мерчантом "**WhiteBit Exchanger**".
2. В поле "**API Secret**" вставьте ранее скопированный **Секретный ключ** - нажмите "[**Save**](#user-content-fn-8)[^8]". *(после перезагрузки страницы **API Secret** будет скрыт и перестанет отображаться в админ панели в целях безопасности).*
3. В поле "**API Key**" вставьте ранее скопированный **Ключ (публичный) -** нажмите "[**Save**](#user-content-fn-9)[^9]".
4. Вы можете включить **отображение QR-кода** с адресом для депозита. \
Для этого в поле "**Payment with QR-code?**" выставьте значение "Yes**"** - нажмите "[**Save**](#user-content-fn-10)[^10]".
5. Вы можете включить авто конвертацию валюты, которая поступила на ваш баланс whitebit от клиента по заявке. Для этого вам необходимо в разделе "**AUTO SELL (AFTER ACCEPT PAYMENT)**" для "**Convert to**" выбрать валюту (USDT/USDC/EUR) в которую будет происходить автоматическая конвертация средств по заявке - нажать "[**Save**](#user-content-fn-11)[^11]".
{% hint style="info" %}
В случае, если вы хотите использовать связку мерчанта и модуля выплаты whitebit для автоматизации процесса обмена и использования ликвидности биржи, вам необходимо будет включить авто конвертацию в настройках мерчанта whitebit. Обычно включается авто конвертация в USDT.
{% endhint %}
{% hint style="warning" %}
Также обратите внимание, что **валюта в которую будет производиться авто конвертация (***"**Convert to" в настройках мерчанта*****) и валюта из которой будет происходить выплата (*****"Withdraw from" в настройка модуля выплат*****) должны совпадать для автоматизации процесса.**
{% endhint %}
### Webhook
{% hint style="info" %}
Настройка Webhook важна для:
* Моментального перевода статуса заявки "На выплату" сразу после получения депозита на whitebit
* [**Отображения**](#user-content-fn-12)[^12] на странице заявки количества подтверждений сети для зачисления депозита
{% endhint %}
#### Настройка webhook
1. Справа сверху наведите на иконку профиля -> нажмите на "[**API**](#user-content-fn-13)[^13]".
2. На странице "**API**" в блоке "**Webhook**" нажмите "[**Редактировать**](#user-content-fn-14)[^14]".
3. На открывшейся странице нажмите "[**Продолжить**](#user-content-fn-15)[^15]" -> ваc перенаправит на страницу "[**Соединение**](#user-content-fn-16)[^16]".
4. Перейдите в админ панель BoxExchanger -> страница "**Мерчант и API**" -> настройки мерчанта whitebit -> на странице настроек в разделе "**WEBHOOK SETTINGS**" [**скопируйте URL**](#user-content-fn-17)[^17].
5. Вернитесь на страницу "**Соединение**" в ЛК whitebit -> в поле "**Адрес webhook**" вставьте URL из шага 4 -> нажмите "[**Сгенерировать ключ**](#user-content-fn-18)[^18]" -> введите 2FA.
6. [**Скопируйте**](#user-content-fn-19)[^19] в надежное место "**Секретный ключ**" и "**Ключ**" (публичный ключ) -> нажмите "**Подтвердить**".
7. Добавьте публичный ключ в TXT запись домена, указанного при создании ключа. Разберем на примере добавления записи в Cloudflare. \
а) Зайдите в ЛК Cloudflare -> на странице "**Websites**" [**зайдите**](#user-content-fn-20)[^20] на страницу настроек домена, который вы указывали при создании ключа.\
б) Перейдите на страницу "**DNS**" -> "**Records**" -> нажмите "[**Add record**](#user-content-fn-21)[^21]" -> "**Type**" выберите "**TXT**" -> "**Name**" введите "**www**", если у вас домен формата [www.exchanger.com](http://www.exchanger.com) либо "**@**" если в формате exchanger.com либо **субдомен**, если в формате subdomain.exchanger.com -> в поле "**Content**" вставьте публичный ключ webhook из шага 6 -> нажмите "**Save**".
8. Вернитесь на страницу "Webhook" в ЛК whitebit -> [**включите**](#user-content-fn-22)[^22] webhook, переведя ползунок в активное состояние -> доступ "**Коды**" можно отключить.
9. После того как webhook будет активирован, перейдите обратно в настройки домена Cloudflare из шага 7 б) -> [**удалите**](#user-content-fn-23)[^23] добавленную TXT запись (нажмите "Edit" в поле с TXT записью -> Delete -> подтвердите удаление).
10. Перейдите в админ панель BoxExchanger -> страница "**Мерчант и API**" -> настройки мерчанта whitebit -> на странице настроек в разделе "**WEBHOOK SETTINGS**" -> в поле "**Webhook key**" [**вставьте**](#user-content-fn-24)[^24] публичный ключ из шага 6 -> нажмите "**Save**" -> в поле "**Webhook Secret**" вставьте секретный ключ из шага 6 -> нажмите "**Save**".
11. Добавьте IP, с которого whitebit отправляет webhook, в белый список CloudFlare. Инструкция:[IP в белый список CloudFlare](/dlya-razrabotchikov/nastroika-firewall/ip-v-belyi-spisok-cloudflare.md).\
\&#xNAN;***IP вы можете уточнить у поддержки BoxExchanger.***
12. Протестируйте работу мерчанта whitebit.
### Дополнительные настройки
* [**Enable debug mode**](#user-content-fn-25)[^25] - значение "1" включает отправку дополнительных логов для разработчиков. Может быть полезно для анализа логов при возникновении трудностей с модулем. Без крайней необходимости рекомендуем не включать и оставить значение "0".
* [**Enable Wallet deposit cron**](#user-content-fn-26)[^26] - значение "1" активирует возможность [генерации статического адреса](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/pages/2YbSCuZ4WF6yYtnFsRP8#3.-staticheskii-adres-dlya-depozita) для депозита в ЛК пользователя. По умолчанию выставлено "0".
* [**Add hours to expires time**](#user-content-fn-27)[^27] **(when find tx with 0 confirms)** - настройка увеличения времени заявки после того как система определит транзакцию (будет 0 подтверждений у транзакции). \
0.25 = 15min. К пример, если вы укажите 0.5, то время заявки будет увеличено на 30 минут после определения транзакции.
* [**BTC/LTC type address**](#user-content-fn-28)[^28] - выбор формата адреса (p2sh-segwit/bech32) для депозита для валют BTC и LTC.
* [**Provider fiat USD/EUR/UAH/KZT** ](#user-content-fn-29)[^29]- выбор провайдера через который будет осуществляться прием фиатной валюты. На данный момент whitebit по API поддерживает только VISAMASTER.
### Проксирование запросов
{% hint style="info" %}
Для конфигурации SOCKS5-прокси на вашем сервере, вы можете воспользоваться инструкцией: [Установка SOCKS5-прокси](/dlya-razrabotchikov/ustanovka-socks5-proksi.md).
{% endhint %}
{% hint style="info" %}
Перед настройкой проксирования запросов в админ панели скрипта BoxExchanger, зайдите в ЛК whitebit и добавьте IP-адрес сервера, на котором сконфигурированы прокси, в белый список API ключа для приема. \
В противном случае, whitebit деактивирует ваш API ключ после первого запроса с IP-адреса, которого нет в белом списке ключа.
{% endhint %}
Для отправки запросов через SOCKS5 proxy, на странице настроек мерчанта whitebit в поле "**Socks Proxy URI**" укажите ссылку на SOCKS5 proxy в формате `socks5://username:password@host:port`-> нажмите "[**Save**](#user-content-fn-30)[^30]".
## Прием фиатных валют
{% hint style="success" %}
Для работы с фиатными валютами - обратитесь в поддержку whitebit с запросом активации фиатного шлюза для необходимой валюты.
{% endhint %}
{% hint style="warning" %}
**Внимание!** Для приема **EUR,USD** в настройке данных направлений - шаг "**Отображение полей**" - обязательно включите созданное по-умолчанию поле "E-mail". \
Со стороны whitebit требование запрашивать от клиента ввод Email адреса.
{% endhint %}
### Верификация
* Требования по верификации вы всегда можете уточнить у представителей whitebit
{% hint style="info" %}
Для **локализации текста** используйте символ решётки и код языка перед текстом и "##" после текста. \
\&#xNAN;*Например: ##ua## Текстова інформація ##*
Текст, который находится между открывающими и закрывающими тегами будет отображаться только на украинской версии сайта. К примеру если клиент зайдет на сайт на украинском языке то он будет видеть только "*Текстова інформація*"
{% endhint %}
#### Верификация пользователя
{% hint style="info" %}
Ручная верификация пользователя настраивается в направлении: [Направление](/obmen/napravlenie.md#ruchnaya-verifikaciya)\
Инструкцию по созданию и настройке направления вы можете найти тут: [Направление](/obmen/napravlenie.md)
{% endhint %}
* [Перейдите в админ панель - вкладка "*Направления*" - "*Настройки направлений*" - нажмите "*Изменить*" в строке с нужным направлением](#user-content-fn-31)[^31].
* [В настройках направления перейдите к шагу "*Верификация*" - нажмите "*Включить*" напротив "*ВЕРИФИКАЦИЯ: (IDENT DOCUMENTS PASSPORT ETC)*"](#user-content-fn-32)[^32].
* [В поле "*Count verification photos*" введите кол-во требуемых от пользователя изображений для верификации - в поле редактора текста введите текст с инструкцией для верификации пользователя](#user-content-fn-33)[^33] и обязательно сохраните все изменения. (см. примеры ниже)
Примеры текста для верификации личности на разных языках
\##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.\
\##
* [После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "*Пройти верификацию*" напротив поля "*Проверка личности*". При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображения для верификации. ](#user-content-fn-34)[^34]
#### Верификация валюты
{% hint style="info" %}
Ручная верификация валюты включается в настройках валюты и **позволяет запросить у клиента только одно изображение**. \
Инструкцию по созданию и настройке валюты вы можете найти тут: [Валюты](/obmen/valyuty.md)
* **Данный тип верификации можно использовать для верификации банковской карты клиента.**
* **Верификация "Валюты А" будет запрашиваться во всех направлениях, в которых клиент отдает обменному сервису "Валюту А".**
* Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: [/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata "mention")
{% endhint %}
* [Перейдите в админ панель - вкладка "*Валюты*" - "*Настройка валют*" - нажмите "*Изменить*" в поле нужной валюты](#user-content-fn-35)[^35].
* [В настройках валюты перейдите к шагу "*Другие настройки*" - нажмите "*Включить*" напротив поля "*ВЕРИФИКАЦИЯ*"](#user-content-fn-36)[^36].
* [В поле редактора текста введите текст с инструкцией для прохождения верификации](#user-content-fn-37)[^37] (см. пример ниже) и обязательно сохраните изменения
Пример текста для верификации банковской карты
\##ru## \
Для того, чтобы верифицировать виртуальную карту Вам необходимо сделать следующие шаги:
1. **Необходимо сделать скриншот из Вашего личного кабинета (в банкинге), на котором должно быть видно**:\
\- 4 последние цифры номера карты\
\- срок действия карты
2. **Сделать фото на котором будет написано ФИО, дата и подпись владельца карты, а также видна виртуальная карта с банкинга.**
3. Загрузить фото в поле верификации валюты.
\
Для того чтобы верифицировать физическую карту:
1. Возьмите белый лист бумаги.
2. Расположите на листе банковскую карту так, чтобы было видно номер карты и дату.
3. Карта и ее тень должны быть видны полностью.
4. Напишите от руки название сервиса "yourExchangerName".
5. Поставьте дату и подпись.
6. Сфотографируйте и загрузите изображение.
7. Готово!\
\##
* После проделанных действий, на клиентской части на этапе оплаты заявки появится [кнопка "*Пройти верификацию*" напротив поля с названием валюты](#user-content-fn-38)[^38]. [При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображение для верификации.](#user-content-fn-39)[^39]
[^1]: 
[^2]: 
[^3]: 
[^4]: 
[^5]: 
[^6]: 
[^7]: 
[^8]: 
[^9]: 
[^10]: 
[^11]: 
[^12]: 
[^13]: 
[^14]: 
[^15]: 
[^16]: 
[^17]: 
[^18]: 
[^19]: 
[^20]: 
[^21]: 
[^22]: 
[^23]: 
[^24]: 
[^25]: 
[^26]: 
[^27]: 
[^28]: 
[^29]: 
[^30]: 
[^31]: 
[^32]: 
[^33]: 
[^34]: 
[^35]: 
[^36]: 
[^37]: 
[^38]: 
[^39]: 