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

# Custodex

Інтеграція з **Custodex** дозволяє використовувати провайдера у двох режимах:

1. [**Мерчант**](https://lara-script.gitbook.io/docs/ua/funkcional-admin-paneli/merchanti/custodex) **(прийом платежів)** — автоматичне зарахування коштів від клієнтів
2. **Модуль автовиплат (payouts)** — автоматичне надсилання коштів клієнту

➡️ У комбінації цих режимів можна будувати **повністю автоматичні напрямки обміну**.

### 📌 Можливості інтеграції

* Прийом криптовалют через Custodex (merchant)
* Автоматичні виплати (payout)
* Підтримка великого списку мереж і токенів
* Єдина система ключів для всіх модулів
* Можливість роботи без створення окремих рахунків
* Підтримка фіатних виплат (EUR, USD, CNY, RUB) через конвертацію (опціонально)

### 🔑 Отримання API-ключів

#### Крок 1. Реєстрація

Перейдіть на сайт Custodex:\
<https://custodex.sv/ru>

Створіть акаунт і пройдіть базове налаштування.

#### Крок 2. Отримання ключів

Перейдіть:

**Налаштування → Інтеграції**

Ви отримаєте:

* **Публічний ключ**
* **Приватний ключ**

<figure><img src="/files/359a7f9a505f9a501e6dba00350014228ded7de0" alt=""><figcaption></figcaption></figure>

⚠️ Ці ключі використовуються:

* і для **мерчанта**
* і для **автовиплат**

### 🆔 Отримання UUID мерчанта (ID рахунку)

У Lara Script надалі це поле використовується як:

```
UUID мерчанта
```

#### Як отримати:

1. Перейдіть у Custodex:\
   **Рахунки → Створити рахунок**
2. Укажіть назву
3. Підтвердіть через 2FA
4. Після створення:
   * використовуйте **ID рахунку** як `UUID мерчанта`

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

#### ❗ Важлива примітка

Створення рахунку **не обов'язково**.

Якщо не створювати рахунок:

* усі кошти надходитимуть на **основний баланс акаунта**
* поле `UUID мерчанта` можна залишити порожнім, це працює і для мерчанта, і для автовиплат

### 🔄 Автоматична обробка заявок (автоконвертація + автовиплата)

Інтеграція з Custodex дозволяє налаштувати **повністю автоматичну обробку заявок**, включно з конвертацією та виплатою без участі оператора.

#### ⚙️ Де налаштовується

Перейдіть:

**Операції → Автовиводи**

У цьому розділі можна задати напрямки автоконвертації:

* з вхідної валюти → у стейбл (USDTTRC)
* зі стейбла → у валюту виплати

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

#### 🧠 Як це працює

1. Користувач створює заявку та надсилає кошти
2. Після надходження:
   * усі монети **автоматично конвертуються в USDTTRC**
3. Далі:
   * USDTTRC конвертується у валюту, обрану для виплати
4. Якщо підключена автовиплата:
   * кошти автоматично надсилаються клієнту

👉 У результаті заявка проходить повний цикл **без участі оператора**

#### ⚠️ Важливі особливості

* ⏳ **Автоконвертація може активуватися із затримкою** після першого ввімкнення
* 🏦 Працює **лише для основного рахунку** (для додаткових рахунків не підтримується)

#### 💱 Автоконвертація під час виведення

За недостатності балансу:

* якщо не вистачає потрібної валюти для виплати
* система автоматично:
  * конвертує бракуючу суму з **USDTTRC**

#### 💸 Особливість списання

* під час автоконвертації:
  * може списуватися **приблизно на 30% більше USDTTRC**, ніж потрібно
* це необхідно для:
  * покриття зміни курсу
  * комісій

Після завершення:

* невикористаний залишок **повертається на баланс**

#### 🧩 Результат

* повністю автоматизовані напрямки
* відсутність ручної обробки
* прискорення обробки заявок
* зменшення навантаження на операторів

## ⚙️ Налаштування в Lara Script

### 1. Підключення автовиплат

Перейдіть:

**Адмін-панель → Платіжні системи → Автовиплати**

Створіть новий метод:

#### Заповніть:

* **Публічний ключ**
* **Приватний ключ**
* **UUID мерчанта** *(опціонально)*

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

Перемкніть повзунок "Активний" і збережіть зміни.

### ⚠️ Важливо

* Використовуються **ті самі ключі**, що й для мерчанта
* UUID — використовуйте той UUID, де у Вас попередньо зберігатиметься баланс, Ви можете вільно використовувати ті самі ключі, що й для мерчанта **(якщо використовується)**

### 🪙 Налаштування валют

Після підключення обов'язково налаштувати валюти.

Перейдіть:

**Загальні → Валюти**

#### 📌 Основне правило

Тікер повинен **строго відповідати** тікeру в Custodex.

Приклади:

* `USDTTRC`
* `USDCARB`
* `BTC`
* `ETHBSC`

#### ❗ Важливо

* **НЕ використовувати поле "Мережа мерчанта"**
* Уся логіка визначається **через тікер**

### 🔄 Налаштування напрямків обміну

Перейдіть:

**Адмін-панель → Напрямки обміну**

Для потрібного напрямку:

#### Укажіть:

* **Автовиплата:** Custodex

### ✅ Результат

Після налаштування мерчанта та модуля автовиплат:

* Заявка створюється, клієнту генерується адреса для оплати
* Клієнт надсилає кошти → Custodex фіксує платіж
* Lara Script отримує сповіщення → заявка підтверджується
* Автоматично виконується виплата через Custodex

➡️ Виходить **повністю автоматичний напрямок**

Про те, як налаштувати Custodex як мерчант, читайте [**тут.**](https://lara-script.gitbook.io/docs/ua/funkcional-admin-paneli/merchanti/custodex)