> 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

Установка и настройка мерчанта 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) заявки автоматически пересчитываются в пределах заданного лимита.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://manual.boxexchanger.net/obmen/merchant-i-api/merchant-wellwallet.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.