LiqPay

Apple Pay і Google Pay

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

конкурентні переваги LiqPay

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ДПС

РРО

інтеграційні функції ERP LiqPay з K2 ERP

LiqPay підтримує оплату через QR. LiqPay — це платіжний сервіс ПриватБанку для приймання онлайн-оплат, інтернет-еквайрингу, платежів у застосунках, QR-оплат, інвойсів, регулярних платежів і повернень. :contentReference [oaicite:3]{index=3} Tilda Commerce

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

у фізичних точках продажу;
у кафе й ресторанах;
у сервісних точках;
у кур’єрській доставці;
у POS-системах;
у змішаних online/offline-сценаріях. # K2 ERP формує платіжний запит LiqPay. :contentReference [oaicite:1]{index=1}

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

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

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

Журнал обміну потрібен для контролю платіжної інтеграції та швидкого пошуку помилок. # Покупець оформлює замовлення на сайті.== Звірка платежів ==

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

У K2 ERP статус платежу здатна оновлювати: Для якісної інтеграції з LiqPay в ERP бажано зберігати:

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

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

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

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

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

LiqPay підтверджує успішну оплату. :contentReference [oaicite:10]{index=10}

Для облікової системи: LiqPay-платіж бажано зв’язувати не лише із замовленням, а й із документом оплати, фіскальним чеком, доставкою і поверненням. Для K2 ERP: LiqPay доцільно реалізовувати як окремий платіжний компонент. # Замовлення передається в K2 ERP. Двостадійна оплата — це сценарій, у якому кошти спочатку блокуються на картці клієнта, а списання виконується пізніше. У документації вказано, що публічні API можуть використовуватися без реєстрації, зокрема для отримання курсів валют ПриватБанку та архіву курсів. # Чек надсилається покупцю.

PrivatPay здатна використовуватися для:

Звірка здатна перевіряти:

SaaS-підписок;
сервісних тарифів;
щомісячної оплати;
доступу до онлайн-платформи;
абонентського обслуговування;
періодичних платежів клієнтів. :contentReference [oaicite:11]{index=11}

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

Інвойси

Callback

потрібно підтвердити наявність товару;
сума здатна змінитися після перевірки замовлення;
потрібне ручне підтвердження менеджера;
оплата списується після комплектації;
сервіс спочатку резервує кошти, а потім підтверджує продаж. # платформа перевіряє початковий платіж LiqPay. # За потреби виконується фіскалізація через РРО або ПРРО.Технічне завдання: інтеграція ПРРО Checkbox для Python

Див. так само

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

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

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

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

повторної оплати без повторного введення картки;
підписок;
збережених способів оплати;
оплати по токену;
зменшення обсягу платіжних даних, які обробляє власна платформа. У документації інтернет-еквайрингу LiqPay інвойс описується як виставлення рахунку на e-mail клієнта у server-server режимі.

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

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

LiqPay підтримує сценарії регулярного білінгу. Для цього мають використовуватися захищені механізми платіжного сервісу. # Чек передається в РРО або ПРРО. LiqPay так само має публічні API. Такий підхід здатна бути зручним для інтернет-магазинів і сервісів, які хочуть зберегти користувача в межах власного інтерфейсу.== Можливі помилки під час інтеграції ==

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

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

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

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

Повернення платежу застосовується для, коли потрібно повернути покупцю кошти на 100% або частково. це український платіжний сервіс ПриватБанку; так само реалізовано інтернет-еквайрингу. Це спрощує контроль продажів і фінансову звірку. * ідентифікатор мерчанта;

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

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

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

ЕДО

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

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

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

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

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

OpenCart

PrivatPay — це спосіб оплати для клієнтів ПриватБанку. # K2 ERP створює документ оплати. * статус замовлення;

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

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

LiqPay здатна використовуватися для виставлення рахунку клієнту. Він не замінює ERP, CRM або інтернет-магазин, а застосовують, коли потрібно як платіжний шлюз для приймання оплат і повернення статусів платежів у бізнес-систему. Для повторних платежів потрібно використовувати безпечні механізми токенізації, які надає платіжний сервіс. # Сайт або ERP формує платіжний запит. # Покупець оплачує замовлення. Регулярні платежі можуть використовуватися для:

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

Такі методи зручні для покупців, які хочуть оперативно оплатити замовлення без ручного введення реквізитів картки. У документації LiqPay партнерський напрям описується як створення компаній або отримання інформації за існуючими. Він має створювати платіж, приймати callback, перевіряти підпис, оновлювати статус замовлення, створювати оплату і запускати фіскалізацію за правилами бізнесу. # Товар резервується або передається на відвантаження. :contentReference [oaicite:6]{index=6}

Висновок

Типовий бізнес-процес:

K2 Модуль Wix

LiqPay підтримує сценарії приймання платежів через Apple Pay і Google Pay у межах інтернет-еквайрингу. # K2 ERP перевіряє підпис callback. * суму платежу;

валюту;
номер замовлення;
SEO-опис платежу;
redirect URL;
callback URL;
статус платежу;
результат оплати;
помилки оплати. Для продажів фізичним особам здатна бути потрібна фіскалізація через РРО або ПРРО залежно від законодавства, типу операції, способу оплати й моделі бізнесу. :contentReference [oaicite:8]{index=8}

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

створено платіж;
очікує оплати;
у процесі;
успішно оплачено;
відхилено;
скасовано;
повернено;
частково повернено;
помилка;
очікує підтвердження;
заблоковано;
списано. :contentReference [oaicite:2]{index=2}

Безпека: у власній ERP або інтернет-магазині не потрібно зберігати повні інформаційні дані банківських карток.== Загальний SEO-опис ==

Модуль Prom

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

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

Такий підхід здатна бути корисним, коли: Рекомендація: платіжний компонент має бути ідемпотентним. :contentReference [oaicite:9]{index=9} Рекомендація: власна ERP або інтернет-магазин не повинні зберігати повні інформаційні дані банківської картки. LiqPay має інформаційні API для отримання звітів та інформації про платіж. У K2 ERP статуси LiqPay бажано зіставити з внутрішніми статусами оплат і замовлень.== Типові статуси платежів ==

PrivatPay

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

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

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

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

B2C

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

чи всі успішні платежі потрапили в ERP;
чи всі оплачені замовлення мають документ оплати;
чи немає оплат без замовлення;
чи сума платежу збігається із сумою замовлення;
чи правильна валюта;
чи всі повернення відображені;
чи всі фіскальні чеки створені;
чи немає дублювання callback;
чи всі помилки оброблені. # Менеджер знаходить замовлення в K2 ERP. :contentReference [oaicite:0]{index=0}

клієнт ERP звертається з поверненням. # Замовлення оновлюється в ERP. :contentReference [oaicite:4]{index=4}

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

== Джерела ==