> For the complete documentation index, see [llms.txt](https://lara-script.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lara-script.gitbook.io/docs/ua/funkcional-admin-paneli/zagalni/avtoviplati/oasis.md).

# Oasis

**Інструкція з додавання автоплатежів Oasis в адмін-панелі Lara Script**

Процес підключення автоплатежів Oasis простий і займає 5–10 хвилин. Пропонуємо вашій увазі покроковий гайд:

**Крок 1: Підготовка даних**

* Зареєструйте акаунт на Oasis ([oasis-crypto.com](https://oasis-crypto.com))

<figure><img src="/files/5d23357d60e8281082218e0ea1090dd65d8a7920" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/0efd2172688850163fe040890dd98020bf1646bd" alt="" width="375"><figcaption></figcaption></figure>

* Після входу в особистий кабінет створіть організацію в розділі "Організації"

<figure><img src="/files/SolBUASiGr6tXaXoFR4M" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/gJSWetNkFZiGEiWGZdHD" alt=""><figcaption></figcaption></figure>

Заповнюючи поле **Webhook URL** в кінці посилання вкажіть /notification/oasis, щоб посилання виглядало приблизно так - <https://demo.lara-script.com/notification/oasis>

* Далі вам потрібно створити API-ключі для раніше створеної організації, це необхідно зробити в розділі "API ключі організації"

<figure><img src="/files/42mYCJ5Hdpk09z1SRmiU" alt=""><figcaption></figcaption></figure>

Створюючи API-ключ організації, ви обов'язково повинні налаштувати дозволи для типів операцій, включно з дозволом на виведення, якщо ви хочете використовувати автоплатежі за цими ключами

<figure><img src="/files/eb2021406959bacc71a3a9c3e18e3a36bedad3d3" alt="" width="563"><figcaption></figcaption></figure>

Після створення організацій у вас з’являться гаманці в розділі Гаманці - Основні гаманці, де ви зможете зберігати кошти для майбутніх автоплатежів

**Крок 2: Перехід у розділ в адмін-панелі**

* Увійдіть в адмін-панель Lara Script.
* Перейдіть у "Загальні" > "Автоплатежі" > "Oasis".

<figure><img src="/files/67a6659eaabc7d90654e62223b5488ea8d0ac682" alt=""><figcaption></figcaption></figure>

**Крок 3: Заповнення полів**

Заповніть форму в адмін-панелі. Ось як це зробити крок за кроком:

* **API key:** Тут вам потрібно вставити API-ключ організації Oasis (наприклад, KaxRJdnOla45IidRdR8jJjqO3YvWw3zAl), який ви отримали на етапі 1 цієї інструкції.
  * Порада: Перевірте ключ на помилки — він має бути унікальним і не містити пробілів.

<figure><img src="/files/5hcluXAi82udrR0OZqEX" alt=""><figcaption></figcaption></figure>

* **Organization id:** Тут вам потрібно вставити унікальний ID організації Oasis (наприклад, oWmGJtHN8dD1TVjfx1gwQbd5fckghZtF), який ви також отримали на етапі 1 цієї інструкції.

<figure><img src="/files/VD3Wk76TDU62PI3ykpWE" alt=""><figcaption></figcaption></figure>

**Приклад заповнених полів:**<br>

<figure><img src="/files/yeIFcODYoo149hoZTSlL" alt=""><figcaption></figcaption></figure>

**Крок 4: Збереження та тестування**

* Натисніть "Зберегти" внизу форми.
* У полі "Виводи" (на сторінці створення/редагування напряму) натисніть "Додати рядок" і виберіть значення "Oasis".

<figure><img src="/files/de5327c6bae22876f6a9fc777578b82362f1f05a" alt=""><figcaption></figcaption></figure>

Налаштуйте граничні значення мінімальної та максимальної суми обміну для спрацьовування автоплатежів, ліміти налаштовуються для валюти "Віддаю".

* Перевірте інтеграцію: Створіть тестову заявку і оплатіть її, чи оновлюються статуси автоматично (Нова заявка - Очікування підтвердження - Оплачена - Очікування підтвердження від модуля автоплатежів - Виконана)
  * Якщо депозит буде на суму меншу/більшу, ніж вказано в заявці, тоді така заявка отримає статус "На перевірці" і кошти не будуть відправлені автоматично. У такому випадку вам потрібно буде здійснювати таку виплату вручну, натискаючи кнопку "Запустити автоплатіж" і вводячи код ручного виведення, який ви налаштовуєте самостійно в розділі **Налаштування адміністратора** - **Код підтвердження для ручного виведення**

<figure><img src="/files/Ne6ZvXl3Y3PZSoXu9nIw" alt="" width="375"><figcaption></figcaption></figure>

**Крок 5: Запобіжник переплати USDT на виплату**

Іноді при автовиплаті може виникнути ситуація, коли на виплату йде більше USDT, ніж надійшло за заявкою на вхід (наприклад, через різкий стрибок курсу конвертації між мережами). Щоб уникнути таких випадків, у налаштуваннях додано блок **«Payout overspend safeguard»** — запобіжник, який перевіряє відхилення перед підтвердженням виплати та, за потреби, блокує її.

**Поля блоку:**

* **Payout overspend safeguard** — перемикач \[ON]/\[OFF].
  * **ON** — запобіжник активний: система перевірятиме кожну виплату на відхилення і блокуватиме її при перевищенні допустимих порогів.
  * **OFF** — перевірка вимкнена, виплати проходять без обмеження за відхиленням (як було раніше).
* **Allowed payout deviation, %** — максимально допустиме перевищення суми USDT, витраченої на виплату, над сумою USDT на вході заявки, у відсотках від суми входу. Значення за замовчуванням — **0.1%**.
* **Allowed payout deviation, USDT** — максимально допустиме перевищення в абсолютному значенні USDT. Значення за замовчуванням — **10 USDT**.

Обидва параметри працюють одночасно: запобіжник спрацьовує, якщо відхилення перевищує **хоча б один** із двох порогів (відсоток **або** абсолютне значення). Якщо фактичне відхилення вкладається в обидва ліміти — виплата проходить у звичайному режимі, без будь-яких затримок.

**Що відбувається при спрацьовуванні запобіжника:**

* виплата блокується до ручного підтвердження — гроші автоматично не надсилаються;
* заявка залишається в статусі **«Оплачена»** (не переходить у «Виконана»);
* у Telegram приходить сповіщення з деталями конвертації та відхилення, наприклад:

```
⚠️ #44798 Автовиплата Oasis зупинена
15 Tether TRC20(USDT) -> 0.01949985 Ethereum ERC20(ETH)
USDT на вході: 15 | USDT на виході: 35.64
Відхилення: 20.64 USDT (137.6%)
Курс Oasis: 1827.3315268523906818
```

> Для отримання цих сповіщень має бути налаштовано [плагін сповіщень Telegram](https://lara-script.gitbook.io/docs/ua/funkcional-admin-paneli/plagini/telegram-notification). Якщо плагін не налаштовано, запобіжник і надалі блокуватиме підозрілі виплати, але сповіщення в Telegram надсилатися не будуть.

Після спрацьовування запобіжника заявку потрібно обробити вручну — так само, як і у випадку невідповідності суми депозиту: натиснути кнопку **«Запустити автоплатіж»** і ввести код мануального виведення (налаштовується в розділі **Налаштування адміністратора** — **Код підтвердження для мануального виведення**) або здійснити переказ вручну та перевести заявку у **Виконана**.

**Важливо**

Під час надсилання виплати система автоматично обирає найменше з двох значень точності: підтримуване Oasis і вказане в налаштуваннях напряму.

* Якщо Oasis підтримує 6 знаків після коми, а в напрямі вказано 8 — виплата буде надіслана з точністю до 6 знаків.
* Якщо Oasis підтримує 6 знаків після коми, а в напрямі вказано 5 — виплата буде надіслана з точністю до 5 знаків.

Це виключає помилки під час надсилання, які раніше могли виникати, якщо точність у напрямі перевищувала допустиму Oasis.