# Мерчант 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]: 
---
# Agent Instructions: 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:
```
GET https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/merchant-whitebit.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.