> 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/ecpay.md).
# ECPAY
Інтеграція з **ECPAY Systems** дозволяє автоматично виплачувати фіатні кошти клієнтам одразу після оплати заявки. Щойно заявку з автовиплатою буде оплачено, система передає її до вашого особистого кабінету ECPAY, де ви можете модерувати виплати.
Процес підключення займає 10–15 хвилин і складається з трьох частин: налаштування валют, налаштування користувацьких полів і налаштування напрямків.
### Крок 1: Отримання API-ключів в ECPAY
* Зареєструйте обліковий запис на [ecpay.systems](https://ecpay.systems/) і увійдіть до особистого кабінету
* Натисніть на **іконку свого профілю** у правому верхньому куті та перейдіть до **«Налаштування»**
* Прокрутіть сторінку вниз до розділу **«🔌 API доступ»**
* Переконайтеся, що статус **«● Активний»** — якщо статус «Вимкнено», зверніться до адміністратора платформи для активації
* Скопіюйте:
* **API-ключ** — публічний ключ
* **API-секрет** — секретний ключ
> 💡 Детальніше про отримання ключів читайте в [документації ECPAY](https://ecpay.systems/docs.php#getkey)
### Крок 2: Підключення автовиплат в адмін-панелі
* Увійдіть до адмін-панелі Lara Script
* Перейдіть до **«Загальні»** → **«Автовиплати»**
* Знайдіть **ECPAY Systems** у списку та натисніть **«Редагування»**
* Заповніть поля:
* **API-ключ** — вставте публічний API-ключ з особистого кабінету ECPAY
* **API-секрет** — вставте секретний ключ з того самого розділу
* Натисніть «Зберегти»
* Натисніть на перемикач для активації провайдера
### Крок 3: Налаштування валют
Перейдіть до **«Загальні»** → **«Валюти»**.
Ключове правило: тікер валюти в Lara Script повинен **точно збігатися** з `bank_code` з документації ECPAY. Саме за цим кодом система визначає банк для виплати.
Приклади відповідності:
| Банк / Метод | Валюта | Тікер (bank\_code) |
| ------------- | ------ | ------------------ |
| Halyk Bank | KZT | `HALYKKZT` |
| Monobank | UAH | `MONOBUAH` |
| Card Transfer | KGS | `CARDKGS` |
| Kaspi Bank | KZT | `KASPIKZT` |
| SEPA Instant | EUR | `SEPAEUR` |
| Приват Банк | UAH | `P24UAH` |
Повний список актуальних `bank_code` по всіх валютах доступний у [документації ECPAY → Коди банків](https://ecpay.systems/docs.php#banks).
> ⚠️ Якщо тікер вказано неправильно — система не зможе зіставити валюту з банком і виплата не буде створена.
### Крок 4: Налаштування користувацьких полів
Перейдіть до **«Загальні»** → **«Користувацькі поля»**.
Користувацькі поля визначають, які реквізити клієнт має ввести під час створення заявки. Їх потрібно налаштувати відповідно до вимог ECPAY — у розділі [Реквізити за банками → Типи валідації](https://ecpay.systems/docs.php#requisites).
Для кожного поля необхідно обрати **тег**, що відповідає типу даних в ECPAY:
| Тип реквізиту в ECPAY | Тег поля в Lara Script |
| --------------------- | ---------------------- |
| Номер картки (`card`) | Картка |
| IBAN (`iban`) | IBAN |
| Email (`email`) | Email |
| Телефон (`phone`) | Телефон |
| ПІБ отримувача | ПІБ отримувача |
Створіть усі поля, які вимагає потрібний вам банк. Наприклад, для Halyk Bank (KZT) потребуватимуться поля **Картка** і **ПІБ отримувача**, а для SEPA Instant (EUR) — **IBAN** і **ПІБ отримувача**.
Після створення полів їх потрібно прив’язати до валюти:
* Перейдіть до **«Загальні»** → **«Валюти»** → відкрийте потрібну валюту
* У розділі **«Отримую»** натисніть **«+Додати»** та виберіть створені поля
### Крок 5: Налаштування напрямків обміну
Перейдіть до **«Загальні»** → **«Напрямки»**.
Відкрийте потрібний напрям, де фіат виступає як валюта **«Отримую»** (тобто те, що отримує клієнт).
У розділі **«Виводи»**:
* Натисніть **«Додати рядок»**
* У полі **«Автоматичні виводи»** оберіть **ECPAY Systems**
* Вкажіть **мінімальну** і **максимальну** суму для спрацювання автовиплати (ліміти застосовуються до валюти «Отримую»)
* Збережіть напрям
### Як це працює
Після завершення налаштування процес обробки заявок виглядає так:
1. Клієнт створює заявку та вводить реквізити (картка, IBAN, email тощо)
2. Клієнт оплачує заявку
3. Lara Script фіксує оплату → заявка отримує статус **«Оплачена»**
4. Система автоматично створює виплату в ECPAY
5. Заявка з’являється у вашому особистому кабінеті ECPAY у розділі заявок
6. Оператор ECPAY модерує та виконує виплату клієнту
7. Після виплати заявка переходить у статус **«Виконана»**
> ℹ️ Якщо сума надісланої оплати не збігається із сумою заявки, заявка отримає статус **«На перевірці»** і виплата не буде виконана автоматично. У такому разі знадобиться ручна обробка через кнопку **«Запустити автоплатіж»** із введенням коду ручного виводу. Код налаштовується в **Налаштування адміністратора → Код підтвердження для ручного виводу.**
#### Використання котирувань **ECPAY** Systems
Lara Script також підтримує роботу з котируваннями сервісу ECPAY Systems.
Ви можете створювати котирування на основі курсів ECPay і надалі використовувати їх для валют і напрямків обміну. Підтримуються котирування по всіх валютах і мережах, доступних у ECPAY Systems.
Для додавання котирування:
1. Перейдіть до розділу:\
**Курси валют → Котирування**
2. Натисніть кнопку **«Додати»**
3. Під час створення формули оберіть джерело котирування **ecpay**
4. Збережіть котирування
Після цього створене котирування можна використовувати:
* у формулах валют;
* у формулах напрямків обміну;
* в автоматичному розрахунку курсів.
Це дає змогу автоматично отримувати й використовувати актуальні курси ECPAY Systems всередині Lara Script та виконувати заявки без прив’язки до різних сервісів, один і той самий сервіс передаватиме для вас актуальні курси, і той самий сервіс виступатиме для вас у ролі мерчанта для виконання заявок.