# Выплаты whitebit
## Поддерживаемые валюты
* Банковские карты: EUR, USD, KTZ, UAH (*временно недоступно*)
* Криптовалюты: BTC, ETH, LTC, USDT...
## Установка модуля
Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [install-plugin](https://manual.boxexchanger.net/dopolnitelnye-sistemy/install-plugin "mention").
Параметры для 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-прокси на вашем сервере, вы можете воспользоваться инструкцией: [ustanovka-socks5-proksi](https://manual.boxexchanger.net/dlya-razrabotchikov/ustanovka-socks5-proksi "mention").
{% 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" %}
Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: [#2.-verifikaciya-rekvizitov-vyplata](https://manual.boxexchanger.net/valyuty/verifikaciya#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]: 
---
# 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/vyplaty-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.