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

# MonoPay (Plata by mono)

Інтеграція з MonoPay (еквайринг Plata by mono) створює посилання на оплату угоди через monobank. Клієнт сплачує карткою за посиланням, а оплата сама проводиться доходом по угоді в «Фінансах» — один раз, без дублів.

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

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

1. Рядок `MONOPAY_TOKEN` → «Ввести» → «Зберегти ключ». Токен еквайрингу — у кабінеті Plata by mono. Зберігається зашифрованим.
2. «Перевірити» читає дані мерчанта: успіх — його назва.

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

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

## 3. Як фіксується оплата
Автоматично — за повідомленням monobank (CRM перепитує статус у банку) — або кнопкою «Перевірити оплату». Оплата стає платежем угоди: блок «Фінанси», «Фінанси → Операції», перерахунок «Сплачено» і «Очікується».

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «MonoPay не налаштовано: додайте MONOPAY_TOKEN (еквайринг Plata by mono) …» | Токен не введено | Введіть токен у картці |
| «MonoPay: валюта … не підтримується» | Угода не в гривні чи іншій підтримуваній валюті | Виставте посилання в підтримуваній валюті |
| «MonoPay: …» | Банк відхилив запит | Перевірте токен і стан мерчанта |
| «сума має бути більшою за нуль» | Нульова сума | Вкажіть суму |

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

## Додаткова інформація
- Пов'язані статті: [LiqPay](int-liqpay.md), [Monobank](int-monobank.md), [Фінанси](finance.md).