> 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/vyplaty-whitebit.md).
# Выплаты whitebit
## Поддерживаемые валюты
* Банковские карты: EUR, USD, KTZ, UAH (*временно недоступно*)
* Криптовалюты: BTC, ETH, LTC, USDT...
## Установка модуля
Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin.md).
Параметры для Install Plugin
**Plugin type**: **`Payout module`**
**Plugin URL**: **`@boxexchanger-plugins/payout-whitebit`**
**Directory path**: **`whitebit`**
**Auth: (Deploy token)**: оставляем пустым
**Package tag**: **`latest`**
## Регистрация и подготовка аккаунта whitebit
{% hint style="success" %}
В случае, если вы еще не зарегистрированы на whitebit - [Зарегистрируйтесь](https://whitebit.com/referral/27d3a06d-9f07-4753-a1e0-257c9817b26e) на бирже - пройдите верификацию личности - включите 2FA.
{% 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/withdraw`\
`/api/v4/main-account/withdraw-pay`
Раздел "**Перевод между балансами**"\
`/api/v4/main-account/transfer`
Раздел "**Баланс и история кошелька**"\
`/api/v4/main-account/balance`\
`/api/v4/main-account/history`\
`/api/v4/main-account/fee`
Раздел "**Торговый баланс и история ордеров**"\
`/api/v4/trade-account/balance`
Раздел "**Управление ордерами**"\
`/api/v4/order/market`\
`/api/v4/order/stock_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**" - раздел "**PAYOUT 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**" - раздел "**PAYOUT 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. [**Withdraw method**](#user-content-fn-10)[^10] - выбор особенностей вывода средств. \
\- **/api/v4/main-account/withdraw** - комиссия за вывод будет вычтена из конечной суммы, которую получит клиент (**не рекомендуется**)\
\- **/api/v4/main-account/withdraw-pay** - комиссия за вывод будет вычтена из вашего баланса, а клиент получит сумму, которая обозначена в заявке (**рекомендуемый параметр**)
5. Вы можете настроить функционал "[**Withdraw from**](#user-content-fn-11)[^11]". В зависимости от выбранного параметра будет зависеть процесс получения валюты для вывода клиенту по заявке.
{% hint style="info" %}
**DIRECT** - прямой вывод валюты без обмена. К примеру, если необходимо вывести BTC, то у вас на балансе whitebit должен быть резерв BTC. Для LTC - резерв LTC на балансе и т.д.
**USDT/USDC/EUR/BTC/ETH** - использование указанной валюты для получения валюты, которую должен получить клиент по заявке. К примему, клиент должен получить DOGE, для поля "**Withdraw from**" выбрано "**USDT**" - в таком случае у вас на балансе должен быть резерв USDT, за который в паре DOGE/USDT будет куплен нужный объем DOGE. \
Обычно выбирается "**USDT**".
{% endhint %}
{% hint style="warning" %}
Также обратите внимание, что **валюта в которую будет производиться авто конвертация (***"**Convert to" в настройках мерчанта*****) и валюта из которой будет происходить выплата (*****"Withdraw from" в настройка модуля выплат*****) должны совпадать для автоматизации процесса.**
{% endhint %}
{% hint style="info" %}
Обратите внимание, что в парах Currency/USDT будет использоваться buy stock market order, то есть будет выставляться ордер на покупку точной суммы Currency, которую необходимо вывести клиенту + комиссия за вывод Currency. То есть в таких парах мы считаем, что Currency - это stock, а USDT - money. Например, BTC (stock) / USDT (money).
Однако, в парах USDT/Currency будет использоваться обычный sell market order. Это обозначает, что будет выставляться одрер на продажу USDT + 0.3% проскальзывание по стакану (так как мы не можем знать точную среднюю стоимость закупки) + комиссия за вывод Currency. Например, USDT (stock) / EUR (money).
{% endhint %}
### Дополнительные настройки
* [**Fee method**](#user-content-fn-12)[^12] - в случае, если у вас персональные комиссии на whitebit, то указывайте параметр "**Private**". По умолчанию выставлено "Public", то есть стандартные комиссии.
* Настройка вывода запроса полей имени и фамилии для фиат валют (**Type request name surname (for FIAT)**)\
\- [**Compact**](#user-content-fn-13)[^13] - компактный режим запроса имени и фамилии. В данном случае, у клиента мы запросим в [одном поле](#user-content-fn-14)[^14] сразу и имя и фамилию. Данный параметр делает форму обмена более компактной и удобной для клиента. Однако, такой режим может затруднить обмен для людей которые имеют двойное имя или фамилию. \
\- [**Full** ](#user-content-fn-15)[^15]- отображение [раздельных полей](#user-content-fn-16)[^16] для ввода имени и фамилии. Если вы планируете работать с клиентами у которых может быть двойное имя и/или вам нужно чтобы клиент вводил 2 отдельных поля "Имя", "Фамилия" - вам подойдет данный вариант.
* [**Type request Memo**](#user-content-fn-17)[^17] - способ передачи memo, а также выбор того обязательно ли поле memo для заполнения. \
\- По умолчанию выставлен рекомендуемый параметр, а именно "**required from user**". То есть поле memo обязательное для заполнения. \
\- **optional empty** - в таком случае поле memo необязательное для заполнения. При выводе с whitebit, memo не будет передаваться.\
\- **optional with default "12345"** - в таком случае поле поле memo необязательное для заполнения. При выводе с whitebit, будет передаться memo "12345".
* [**Enable debug mode**](#user-content-fn-18)[^18] - значение "1" включает отправку дополнительных логов для разработчиков. Может быть полезно для анализа логов при возникновении трудностей с модулем. Без крайней необходимости рекомендуем не включать и оставить значение "0".
### Проксирование запросов
{% 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-19)[^19]".
## Выплата фиатных валют
{% hint style="success" %}
Для работы с фиатными валютами - обратитесь в поддержку whitebit с запросом активации фиатного шлюза для необходимой валюты.
{% endhint %}
{% hint style="warning" %}
**Внимание!** Для выплаты **EUR,USD** в настройке данных направлений - шаг "**Отображение полей**" - обязательно включите созданное по-умолчанию поле "E-mail". \
Со стороны whitebit требование запрашивать от клиента ввод Email адреса.
{% endhint %}
### Верификация
* Требования по верификации вы всегда можете уточнить у представителей whitebit
### Верификация валюты (выплаты)
{% hint style="info" %}
Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: [/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata "mention")
{% endhint %}
[^1]: 
[^2]: 
[^3]: 
[^4]: 
[^5]: 
[^6]: 
[^7]: 
[^8]: 
[^9]: 
[^10]: 
[^11]: 
[^12]: 
[^13]: 
[^14]: 
[^15]: 
[^16]: 
[^17]: 
[^18]: 
[^19]: 