LiqPay

LiqPay — це український платіжний сервіс ПриватБанку для приймання онлайн-оплат, інтернет-еквайрингу, платежів у застосунках, оплат через QR, PrivatPay, Apple Pay, Google Pay, платіжні картки, інвойси та інші платіжні сценарії.

LiqPay використовується інтернет-магазинами, SaaS-сервісами, мобільними застосунками, маркетплейсами, сервісами бронювання, освітніми платформами, благодійними організаціями та іншими бізнесами, яким потрібно приймати безготівкові платежі онлайн.

Важливо: LiqPay — це платіжний сервіс та інтернет-еквайринг. Він не замінює ERP, CRM або інтернет-магазин, а використовується як платіжний шлюз для приймання оплат і повернення статусів платежів у бізнес-систему.

Загальний опис

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

PrivatBank описує LiqPay як сервіс інтернет-еквайрингу для приймання безготівкових оплат онлайн; сервіс працює на сайтах і в мобільних застосунках, а для підключення мерчанту потрібно зареєструвати та активувати акаунт LiqPay, налаштувати методи оплати й додати оплату на сайт або в застосунок. :contentReference[oaicite:0]{index=0}

LiqPay має API-документацію для різних сценаріїв: інтернет-еквайринг, токени, верифікація, інформаційні API, партнерські API, callback, помилки та POS-інтеграції для оплати через QR-код. :contentReference[oaicite:1]{index=1}

Зверніть увагу: конкретні можливості LiqPay залежать від налаштувань компанії, доступних методів оплати, API-доступу, вимог до мерчанта, валюти, типу бізнесу, способу інтеграції та правил банку.

Для чого потрібен LiqPay

LiqPay потрібен для приймання онлайн-оплат і автоматизації платіжних процесів.

Основні задачі LiqPay:

приймання оплат банківськими картками;
приймання оплат через PrivatPay;
приймання оплат через Apple Pay;
приймання оплат через Google Pay;
приймання оплат через QR;
приймання оплат у мобільних застосунках;
створення платіжної сторінки;
використання платіжного віджета;
виставлення інвойсів;
повернення коштів;
перевірка статусу платежу;
отримання callback після оплати;
отримання реєстрів і звітів;
робота з токенами карток;
регулярні платежі за підпискою;
інтеграція з ERP, CRM або інтернет-магазином.

Основні можливості

LiqPay може забезпечувати такі можливості:

Checkout;
платіжний віджет;
оплата карткою;
PrivatPay;
Apple Pay;
Google Pay;
оплата через QR;
інвойс;
повернення платежу;
двостадійна оплата;
регулярні платежі;
оплата по токену;
оплата готівкою через термінали самообслуговування;
розщеплення платежу;
DCC;
отримання статусу платежу;
отримання реєстру платежів;
отримання архіву платежів;
callback-повідомлення;
публічні API;
партнерські API;
POS-інтеграції.

Офіційна документація LiqPay для інтернет-еквайрингу перелічує такі сценарії, як Checkout, платіжний віджет, повернення, оплата карткою, PrivatPay, Apple Pay, Google Pay, підписка, QR-оплата, оплата по токену, двостадійна оплата, розщеплення платежу та інвойс. :contentReference[oaicite:2]{index=2}

LiqPay Checkout

LiqPay Checkout — це платіжна сторінка або сценарій оплати, у якому покупець переходить до платіжної форми LiqPay для завершення платежу.

Типовий процес:

Покупець оформлює замовлення на сайті.
Сайт або ERP формує платіжний запит.
Покупець переходить на сторінку LiqPay.
Покупець обирає спосіб оплати.
LiqPay обробляє платіж.
Покупець повертається на сайт.
Система отримує callback або перевіряє статус платежу.
Замовлення оновлюється в ERP.

Платіжний віджет

Платіжний віджет дозволяє приймати оплату без повного переходу покупця на окрему сторінку. Такий підхід може бути зручним для інтернет-магазинів і сервісів, які хочуть зберегти користувача в межах власного інтерфейсу.

У модулі інтеграції важливо контролювати:

суму платежу;
валюту;
номер замовлення;
опис платежу;
redirect URL;
callback URL;
статус платежу;
результат оплати;
помилки оплати.

Практичне застосування: LiqPay Checkout або платіжний віджет зручні для інтернет-магазинів, SaaS-сервісів і онлайн-платформ, де потрібно швидко приймати оплату та автоматично оновлювати статус замовлення.

PrivatPay

PrivatPay — це спосіб оплати для клієнтів ПриватБанку. У документації LiqPay описано можливість отримати посилання на оплату PrivatPay через запит до LiqPay URL відповідно до технічної документації та прикріпити це посилання до кнопки PrivatPay. :contentReference[oaicite:3]{index=3}

PrivatPay може використовуватися для:

швидкої оплати клієнтами ПриватБанку;
оплати в інтернет-магазині;
оплати в мобільному застосунку;
окремої кнопки оплати;
сценаріїв, де покупець хоче підтвердити платіж через банківський сервіс.

Apple Pay і Google Pay

LiqPay підтримує сценарії приймання платежів через Apple Pay і Google Pay у межах інтернет-еквайрингу. У документації LiqPay ці методи вказані серед доступних способів оплати для онлайн-приймання платежів. :contentReference[oaicite:4]{index=4}

Такі методи зручні для покупців, які хочуть швидко оплатити замовлення без ручного введення реквізитів картки.

Оплата через QR

LiqPay підтримує оплату через QR. У документації LiqPay також є окремий напрям для POS-систем, який описується як інтеграція POS-системи для приймання оплат через сканування QR-коду. :contentReference[oaicite:5]{index=5}

Оплата через QR може використовуватися:

у фізичних точках продажу;
у кафе й ресторанах;
у сервісних точках;
у кур’єрській доставці;
у POS-системах;
у змішаних online/offline-сценаріях.

Інвойси

LiqPay може використовуватися для виставлення рахунку клієнту. У документації інтернет-еквайрингу LiqPay інвойс описується як виставлення рахунку на e-mail клієнта у server-server режимі. :contentReference[oaicite:6]{index=6}

Інвойс може бути корисним для:

B2C-продажів без повноцінного кошика;
сервісних компаній;
оплати рахунків;
освітніх послуг;
бронювань;
індивідуальних замовлень;
ручного виставлення рахунку менеджером.

Повернення платежу

Повернення платежу використовується, коли потрібно повернути покупцю кошти повністю або частково.

У K2 ERP повернення LiqPay може бути пов’язане з:

документом повернення;
поверненням товару на склад;
скасуванням замовлення;
частковим поверненням;
поверненням доставки;
фіскалізацією повернення;
збереженням refund ID;
зміною статусу оплати.

Не плутати: повернення коштів у LiqPay і повернення товару в ERP — це різні операції. У бізнес-системі потрібно зв’язати фінансове повернення, складський рух, документ повернення і фіскальний чек повернення.

Двостадійна оплата

Двостадійна оплата — це сценарій, у якому кошти спочатку блокуються на картці клієнта, а списання виконується пізніше.

Такий підхід може бути корисним, коли:

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

Регулярні платежі і підписки

LiqPay підтримує сценарії регулярного білінгу. У документації LiqPay підписка описується як регулярний білінг клієнтів за методом server-server. :contentReference[oaicite:7]{index=7}

Регулярні платежі можуть використовуватися для:

SaaS-підписок;
сервісних тарифів;
щомісячної оплати;
доступу до онлайн-платформи;
абонентського обслуговування;
періодичних платежів клієнтів.

Токени карток

LiqPay має API-напрям для токенів, який у загальному переліку API описаний як отримання токена картки без проведення платежу. :contentReference[oaicite:8]{index=8}

Токенізація може використовуватися для:

повторної оплати без повторного введення картки;
підписок;
збережених способів оплати;
оплати по токену;
зменшення обсягу платіжних даних, які обробляє власна система.

Рекомендація: власна ERP або інтернет-магазин не повинні зберігати повні дані банківської картки. Для повторних платежів потрібно використовувати безпечні механізми токенізації, які надає платіжний сервіс.

Callback

Callback — це повідомлення від LiqPay до системи продавця про результат або зміну статусу платежу.

Callback потрібен для того, щоб ERP, CRM або інтернет-магазин автоматично дізнавалися, що платіж успішний, відхилений, скасований або має інший статус.

У callback бажано перевіряти:

підпис;
ідентифікатор платежу;
номер замовлення;
суму;
валюту;
статус;
дату платежу;
дублювання повідомлення;
відповідність замовленню в ERP.

Статус платежу

LiqPay має інформаційні API для отримання звітів та інформації про платіж. Окремо в документації зазначено API для отримання статусу платежу. :contentReference[oaicite:9]{index=9}

У K2 ERP статус платежу може оновлювати:

статус замовлення;
статус оплати;
можливість відвантаження;
статус фіскалізації;
доступ клієнта до послуги;
статус підписки;
фінансовий документ.

Типові статуси платежів

У платіжній інтеграції можуть використовуватися такі бізнес-статуси:

створено платіж;
очікує оплати;
у процесі;
успішно оплачено;
відхилено;
скасовано;
повернено;
частково повернено;
помилка;
очікує підтвердження;
заблоковано;
списано.

У K2 ERP статуси LiqPay бажано зіставити з внутрішніми статусами оплат і замовлень.

Інтеграція LiqPay з K2 ERP

У системі K2 ERP LiqPay може використовуватися як платіжний модуль для онлайн-продажів, інтернет-магазинів, SaaS, маркетплейсів, мобільних застосунків і рахунків на оплату.

Типова реалізація може включати:

налаштування мерчанта LiqPay;
зберігання public key;
захищене зберігання private key;
формування платіжного запиту;
створення платіжного посилання;
роботу з Checkout;
роботу з платіжним віджетом;
приймання callback;
перевірку підпису;
отримання статусу платежу;
створення документа оплати;
зв’язок платежу із замовленням;
обробку повернення;
фіскалізацію після успішної оплати;
журнал технічного обміну;
повторну перевірку статусів.

Для K2 ERP: LiqPay доцільно реалізовувати як окремий платіжний модуль. Він має створювати платіж, приймати callback, перевіряти підпис, оновлювати статус замовлення, створювати оплату і запускати фіскалізацію за правилами бізнесу.

Типовий сценарій оплати замовлення

Типовий процес оплати через LiqPay у K2 ERP може виглядати так:

Покупець створює замовлення на сайті або в інтернет-магазині.
Замовлення передається в K2 ERP.
K2 ERP формує платіжний запит LiqPay.
Покупець переходить на платіжну сторінку або бачить віджет.
Покупець оплачує замовлення.
LiqPay надсилає callback у K2 ERP або інтеграційний сервіс.
K2 ERP перевіряє підпис callback.
Система оновлює статус оплати.
Створюється документ оплати.
Товар резервується або передається на відвантаження.
За потреби виконується фіскалізація через РРО або ПРРО.
Покупцю надсилається підтвердження, чек або повідомлення.

Типовий сценарій повернення

Типовий процес повернення платежу може виглядати так:

Клієнт звертається з поверненням.
Менеджер знаходить замовлення в K2 ERP.
Система перевіряє початковий платіж LiqPay.
Створюється документ повернення.
За потреби товар повертається на склад.
K2 ERP або інтеграційний сервіс формує запит на повернення в LiqPay.
LiqPay повертає результат операції.
ERP оновлює статус повернення.
За потреби формується фіскальний чек повернення.
У журналі зберігається технічна відповідь.

Дані, які бажано зберігати в ERP

Для якісної інтеграції з LiqPay в ERP бажано зберігати:

ідентифікатор мерчанта;
public key;
private key у захищеному вигляді;
номер замовлення;
ідентифікатор платежу LiqPay;
order_id;
суму;
валюту;
опис платежу;
метод оплати;
статус платежу;
дату створення платежу;
дату успішної оплати;
дату callback;
технічну відповідь;
підпис callback;
результат перевірки підпису;
transaction ID;
refund ID;
статус повернення;
зв’язок із документом замовлення;
зв’язок із документом оплати;
зв’язок із фіскальним чеком;
кількість спроб перевірки статусу;
текст помилки.

Журнал обміну

Журнал обміну потрібен для контролю платіжної інтеграції та швидкого пошуку помилок.

У журналі бажано зберігати:

дату і час операції;
напрям обміну;
тип операції;
номер замовлення;
LiqPay payment ID;
суму;
валюту;
статус;
endpoint або API-метод;
текст помилки;
технічну відповідь;
результат перевірки підпису;
користувача або сервіс, який ініціював операцію;
кількість повторних спроб;
результат повторної обробки.

LiqPay і фіскалізація

LiqPay приймає оплату, але сам факт платежу не завжди закриває всі облікові задачі. Для продажів фізичним особам може бути потрібна фіскалізація через РРО або ПРРО залежно від законодавства, типу операції, способу оплати й моделі бізнесу.

У K2 ERP це може працювати так:

LiqPay підтверджує успішну оплату.
K2 ERP створює документ оплати.
Система перевіряє, чи потрібно фіскалізувати операцію.
Якщо потрібно, формується фіскальний чек.
Чек передається в РРО або ПРРО.
Номер чека зберігається в ERP.
Чек надсилається покупцю.
У разі повернення формується чек повернення.

Для облікової системи: LiqPay-платіж бажано зв’язувати не лише із замовленням, а й із документом оплати, фіскальним чеком, доставкою і поверненням. Це спрощує контроль продажів і фінансову звірку.

Звірка платежів

Звірка платежів потрібна для перевірки відповідності між LiqPay, ERP, банківськими надходженнями та замовленнями.

Звірка може перевіряти:

чи всі успішні платежі потрапили в ERP;
чи всі оплачені замовлення мають документ оплати;
чи немає оплат без замовлення;
чи сума платежу збігається із сумою замовлення;
чи правильна валюта;
чи всі повернення відображені;
чи всі фіскальні чеки створені;
чи немає дублювання callback;
чи всі помилки оброблені.

Публічні API LiqPay

LiqPay також має публічні API. У документації вказано, що публічні API можуть використовуватися без реєстрації, зокрема для отримання курсів валют ПриватБанку та архіву курсів. :contentReference[oaicite:10]{index=10}

Такі API можуть бути корисні для:

інформаційних віджетів;
довідкових курсів валют;
допоміжних фінансових сервісів;
звітів;
попереднього розрахунку вартості.

Партнерські API

LiqPay має партнерські API, пов’язані зі створенням компаній та отриманням інформації про компанії або партнера. У документації LiqPay партнерський напрям описується як створення компаній або отримання інформації за існуючими. :contentReference[oaicite:11]{index=11}

Партнерські API можуть бути корисні для:

платформ із багатьма продавцями;
агентських схем;
маркетплейсів;
сервісів, які підключають мерчантів;
централізованого керування компаніями.

Можливі помилки під час інтеграції

Під час роботи з LiqPay можуть виникати такі помилки:

неправильний public key;
неправильний private key;
невірний підпис;
не збігається сума платежу;
не збігається валюта;
order_id уже використаний;
callback не дійшов;
callback оброблений двічі;
платіж відхилено банком;
покупець скасував оплату;
помилка 3-D Secure;
недостатньо коштів;
платіж завис у проміжному статусі;
помилка повернення;
помилка токена;
помилка мережі;
API тимчасово недоступне;
статус у ERP не оновився;
фіскалізація не виконалась після оплати.

Рекомендація: платіжний модуль має бути ідемпотентним. Якщо callback прийшов повторно, система не повинна створювати дубль оплати, дубль фіскального чека або повторне відвантаження.

Безпека інтеграції

Для безпечної роботи з LiqPay потрібно контролювати:

захищене зберігання private key;
перевірку підпису callback;
HTTPS для callback URL;
права користувачів;
доступ до налаштувань мерчанта;
журнал дій;
захист логів;
обмеження доступу до фінансових операцій;
захист персональних даних покупців;
обробку повторних callback;
контроль підозрілих платежів;
резервне копіювання налаштувань;
розмежування тестового і production-середовища.

Дані, які не можна виводити в логах

У логах інтеграції не варто виводити:

private key;
повні реквізити банківської картки;
CVV;
паролі;
приватні ключі;
повні персональні дані понад необхідний мінімум;
production connection strings;
внутрішні API-ключі;
токени;
конфіденційні фінансові дані.

Безпека: у власній ERP або інтернет-магазині не потрібно зберігати повні дані банківських карток. Для цього мають використовуватися захищені механізми платіжного сервісу.

Переваги LiqPay

До основних переваг LiqPay можна віднести:

приймання онлайн-оплат;
підтримку різних методів оплати;
інтеграцію з сайтами та застосунками;
API для автоматизації;
callback для оновлення статусів;
можливість повернення платежів;
підтримку інвойсів;
підтримку QR-оплати;
підтримку регулярних платежів;
можливість інтеграції з ERP і CRM;
звірку платежів через інформаційні API;
використання в B2C, SaaS та e-commerce-сценаріях.

Обмеження та ризики

Під час впровадження LiqPay потрібно враховувати:

потребу в акаунті мерчанта;
вимоги до мерчанта;
потребу в правильному налаштуванні API;
потребу в захисті private key;
потребу в перевірці callback;
можливі помилки платежів;
потребу в обробці повернень;
потребу в звірці платежів;
залежність від доступності платіжного сервісу;
потребу в правильній фіскалізації;
потребу в юридичній перевірці правил приймання оплат.

Не плутати: LiqPay підтверджує факт оплати, але ERP має окремо обробити замовлення, склад, доставку, фіскальний чек, повернення і бухгалтерські документи.

Висновок

LiqPay — це платіжний сервіс ПриватБанку для приймання онлайн-оплат, інтернет-еквайрингу, платежів у застосунках, QR-оплат, інвойсів, регулярних платежів і повернень.

Для K2 ERP LiqPay доцільно реалізовувати як окремий платіжний модуль, який формує платіжні запити, приймає callback, перевіряє підпис, отримує статуси, створює документи оплати, обробляє повернення, запускає фіскалізацію та зберігає повний журнал технічного обміну.

Джерела

Див. також

Інтеграція РРО в Python

Технічне завдання: інтеграція ПРРО Checkbox для Python

ДПС

ЕДО

Інтеграція з Новою поштою в Python

Інтеграція з Укрпоштою в Python