> Усі статті WIKI Helomi: /wiki/llms.txt

# LiqPay

Інтеграція з LiqPay створює посилання на оплату угоди, яке менеджер надсилає клієнту. Коли клієнт сплатив, оплата сама проводиться доходом по угоді в «Фінансах» — один раз, без дублів.

## Можливості
- Посилання на оплату з картки угоди; сума за замовчуванням — несплачений залишок.
- Вибір гаманця, куди зарахувати оплату.
- Оплата фіксується сама (повідомлення LiqPay) або кнопкою «Перевірити оплату» і стає платежем угоди.
- Стан кожного посилання: «очікує оплати», «оплачено», «не вдалося», «прострочено».

## 1. Налаштування
Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Оплати» → картка «LiqPay» → «Підключення».

1. Рядки `LIQPAY_PUBLIC_KEY` і `LIQPAY_PRIVATE_KEY` → «Ввести» → «Зберегти ключ». Публічний і приватний ключі — у кабінеті LiqPay вашого магазину. Ключі зберігаються зашифрованими.
2. Перевірки кнопкою нема — дивіться стан ключів і журнал; перша спроба створити посилання покаже, чи ключі правильні.

Одна картка — один магазин LiqPay; кількох поки нема. У режимі кількох організацій ключі читаються лише зі змінних сервера.

## 2. Створити посилання на оплату
1. Картка угоди → блок «Фінанси» → «Посилання на оплату».
2. Провайдер «LiqPay», «Сума посилання» (порожньо — несплачений залишок), «Гаманець зарахування» (порожньо — перший гаманець) → «Створити посилання».
3. Посилання скопіюється — надішліть його клієнту. У списку посилань: сума, стан, «Скопіювати».

Блок не показується в архівній угоді. Якщо LiqPay і MonoPay не підключені, у блоці підказка «Посилання на оплату: підключіть LiqPay або MonoPay …».

## 3. Як фіксується оплата
- Автоматично: LiqPay повідомляє Helomi про оплату; CRM перепитує статус у LiqPay (тілу повідомлення не вірить) і проводить дохід по угоді.
- Вручну: «Перевірити оплату» біля посилання → «Оплачено — платіж додано в угоду» або стан лишається «очікує».

Платіж з'являється в блоці «Фінанси» угоди і в «Фінанси → Операції»; «Сплачено» і «Очікується» перераховуються.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «LiqPay не налаштовано: додайте LIQPAY_PUBLIC_KEY і LIQPAY_PRIVATE_KEY …» | Ключі не введено | Введіть обидва ключі в картці |
| «сума має бути більшою за нуль» | Нульова сума | Вкажіть суму |
| «LiqPay: …» | LiqPay відхилив запит | Перевірте ключі й налаштування магазину |

## Для ШІ-співробітників
5`). Оплату, що прийшла, ШІ бачить у платежах угоди (`deals_get`). Статтю ШІ читає інструментом `help("int-liqpay")`.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Фінанси](finance.md), [MonoPay](int-monopay.md).