> 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/merchant-wellwallet.md).

# Мерчант WellWallet

## Установка мерчанта

Установите мерчант через **Install plugin** по [инструкции](/dopolnitelnye-sistemy/install-plugin.md).

<details open>

<summary>Параметры для Install plugin</summary>

**Plugin type:** <mark style="color:orange;">**`Merchant module`**</mark>

**Plugin URL:** <mark style="color:orange;">**`@boxexchanger-plugins/merchant-wellwallet`**</mark>

**Directory path:** <mark style="color:orange;">**`wellwallet`**</mark>

**Auth (Deploy token):** оставьте пустым

**Package tag:** <mark style="color:orange;">**`latest`**</mark>

</details>

После установки перезапустите процесс `exchanger-api-http`.

## Конфигурация

1. Откройте [Telegram-бот WellWallet](https://telegram.me/wellwallet?start=r__id-6061441678) и нажмите **START**.
2. Перейдите в **Настройки** → **Безопасность** → **2FA**. Включите двухфакторную аутентификацию, следуя подсказкам бота.
3. Откройте **Настройки** → **API** → **Управление API ключами**. Введите код 2FA и нажмите **Создать API-ключ**.
4. Укажите название ключа и подтвердите создание кодом 2FA. Скопируйте API-ключ и сохраните его в защищённом месте.
5. В админ-панели BoxExchanger откройте **Мерчант и API** → **MERCHANT SYSTEM** → настройки WellWallet.
6. Вставьте API-ключ, из шага 4, в поле **API Key (token)** и нажмите **Save**.
7. Скопируйте IP-адрес из раздела **IP SERVER** и ссылку из поля **Webhook URL**.
8. Отправьте IP-адрес в поддержку WellWallet. Сервис активирует доступ к API после подтверждения.
9. В Telegram-боте откройте **Настройки** → **API** → **Управление webhook** → **Создать вебхук**.
10. Отправьте **Webhook URL**, скопированный в шаге 7, и подтвердите действие кодом 2FA. Успешное создание подтверждает сообщение `✅ Вебхук создан`.
11. Выберите WellWallet для приёма поддерживаемых валют.

{% hint style="info" %}
Сохраните API-ключ сразу после создания. Не передавайте его третьим лицам.
{% endhint %}

Мерчант настроен.

## Дополнительные настройки

* **Show QR** — показывает депозитный адрес в виде QR-кода. Выберите **Yes** или **No**, затем нажмите **Save**.
* **Debug log** — передаёт расширенные логи команде BoxExchanger. Включайте **Yes** только для диагностики.
* **Over paid limit in %** — допустимый процент переплаты клиента. Например, `1` разрешает переплату до 1%. Превышение переводит заявку в статус [«Ошибка оплаты»](/zayavki/zayavki/statusy-zayavki.md#oshibka-oplaty). С модулем [Approve underpaid orders](/dopolnitelnye-sistemy/approve-underpaid-orders.md) заявки автоматически пересчитываются в пределах заданного лимита.