# WhiteBit

**Инструкция по добавлению мерчанта WhiteBit (или подобного) в админ-панели Lara Script**

Процесс подключения мерчанта WhiteBit прост и занимает 5–10 минут. Это позволяет автоматизировать обмены крипты/фиата через API WhiteBit. Если мерчант аналогичен, процесс сходный — вы заполняете ключи и настройки. Вот пошаговый гид:

**Шаг 1: Подготовка данных**

* Зарегистрируйте аккаунт на WhiteBit (whitebit.com) и создайте API-ключи в разделе "API" (требуется верифицированный корпоративный аккаунт для обменов).

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FotXSep0y9CCBKtI8yqDS%2Fimage.png?alt=media&#x26;token=22e06440-9c11-428d-bcb4-01d90815053c" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FrWXrwoRir9K06FMzpoWq%2Fimage.png?alt=media&#x26;token=ba62ac39-1383-415d-be9c-3752421d0084" alt="" width="305"><figcaption></figcaption></figure>

* Получите 4 ключа: Public key, Secret key, Webhook public key, Webhook secret key (генерируются в личном кабинете WhiteBit).
* Подготовьте настройки: статусы заявок для автообработки (например, "новая", "удалена", "отклонена").

**Совет для новичков**: Если у вас нет API-ключей, перейдите на WhiteBit > Профиль > API > Создать ключ. Включите разрешения на чтение/запись для торговли и выплат.

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FCTToKCKRuFQChM2j3Apq%2Fimage.png?alt=media&#x26;token=787adf28-c9fe-42bc-a882-f19c56be48e1" alt="" width="563"><figcaption></figcaption></figure>

Для корректной настройки мерчанта WhiteBit и Telegram-ботов вам необходимо включить вебхук в личном кабинете WhiteBit.\
• Укажите адрес вебхука: [**http://\*название Вашего сайта\*/notification/whitebit**](http://nextbit.me/notification/whitebit)\
• Далее в настройках мерчанта добавьте ключи **"Webhook public key"** и **"Webhook secret key"**.\
• После заполнения этих полей вам нужно пройти верификацию домена — для этого выберите способ через запрос к эндпоинту **/whiteBIT-verification**.\
\
**Для того, чтобы данный мерчант работал корректно в будущем как метод для автовыплат, необходимо выбирать следующий список разрешений**<br>

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FINaW5Z05PieLer1YyOET%2Fimage.png?alt=media&#x26;token=ac20a4de-adc0-4be7-b3eb-ad395b6bcabc" alt="" width="309"><figcaption></figcaption></figure>

\
**Шаг 2: Переход в раздел в админке**

* Войдите в админ-панель Lara Script.
* Перейдите в "Мерчанты" > "WhiteBit" (или аналогичный раздел для других мерчантов).
* Если мерчант не в списке, обратитесь в нашу техподдержку, и мы оперативно рассмотрим возможность его добавления.

**Шаг 3: Заполнение полей**

Заполните форму в админке. Вот как это сделать шаг за шагом:

1. **Public key**\*: Вставьте публичный ключ из WhiteBit API (например, d4afjd642a7e3bdd3ee1e346xzfjknzd08). Это ключ для аутентификации запросов на чтение (курсы, балансы).
   * Совет: Проверьте ключ на ошибки — он должен быть уникальным и не содержать пробелов.
2. **Secret key**\*: Вставьте секретный ключ. Он нужен для подписи запросов на выплаты/торговлю. Не делитесь им!
   * Совет: Храните секретный ключ в защищённом месте (например, в менеджере паролей). Если потеряете, генерируйте новый на WhiteBit.
3. **Webhook public key**\*: Вставьте webhook публичный ключ (например, d0d642a7e3bdd3ee1e346e0e088e08). Для верификации входящих webhook-запросов от WhiteBit (статус транзакций).
   * Совет: Включите webhook на WhiteBit в разделе API > Webhooks, указав URL вашего сайта.
4. **Webhook secret key**\*: Вставьте webhook секретный ключ. Для подписи входящих запросов.
5. **Выберите статус заявок для автоматической обработки**\*: Выберите статусы из выпадающего списка (например, "Новая", "Ожидает подтверждения"). Это определяет, когда система автоматически обрабатывает заявки.
   * Совет: Начните с "Новая" и "Ожидает подтверждения" для тестов. Если мерчант — Payeer, статусы похожи, но без webhook.
6. **Временной интервал для генерации WhiteBit-кодов**\*: Укажите интервал (например, 22:00). Это период для генерации кодов обмена..

**Шаг 4: Сохранение и тестирование**

* Нажмите "Сохранить" внизу формы.
* Проверьте интеграцию: Создайте тестовую заявку и проверьте, обновляются ли статусы автоматически, генерируется ли автоматически адрес для оплаты и корректен ли он.

**Предупреждения по безопасности**: Никогда не делитесь ключами. Если подозреваете утечку, генерируйте новые на WhiteBit и обновите в админке. Для других мерчантов (как Payeer) — аналогично, но с дополнительной верификацией аккаунта.

**Совет для арендаторов**: Если арендуете админку, мы предоставим готовые шаблоны ключей и бесплатную помощь с настройкой.\
Также, если сгенерированные API не будут использованы в течение 2 недель после их генерации на стороне WhiteBit, такие ключи будут деактивированы до повторной активации

#### Обновление логики обработки депозитов (WhiteBit)

В последнем обновлении была изменена логика обработки депозитов для заявок, в которых мерчантом выступает **WhiteBit**.

Теперь, если по заявке поступает **нецелевая валюта** (например, заявка создана на USDT, а фактически зачислен USDC), применяется следующая логика обработки:

* На этапе подтверждения депозита заявка ведёт себя стандартно:\
  при поступлении транзакции заявка остаётся в статусе **«Ожидает подтверждения»**, аналогично случаям с целевой валютой.
* После получения депозитом всех необходимых подтверждений, если валюта депозита не соответствует валюте заявки, заявка автоматически переводится в статус **«На проверке»**.
* В интерфейсе оператора возле поля с хэшем транзакции отображается **предупреждающий индикатор (жёлтый треугольник)**, сигнализирующий о необходимости ручной проверки заявки.

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FfIXWwmr7klCH3aOg2vp6%2Fimage.png?alt=media&#x26;token=f09c7d31-8602-42ee-a629-8ccb6567b70a" alt=""><figcaption></figcaption></figure>

Данное изменение позволяет оперативно выявлять и обрабатывать заявки, по которым был зачислен депозит в некорректной валюте.