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

# Мерчант Oasis

Инструкция по настройке мерчанта Oasis

{% stepper %}
{% step %}

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

Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [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-oasis`**</mark>

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

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

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

</details>
{% endstep %}

{% step %}

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

{% hint style="info" %}
В случае, если вы ранее уже настраивали модуль выплаты Oasis и у вас уже создана организация, а также сохранен Webhook Key, то переходите к шагу 2.

ID организации и Webhook Key вы можете найти в ЛК Oasis на странице "**Организации**" - кнопка "[**Предпросмотр**](#user-content-fn-1)[^1]" в поле с вашей организацией -> на странице настроек организации будут указаны [**значения ID и Webhook Key**](#user-content-fn-2)[^2]
{% endhint %}

1. [Зарегистрируйтесь](https://app.oasis-crypto.com/admin/register) и [войдите](https://app.oasis-crypto.com/admin/login) в ЛК Oasis -> перейдите на страницу "[**Организации**](#user-content-fn-3)[^3]" -> нажмите "[**Добавить организацию**](#user-content-fn-4)[^4]" -> на открывшейся странице, заполните поля "**Название**" и "**Вебсайт**" -> нажмите "[**Сохранить и предпросмотр**](#user-content-fn-5)[^5]" -> на странице организации [**скопируйте**](#user-content-fn-6)[^6] в надежное место "**ID**" и "**Webhook Key**" (**эти данные также понадобятся при настройке модуля выплаты**).
2. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**MERCHANT SYSTEM**", нажмите на значок настроек в блоке с мерчантом Oasis. \
   На странице настроек мерчанта Oasis, в поле "**Organization Id**" укажите значение "**ID**" из шага 1 и нажмите "**Save**" -> в поле "**Webhook Key**" укажите значение "**Webhook Key**" из шага 1 и нажмите "**Save**" -> скопируйте "[**Public IP**](#user-content-fn-7)[^7]".
3. Вернитесь в ЛК Oasis и перейдите на страницу "**Огранизации**" - "[**API ключи организации**](#user-content-fn-8)[^8]" -> нажмите "[**Добавить ключ организации**](#user-content-fn-9)[^9]" -> на открывшейся странице, для поля "**Организация**" выберите имя организации, которую вы создали на шаге 1 -> активируйте ползунок для "**Включено**" -> в разделе "**Разрешения**" выберите "**Депозит**" -> в разделе "**IP Whitelist**" нажмите "**Добавить IP адрес**" и укажите значение "**Public IP**" из шага 2 в поле ввода IP -> нажмите "[**Сохранить и выйти**](#user-content-fn-10)[^10]" -> скопируйте "[**API ключ**](#user-content-fn-11)[^11]" в надежное место.
4. В админ панели скрипта, на страницие настроек мерчанта Oasis, в поле "**API Key**" укажите значение "**API ключ**" из шага 3 и нажмите "**Save**".
   {% endstep %}

{% step %}

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

* **Show QR-code** - отображение QR-кода с адресом для оплаты. Для отображения QR-кода, выберите значение "**Yes**" -> нажмите "**Save**".
* **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%2FZMiBVQxVHOOHcQeW8WbK%2Fimage.png?alt=media\&token=212e6aa1-014a-4f3b-9d7f-c4937b2e5131)

[^2]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F6vEWrNxyvNte3EyqwRs8%2Fimage.png?alt=media\&token=0b90da84-7820-4ec1-8138-1c8a21a38a85)

[^3]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FqwbpRRZiOKcTkHF8WouV%2Fimage.png?alt=media\&token=d5462711-c119-44e3-a12c-190c911a23a0)

[^4]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FfC7VsZZOW1gSAZlr8E4A%2Fimage.png?alt=media\&token=809a3a00-ad0f-4dcb-a6cf-5abb1d8df112)

[^5]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FfXBpa9gCdSt1UGvnFE2o%2Fimage.png?alt=media\&token=9ab75512-2126-4f23-8e7c-9eb250245108)

[^6]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2For7Hzk5Xou3rOJd4CSoj%2Fimage.png?alt=media\&token=ca2dba93-957b-44e9-94f7-2a525a9f7ad6)

[^7]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FJPcidzyYsSFWcNXl8N5O%2Fimage.png?alt=media\&token=8e225a33-dd2e-421e-b985-255449e9ea77)

[^8]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FlASPQvGRvORU8A1oQHyj%2Fimage.png?alt=media\&token=65c34683-3a2e-4712-911f-b4b04337a814)

[^9]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FgvUMsDxDmx0f9GiDspnf%2Fimage.png?alt=media\&token=191875d9-6496-4e2b-88fd-384b02b3b040)

[^10]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FSXiFEChUPwBg7fD8jwWN%2Fimage.png?alt=media\&token=8f6e034c-7367-4641-9c4f-ba53116c261b)

[^11]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Fm1GFh6lImjrlJeXpLQzT%2Fimage.png?alt=media\&token=2cbbf70f-9dcb-4afc-8a06-5907693693a7)
