LiqPay

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

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

SaaS-підписок;
сервісних тарифів;
щомісячної оплати;
доступу до онлайн-платформи;
абонентського обслуговування;
періодичних платежів клієнтів.; Не плутати: LiqPay підтверджує факт оплати, але ERP має окремо обробити замовлення, складський облік, доставку, фіскальний чек, повернення і бухгалтерські документи.; # Якщо потрібно, формується фіскальний чек.; LiqPay Checkout — це платіжна сторінка або сценарій оплати, у якому покупець переходить до платіжної форми LiqPay для завершення платежу.; Якщо callback прийшов повторно, платформа не повинна створювати дубль оплати, дубль фіскального чека або повторне відвантаження.; :contentReference [oaicite:6]{index=6}

K2 Модуль Wix

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

K2 Модуль Shopify

Tilda Commerce

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

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

Для K2 ERP LiqPay доцільно реалізовувати як окремий платіжний компонент, який формує платіжні запити, приймає callback, перевіряє підпис, отримує статуси, створює документи оплати, обробляє повернення, запускає фіскалізацію та зберігає повний журнал технічного обміну.; LiqPay — це платіжний сервіс ПриватБанку для приймання онлайн-оплат, інтернет-еквайрингу, платежів у застосунках, QR-оплат, інвойсів, регулярних платежів і повернень.; # Покупець обирає спосіб оплати.; У бізнес-системі потрібно зв’язати фінансове повернення, складський рух, документ повернення і фіскальний чек повернення.; # Чек передається в РРО або ПРРО.; # Покупець оплачує замовлення.; # Покупець повертається на сайт.; У документації LiqPay ці методи вказані серед доступних способів оплати для онлайн-приймання платежів.; # Покупець переходить на платіжну сторінку або бачить віджет.; # Чек надсилається покупцю.; Для цього мають використовуватися захищені механізми платіжного сервісу.; Такий підхід має змогу бути зручним для інтернет-магазинів і сервісів, які хочуть зберегти користувача в межах власного інтерфейсу.; # K2 ERP перевіряє підпис callback.; :contentReference [oaicite:5]{index=5}

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

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

потребу в акаунті мерчанта;
вимоги до мерчанта;
потребу в правильному налаштуванні API;
потребу в захисті private key;
потребу в перевірці callback;
можливі помилки платежів;
потребу в обробці повернень;
потребу в звірці платежів;
залежність від доступності платіжного сервісу;
потребу в правильній фіскалізації;
потребу в юридичній перевірці правил приймання оплат.; # платформа перевіряє, чи потрібно фіскалізувати операцію.; # LiqPay повертає результат операції.; # Покупець переходить на сторінку LiqPay.; Окремо в документації зазначено API для отримання статусу платежу.; У документації вказано, що публічні API можуть використовуватися без реєстрації, зокрема для отримання курсів валют ПриватБанку та архіву курсів.; # У разі повернення формується чек повернення.; :contentReference [oaicite:4]{index=4}

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

суму платежу;
валюту;
номер замовлення;
характеристика платежу;
redirect URL;
callback URL;
статус платежу;
результат оплати;
помилки оплати.; # За потреби товар повертається на складський облік.;Інтеграція з Укрпоштою в Python

У журналі бажано зберігати: Звірка платежів потрібна для перевірки відповідності між LiqPay, ERP, банківськими надходженнями та замовленнями.; LiqPay має API-документацію для різних сценаріїв: інтернет-еквайринг, токени, верифікація, інформаційні API, партнерські API, callback, помилки та POS-інтеграції для оплати через QR-код.;== Обмеження та ризики == PrivatPay має змогу використовуватися для:

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

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

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

LiqPay підтримує роботу сценарії регулярного білінгу.;

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

LiqPay Checkout

Рекомендація: платіжний компонент має бути ідемпотентним.;== Apple Pay і Google Pay ==

ЕДО Звірка має змогу перевіряти:

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

Покупець оформлює замовлення на сайті.; Він має створювати платіж, приймати callback, перевіряти підпис, оновлювати статус замовлення, створювати оплату і запускати фіскалізацію за правилами бізнесу.;OpenCart

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

переважні аспекти LiqPay

LiqPay приймає оплату, але сам факт платежу не завжди закриває всі облікові задачі.; У документації LiqPay описано можливість отримати посилання на оплату PrivatPay через запит до LiqPay URL відповідно до технічної документації та прикріпити це посилання до кнопки PrivatPay.; # Створюється документ повернення.;== Двостадійна оплата ==

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

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

поверненням товару на складський облік;
скасуванням замовлення;
частковим поверненням;
поверненням доставки;
фіскалізацією повернення;
збереженням refund ID;
зміною статусу оплати.; LiqPay потрібен для приймання онлайн-оплат і автоматизації платіжних процесів.; Повернення платежу застосовується, коли потрібно повернути покупцю кошти в цілому або частково.; У K2 ERP статуси LiqPay бажано зіставити з внутрішніми статусами оплат і замовлень.; # ERP оновлює статус повернення.;== Для чого потрібен LiqPay ==

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

інформаційні дані, які бажано зберігати в ERP

ідентифікатор мерчанта;
public key;
private key у захищеному вигляді;
номер замовлення;
ідентифікатор платежу LiqPay;
order_id;
суму;
валюту;
характеристика платежу;
метод оплати;
статус платежу;
дату створення платежу;
дату успішної оплати;
дату callback;
технічну відповідь;
підпис callback;
результат перевірки підпису;
transaction ID;
refund ID;
статус повернення;
зв’язок із документом замовлення;
зв’язок із документом оплати;
зв’язок із фіскальним чеком;
кількість спроб перевірки статусу;
текст помилки.; # K2 ERP формує платіжний запит LiqPay.; Для облікової системи: LiqPay-платіж бажано зв’язувати не лише із замовленням, а й із документом оплати, фіскальним чеком, доставкою і поверненням.;Інтеграція РРО в Python

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

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

LiqPay підтверджує успішну оплату.; LiqPay має змогу використовуватися для виставлення рахунку клієнту.; Такі API можуть бути корисні для:

Офіційна документація LiqPay для інтернет-еквайрингу перелічує такі сценарії, як Checkout, платіжний віджет, повернення, оплата карткою, PrivatPay, Apple Pay, Google Pay, підписка, QR-оплата, оплата по токену, двостадійна оплата, розщеплення платежу та інвойс.; LiqPay має партнерські API, пов’язані зі створенням компаній та отриманням інформації про компанії або партнера.; У логах інтеграції не варто виводити: Типовий бізнес-процес:

private key;
повні реквізити банківської картки;
CVV;
паролі;
приватні ключі;
повні персональні інформаційні дані понад необхідний мінімум;
production connection strings;
внутрішні API-ключі;
токени;
конфіденційні фінансові інформаційні дані.; Він не замінює ERP, CRM або інтернет-магазин, а застосовують, коли потрібно як платіжний шлюз для приймання оплат і повернення статусів платежів у бізнес-систему.; # Менеджер знаходить замовлення в K2 ERP.;ДПС

Інвойси

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

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

Журнал обміну потрібен для контролю платіжної інтеграції та швидкого пошуку помилок.; # Номер чека зберігається в ERP.; У документації LiqPay підписка описується як регулярний білінг клієнтів за методом server-server.; # Товар резервується або передається на відвантаження.; # K2 ERP створює документ оплати.; PrivatPay — це спосіб оплати для клієнтів ПриватБанку.; # Покупцю надсилається підтвердження, чек або повідомлення.; # K2 ERP або інтеграційний сервіс формує запит на повернення в LiqPay.; * LiqPay API

істотно: LiqPay — це платіжний сервіс та інтернет-еквайринг.; # За потреби формується фіскальний чек повернення.; це український платіжний сервіс ПриватБанку; додатково реалізовано інтернет-еквайрингу.;== Платіжний віджет ==

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

Рекомендація: власна ERP або інтернет-магазин не повинні зберігати повні інформаційні дані банківської картки.; # LiqPay обробляє платіж.;

Не плутати: повернення коштів у LiqPay і повернення товару в ERP — це різні операції.; :contentReference [oaicite:11]{index=11}

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

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

інтеграційні функціональні можливості LiqPay з K2 ERP

інформаційні дані, які не можна виводити в логах

Зверніть увагу: конкретні функціональні можливості LiqPay залежать від налаштувань компанії, доступних методів оплати, API-доступу, вимог до мерчанта, валюти, типу бізнесу, способу інтеграції та правил банку.; Це спрощує контроль продажів і фінансову звірку.; Callback потрібен для того, щоб ERP, CRM або інтернет-магазин автономно дізнавалися, що платіж успішний, відхилений, скасований або має інший статус.;

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

Публічні API LiqPay

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

Висновок

чи всі успішні платежі потрапили в ERP;
чи всі оплачені замовлення мають документ оплати;
чи немає оплат без замовлення;
чи сума платежу збігається із сумою замовлення;
чи правильна валюта;
чи всі повернення відображені;
чи всі фіскальні чеки створені;
чи немає дублювання callback;
чи всі помилки оброблені.; У документації інтернет-еквайрингу LiqPay інвойс описується як виставлення рахунку на e-mail клієнта у server-server режимі.; # У журналі зберігається технічна відповідь.; :contentReference [oaicite:7]{index=7}

У K2 ERP це має змогу працювати так:

K2 Модуль Magento

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

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

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

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

Загальний характеристика

Інвойс має змогу бути корисним для:

LiqPay має змогу забезпечувати такі функціональні можливості:

Джерела

Модуль Prom

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

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

замовник звертається з поверненням.; # Замовлення передається в K2 ERP.; Для K2 ERP: LiqPay доцільно реалізовувати як окремий платіжний компонент.;Інтеграція з Новою поштою в Python

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

Типовий бізнес-процес повернення платежу має змогу виглядати так: Оплата через QR має змогу використовуватися:

Callback

потрібно підтвердити наявність товару;
сума має змогу змінитися після перевірки замовлення;
потрібне ручне підтвердження менеджера;
оплата списується після комплектації;
сервіс спочатку резервує кошти, а потім підтверджує продаж.; # Замовлення оновлюється в ERP.; Callback — це повідомлення від LiqPay до системи продавця про результат або зміну статусу платежу.; У документації LiqPay додатково є собою окремий напрям для POS-систем, який описується як інтеграційні функціональні можливості POS-системи для приймання оплат через сканування QR-коду.;

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

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

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

Див.; додатково

захищене зберігання private key;
перевірку підпису callback;
HTTPS для callback URL;
права користувачів;
доступ до налаштувань мерчанта;
журнал дій;
захист логів;
обмеження доступу до фінансових операцій;
захист персональних даних покупців;
обробку повторних callback;
контроль підозрілих платежів;
резервне копіювання налаштувань;
розмежування тестового і production-середовища.; # платформа оновлює статус оплати.; :contentReference [oaicite:2]{index=2}

LiqPay підтримує роботу оплату через QR.;

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

Основні функціональні можливості

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

Платіжний віджет надає можливість приймати оплату без повного переходу покупця на окрему сторінку.;== Типові статуси платежів == LiqPay підтримує роботу сценарії приймання платежів через Apple Pay і Google Pay у межах інтернет-еквайрингу.; * Checkout;

платіжний віджет;
оплата карткою;
PrivatPay;
Apple Pay;
Google Pay;
оплата через QR;
інвойс;
повернення платежу;
двостадійна оплата;
регулярні платежі;
оплата по токену;
оплата готівкою через термінали самообслуговування;
розщеплення платежу;
DCC;
отримання статусу платежу;
отримання реєстру платежів;
отримання архіву платежів;
callback-повідомлення;
публічні API;
партнерські API;
POS-інтеграції.; У системі K2 ERP LiqPay має змогу використовуватися як платіжний компонент для онлайн-продажів, інтернет-магазинів, SaaS, маркетплейсів, мобільних застосунків і рахунків на оплату.;Технічне завдання: інтеграція ПРРО Checkbox для Python

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

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

LiqPay має інформаційні API для отримання звітів та інформації про платіж.;== PrivatPay ==

дату і час операції;
напрям обміну;
тип операції;
номер замовлення;
LiqPay payment ID;
суму;
валюту;
статус;
endpoint або API-метод;
текст помилки;
технічну відповідь;
результат перевірки підпису;
користувача або сервіс, який ініціював операцію;
кількість повторних спроб;
результат повторної обробки.; Безпека: у власній ERP або інтернет-магазині не потрібно зберігати повні інформаційні дані банківських карток.; Для продажів фізичним особам має змогу бути потрібна фіскалізація через РРО або ПРРО залежно від законодавства, типу операції, способу оплати й моделі бізнесу.; Основні задачі LiqPay:

Двостадійна оплата — це сценарій, у якому кошти спочатку блокуються на картці клієнта, а списання виконується пізніше.; У документації LiqPay партнерський напрям описується як створення компаній або отримання інформації за існуючими.; # LiqPay надсилає callback у K2 ERP або інтеграційний сервіс.; # Сайт або ERP формує платіжний запит.;B2C

РРО