# Мерчант Okipays

{% stepper %}
{% step %}

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

Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [install-plugin](https://manual.boxexchanger.net/dopolnitelnye-sistemy/install-plugin "mention").

<details>

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

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

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

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

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

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

</details>
{% endstep %}

{% step %}

## Настройка мерчанта

{% hint style="info" %}
В случае, если вы уже зарегистрировались в Okipays и добавили мерчант в ЛК Okipays, то перейдите на страницу настроек мерчанта в ЛК Okipays и начните с шага 5.
{% endhint %}

1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в Okipays по [**ссылке**](https://okipays.com/sign-up) -> войдите в ЛК.
2. В ЛК Okipays, перейдите на страницу "**Settings**" - раздел "**Merchant**" -> нажмите "[**Add merchant**](#user-content-fn-2)[^2]".
3. В админ панели скрипта BoxExchanger, зайдите на страницу "**Мерчант и API"** - раздел "**Merchant system**" -> нажмите на [**значок настроек**](#user-content-fn-3)[^3] мерчанта Okipays -> на странице настроек мерчанта, скопируйте значение "[**IPN URL**](#user-content-fn-4)[^4]".
4. Вернитесь в ЛК Okipays на страницу добавления мерчанта из шага 2 -> в поле "**Name**" укажите название мерчанта ->  в поле "**Home URL**" укажите ссылку на ваш сайт в формате <mark style="color:orange;">**`https://www.exchanger.com`**</mark> -> поставьте галочку напротив поля "**Generate API credentials**" -> в поле "**Result URL**" укажите ссылку IPN URL из шага 3-> справа снизу нажмите "[**Create merchant**](#user-content-fn-5)[^5]".
5. После создания мерчанта из шага 4, на странице настроек мерчанта скопируйте значения "**Token**" и "**Secret**" в надежное место.
6. Вернитесь в админ панель скрипта BoxExchanger, на страницу настроек мерчанта Okipays из шага 3 -> в поле "**API Token**" укажите скопированное значение "**Token**" из шага 4 -> нажмите "**Save**" -> в поле "**API Secret**" укажите скопированное значение "**Secret**" из шага 4 -> нажмите "**Save**".
   {% endstep %}

{% step %}

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

* **Redirect Link or Display Address** - настройка способа отображения адреса при оплате.&#x20;
  * **Redirect link** - на странице оплаты заявки будет отображаться кнопка "[**Перейти к оплате**](#user-content-fn-6)[^6]" и клиента будет перенаправлять на страницу оплаты Okipays, на которой будет отображаться адрес для депозита. Пример на [**скриншоте**](#user-content-fn-7)[^7].&#x20;
  * **Display Address** - адрес будет отображаться на странице оплаты заявки. Пример на [**скриншоте**](#user-content-fn-8)[^8].
* **Auto Convert** - настройка автоконвертации валюты приема.&#x20;
  * **USDT** - после зачисления депозита на баланс Okipays, валюта приема будет автоматически конвертирована в USDT.
  * **USDC** - после зачисления депозита на баланс Okipays, валюта приема будет автоматически конвертирована в USDC.
  * none - после зачисления депозита на баланс Okipays, валюта приема не будет конвертироваться.
* **Show Network** - настройка отображения поля с названием сети на странице оплаты заявки. Данная настройка работает только при условии, если для способа отображения адреса выбрана опция **Display Address**.&#x20;
  * **Yes** - название сети отображается отдельным полем. Пример на [**скриншоте**](#user-content-fn-9)[^9].\
    Особенность отображения: название сети будет показано только для токенов (USDT BEP20, USDT TRC20 и т.д), но для коинов (TRX, BNB) сеть не отображается.
  * **No** - название сети не будет отображаться отдельным полем.&#x20;
* **Debug log** - передача дополнительных логов команде BoxExchanger.  В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger.
  {% endstep %}
  {% endstepper %}

[^1]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FY6qJkFYx2LKsktUWBblw%2Fimage.png?alt=media\&token=0a18a9f3-fe88-459b-83dd-a4ad4ffeb44c)

[^2]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FaIzCydz33WuwuxPTU7To%2Fimage.png?alt=media\&token=c254d531-3d37-4994-9c1a-0993bd524512)

[^3]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FrVCWlAqTWBGOduMR9ddx%2Fimage.png?alt=media\&token=73b49673-8f23-4ebd-a39f-006f1e69614c)

[^4]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FRVpgcUV1p9bOBLnk3CJv%2Fimage.png?alt=media\&token=aba11bf4-1332-4c54-ab06-908eaa604dd3)

[^5]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FWKoJQWuTRHi3y3CBDq0F%2Fimage.png?alt=media\&token=6b92ae9a-de85-483f-a4e9-42c7f629019f)

[^6]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FU7LhFyl68WErmdfwZpd7%2Fimage.png?alt=media\&token=45518caf-8368-4bdf-8f88-e0f4906e656d)

[^7]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FDNeprcJhUICcEVHjgBvV%2Fimage.png?alt=media\&token=d019191c-1137-4802-aa1d-f8037baac222)

[^8]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FrUZ9oprMk4EvJ2PewocM%2Fimage.png?alt=media\&token=e21ebe2c-af7b-4f97-a8c5-480669adb860)

[^9]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FPT4PTVvDsRQ7c1xprp6f%2Fimage.png?alt=media\&token=25d69b1c-8994-4abd-9a39-548e2d7f503f)
