> 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/parser-kursov/wepay.md).

# WePay

Инструкция по настройке парсера WePay

{% stepper %}
{% step %}

### 1. Установка парсера

Установите парсер через функционал **Install plugin**, используя следующие параметры:

<details open>

<summary>Параметры установки</summary>

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

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

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

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

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

</details>

Подробная инструкция по установке доступна в разделе [Install plugin](https://manual.boxexchanger.net/dopolnitelnye-sistemy/install-plugin.md#parser-rate).
{% endstep %}

{% step %}

### 2. Получение доступа к WePay

{% hint style="info" %}
Если у вас уже есть доступ к личному кабинету WePay, переходите к следующему шагу.
{% endhint %}

1. Обратитесь к представителю WePay в Telegram [t.me/ovpayment01](https://t.me/ovpayment01).
2. Запросите доступ к личному кабинету для настройки модуля в BoxExchanger.
3. При обращении укажите ссылку на сайт вашего обменного пункта.
   {% endstep %}

{% step %}

### 3. Создание API-ключей

1. Войдите в личный кабинет WePay по [ссылке](https://whiteexchange.io/auth/login/).
2. Перейдите на страницу **Настройки** и нажмите **Сгенерировать ключ API**.

<figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FCUVr0NK1tERJaE87bQd7%2Ffile-9f309999ce95b1fe1dacc9161709ebd3.png?alt=media&#x26;token=62684304-d092-4272-861b-c03ca19c1d5d" alt="Настройки WePay"><figcaption></figcaption></figure>

3. В открывшемся модальном окне скопируйте значения **Токен API** и **Секрет** и сохраните их в надёжном месте.

{% hint style="warning" %}
Не закрывайте модальное окно до завершения настройки разрешённых IP-адресов.
{% endhint %}

<figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F6RJa7oTdEEeiUyxK3j3t%2Fimage.png?alt=media&#x26;token=61f60e33-de4d-4444-b501-c11873232494" alt="Создание API-ключа WePay"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 4. Настройка разрешённых IP-адресов

Для работы API необходимо добавить публичный IP-адрес сервера BoxExchanger в список разрешённых IP-адресов WePay.

1. Откройте админ-панель BoxExchanger.
2. Перейдите на страницу **Мерчант и API**.
3. В разделе **MERCHANT SYSTEM** найдите блок с мерчантом WePay и нажмите на значок настроек.
4. На странице настроек мерчанта скопируйте IP-адрес из раздела **Public IP**.

<figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FGtjRq9KD0uwr0t8UBApn%2Fimage.png?alt=media&#x26;token=218b825b-c39c-4688-9276-643ddd0aed1f" alt="Public IP в настройках мерчанта"><figcaption></figcaption></figure>

{% hint style="info" %}
**Альтернативные способы получения IP-адреса**

Публичный IP-адрес сервера также можно найти:

1. В настройках любого мерчанта в админ-панели BoxExchanger: **Мерчант и API** → **MERCHANT SYSTEM** → значок настроек → раздел **PUBLIC IP**.

2. В личном кабинете [BoxExchanger Licenses](https://licence.boxexchanger.net/ru/licenses/) в поле **Back-end server**.
   {% endhint %}

3. Вернитесь в личный кабинет WePay, в открытое ранее модальное окно создания API-ключа.

4. Укажите скопированный IP-адрес в поле **Разрешённые IP** и нажмите **Сохранить**.

<figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FYVtXISdNBHockSDMQHfk%2Fimage.png?alt=media&#x26;token=0520d0fe-3d40-44db-afee-ec8a75638ba5" alt="Настройка разрешённых IP в WePay"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 5. Активация и настройка парсера

1. Откройте админ-панель BoxExchanger и перейдите на страницу **Парсеры**.
2. Найдите парсер **WePay** и нажмите **Больше курсов**.
3. Включите парсер, следуя инструкции [Парсер курсов](https://manual.boxexchanger.net/obmen/parser-kursov.md#konfiguraciya-parsera).

{% hint style="info" %}
Для применения изменений в настройках парсера необходимо подтвердить перезагрузку процессов сервера, если система запросит подтверждение.
{% endhint %}

4. Перейдите на страницу настроек модуля и укажите следующие параметры:

| Параметр    | Значение                                                 |
| ----------- | -------------------------------------------------------- |
| `apiKey`    | **Токен API**, полученный при создании API-ключа в WePay |
| `apiSecret` | **Секрет**, полученный при создании API-ключа в WePay    |
| `symbols`   | `KZT,UAH,USDT`                                           |

5. После заполнения каждого параметра нажмите **Применить изменения**.

{% hint style="info" %}
**Параметр symbols**

Оставьте значение `KZT,UAH,USDT` без изменений. Оно позволяет получать курсы по указанным валютам.
{% endhint %}
{% endstep %}

{% step %}

### 6. Проверка работы парсера

После завершения настройки:

1. Убедитесь, что парсер WePay включён.
2. Перейдите в раздел **Больше курсов** и проверьте, что отображаются полученные курсы.
3. Убедитесь, что курсы обновляются после очередного обновления парсера.
   {% endstep %}
   {% endstepper %}

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

В настройках модуля доступны следующие параметры:

* **API URL** — адрес API WePay, используемый для отправки запросов. Если WePay изменит адрес API, укажите новый URL в этом поле и нажмите **Save**.
* **Интервал (ms)** — интервал выполнения внутренних процессов модуля. Оставляйте значение без изменений. Изменение этого параметра не влияет на частоту обновления курсов.
