Еквайринг: налаштування профілю та рахунків
Ця інструкція описує спільний обліковий сценарій для LiqPay, WayForPay, Hutko, plata by mono та NovaPay (післяплата): завантажити окремі оплати з CSV, врахувати комісію та звірити загальну виплату з банком.
Профілі залишаються у Налаштування → Інтеграції → Платіжні системи. Окремий дублікат такого профілю в налаштуваннях клієнт-банку не потрібен. Його використання для реєстрів задається на вкладці Клієнт-банк.
Потрібен тариф BUSINESS і права користувача на профіль, рахунки, організацію та документи. Звичайний Клієнт-банк доступний і в SOLO, але це не відкриває платіжні профілі для реєстрів еквайрингу. Дивіться також огляд обліку еквайрингу та післяплат.
Як розділяються оплата і виплата
У цьому сценарії є два різні рахунки:
- Рахунок платіжної системи, наприклад «LiqPay, UAH». Тут обліковуються оплати покупців і утримана комісія до перерахування грошей у банк.
- Фактичний банківський рахунок, наприклад «Поточний рахунок, UAH». На нього приходить загальна виплата від платіжної системи.
Оплата покупця створює Надходження на рахунок із комісією. Виплата провайдера створює Переміщення коштів між цими рахунками, а не ще одну оплату від покупця.
1. Підготуйте рахунки та статті
- У довіднику банківських рахунків створіть окремий активний безготівковий рахунок для коштів у платіжній системі.
- Вкажіть правильну організацію та валюту. Саме вони визначатимуть організацію і валюту оплат із реєстру.
- Переконайтеся, що фактичний рахунок, куди надходять виплати, заведений окремо. Для звіряння він має належати тій самій організації та мати ту саму валюту.
- Підготуйте статтю витрат, наприклад «Комісія платіжної системи», та статтю вихідного руху коштів для цієї комісії.
Не вибирайте фактичний банківський рахунок замість окремого рахунку платіжної системи: інакше не буде коректного розділення коштів у провайдера та в банку.
Вхідна стаття для оплати покупця
Окрім статей комісії, потрібна вхідна стаття руху коштів для надходження, наприклад «Оплата від покупців». Після відповідного оновлення QFin вона визначається так: вибір у рядку реєстру → стаття договору → вхідна стаття за замовчуванням поточного користувача. Налаштування іншого користувача не підставляється.
Перевірте цю статтю в договорі або налаштуваннях значень за замовчуванням того користувача, який проводить реєстр. Стаття має бути активною, вхідною та не групою. Якщо придатної статті немає, виберіть її вручну в рядку попереднього перегляду. Не підставляйте замість неї вихідну статтю комісії.
Правила автоприв’язки NovaPay за ТТН та plata за CheckoutID, нові статуси й доступність оновлення описані в інструкції імпорту CSV.
2. Налаштуйте профіль
- Відкрийте Налаштування → Інтеграції → Платіжні системи та виберіть провайдера.
- Відкрийте наявний профіль або створіть профіль із зрозумілою назвою, наприклад «LiqPay, основний магазин».
- Якщо потрібен тільки імпорт файлів, увімкніть Лише CSV-реєстри (без приймання оплат через API). У цьому режимі ключі для приймання онлайн-оплат не потрібні, а створення платіжних посилань вимкнено.
- Перейдіть на вкладку Клієнт-банк.
- Заповніть поля:
| Поле | Що вибрати |
|---|---|
| Рахунок платіжної системи | Окремий безготівковий рахунок із кроку 1. |
| Організація, Валюта | Відображаються з вибраного рахунку. Перевірте їх. |
| Стаття витрат для комісії | Стаття, за якою комісія відображатиметься у витратах. |
| Стаття руху коштів для комісії | Стаття вихідного руху коштів. |
- Збережіть профіль.
- Відкрийте Гроші → Клієнт-банк → Реєстр платіжної системи. Профіль має з’явитися у списку.
Якщо профілю немає, перевірте його активність, збережений рахунок та доступ користувача до профілю, рахунку й організації. Створення та проведення документів також потребує відповідних прав.
Приклад налаштування plata by mono
- Створіть обліковий рахунок «Plata, UAH» своєї організації. Фактичний рахунок ФОП у monobank або іншому банку залиште окремим.
- У Платіжні системи → plata by mono створіть або відкрийте профіль. Для імпорту без платіжних посилань увімкніть Лише CSV-реєстри (без приймання оплат через API): токен і перевірка з’єднання в цьому режимі не потрібні.
- На вкладці Клієнт-банк виберіть «Plata, UAH» і статті комісії та збережіть профіль. Валюта оплат береться з цього рахунку, оскільки в підтриманому CSV її немає.
- Завантажуйте розшифровку оплат через Реєстр платіжної системи, вибравши саме профіль Plata.
Інтеграція з monobank завантажує виписку фактичного банківського рахунку. Вона не замінює профіль Plata і не розшифровує покупців у загальній виплаті. Режим завантаження банківської виписки «з файлу» чи «з API» не потрібно змінювати для імпорту CSV Plata.
Якщо потрібні ще й платіжні посилання
Для приймання оплат через API не вмикайте режим Лише CSV-реєстри. Заповніть реквізити мерчанта за інструкцією провайдера:
Прив’язка платіжного профілю в картці рахунку для створення посилань і поле Рахунок платіжної системи на вкладці Клієнт-банк мають різне призначення. Налаштування CSV не переносить раніше створені надходження на інший рахунок.
Якщо оплату вже проведено через callback або вручну, не проводьте її повторно з CSV. Позначка Відомий платіж у перегляді означає знайдений платіж інтеграції, але сама по собі не підтверджує, що його надходження проведене та включене в журнал реєстрів. Перевірте існуючий документ перед проведенням.
Межі підтримки
- Імпорт приймає оригінальні CSV у UTF-8, до 5 МБ і 5 000 оплат. XLS/XLSX не підтримуються; перейменування розширення не перетворює файл на CSV.
- За один запуск можна провести до 100 вибраних оплат.
- Завантаження реєстрів через API ще не реалізоване. API для платіжних посилань і callback - інший механізм.
- Повернення, оскарження платежів, додаткові комісії та файли зі змішаними валютами потребують окремого розгляду, а не автоматичного проведення цим сценарієм.
- Для plata by mono підтримано CSV формату «RT виписка»: дата й час операції, ID, сума платежу, комісія та сума виплати. Інші види звітів можуть мати несумісні колонки.
- NovaPay післяплата і NovaPay Business - різні джерела: перше розшифровує оплати, друге завантажує виписку бізнес-рахунку.
Далі
Завантажити повну інструкцію користувача у HTML — налаштування, імпорт і звіряння в одному файлі, доступному без інтернету.