QUINCEFINСпробувати
Відкрити меню

Інтеграція з платіжними системами LiqPay, hutko, plata by mono

QUINCEFIN підтримує інтеграцію з платіжними системами LiqPay, hutko, plata by mono для створення посилань на оплату з документів (Замовлення, Рахунок, Продаж) та обліку підтвердженої оплати. Підтвердження оплати покупцем і фактична виплата провайдером у банк - різні події.

Реєстри оплат LiqPay, Hutko та plata by mono

Для обліку оплат із CSV використовуйте той самий розділ профілів платіжних систем. У профілі є вкладка Клієнт-банк з окремим рахунком платіжної системи та статтями комісії. Якщо приймання оплат через API не потрібне, увімкніть Лише CSV-реєстри (без приймання оплат через API); ключі для платіжних посилань у цьому режимі не потрібні.

Послідовність роботи:

  1. Налаштуйте профіль і рахунки.
  2. У Гроші → Клієнт-банк → Реєстр платіжної системи завантажте CSV та проведіть оплати.
  3. З рядка банківської виписки звірте виплату й створіть переміщення в банк.

Для plata by mono підтримується CSV формату «RT виписка». Суми оплати, комісії та виплати беруться з файлу, валюта — з рахунку профілю. Для імпорту без платіжних посилань токен і перевірка з’єднання не потрібні: достатньо режиму Лише CSV-реєстри та налаштувань вкладки Клієнт-банк.

Plata та клієнт-банк monobank мають різні ролі: Plata розшифровує оплати покупців, а банк підтверджує зарахування загальної виплати. Використовуйте окремий обліковий рахунок Plata та окремий фактичний банківський рахунок.

Після відповідного оновлення QFin для Plata передбачено додаткову автоприв’язку, якщо платежу немає в історії інтеграції: UUID із колонки «Номер заказу» має точно збігатися з CheckoutID: <UUID> у коментарі оригінального замовлення із SalesDrive або Shopify. Потрібен єдиний сумісний документ тієї самої організації та валюти, а повна сума платежу до комісії має дорівнювати повній сумі документа. Уже враховані оплати перевіряються окремо. Звичайний номер документа чи скопійований коментар реалізації не замінюють цей зв’язок.

Лічильник Знайдено в інтеграції: 0 не виключає прив’язки за CheckoutID. Якщо точного збігу немає або оновлення ще недоступне, виберіть документ або покупця вручну. Деталі й обмеження: як знаходиться документ та що означають статуси.

Завантаження реєстрів через API поки не підтримується. Нижче описано окремий сценарій платіжних посилань і callback, а не імпорт CSV. Якщо надходження вже проведене через callback, не проводьте ту саму оплату вдруге з файлу.

Для WayForPay та NovaPay є окремі покрокові інструкції: Інтеграція з WayForPay і Інтеграція з NovaPay.

Підключення LiqPay

Для підключення до сервісу LiqPay необхідно вказати публічний та приватний ключі, які можна отримати у кабінеті LiqPay.

liqpay_integration.png

Підключення hutko

Для підключення до сервісу hutko необхідно вказати публічний та приватний ключі, які можна отримати у кабінеті hutko.

hutko_integration.png

Підключення plata by mono

Для створення платіжних посилань у plata by mono створіть профіль інтеграції, вкажіть назву та токен. Не вмикайте режим Лише CSV-реєстри. Перевірте з’єднання й після успішної перевірки збережіть профіль.

Токен можна отримати у веб-кабінеті monobank.

plata_integration.png

Прив’язка платіжної системи до банківського рахунку

Після підключення інтеграції платіжну систему необхідно прив’язати до банківського рахунку QUINCEFIN.

Це означає, що кошти з цієї платіжної системи будуть зараховуватися саме на цей рахунок.

Після прив’язки:

  • рахунок стає доступним для створення посилань на оплату
  • усі оплати з платіжної системи автоматично відображаються як надходження на цей рахунок

Створення посилання на оплату

У документах:

  • Замовлення
  • Рахунок
  • Продаж

якщо вибрано банківський рахунок, до якого підключена платіжна система, і користувач має доступ до цієї інтеграції, у меню документа з’являється дія:

Створити посилання на оплату

У діалозі створення відображається:

  • платіжна система
  • сума платежу
  • текст / URL посилання
  • можливість скопіювати посилання

Користувач копіює посилання та надсилає його клієнту.

screen_payment_service.png

Оплата клієнтом і автоматичне зарахування

Після переходу за посиланням клієнт виконує оплату у платіжній системі.

Після підтвердження платежу:

  1. Платіжна система надсилає повідомлення (callback) у QUINCEFIN
  2. Система знаходить пов’язаний документ (Замовлення / Рахунок / Продаж)
  3. Автоматично створюється документ Надходження на банківський рахунок
  4. Банківський рахунок і сума підставляються з інтеграції

Таким чином оплата відображається в обліку без ручного введення.

Статус посилання на оплату

Посилання на оплату має статус, який відображається у системі:

  • створено
  • сплачено

Після отримання підтвердження від платіжної системи статус автоматично змінюється на сплачено.

Загальний сценарій роботи

  1. Підключається платіжна система (LiqPay, hutko або plata by mono)
  2. Вона прив’язується до банківського рахунку
  3. У документі створюється посилання на оплату
  4. Клієнт оплачує
  5. QUINCEFIN отримує підтвердження
  6. Автоматично створюється надходження грошей
  7. Посилання позначається як сплачене

Пов’язана документація