LiqPay — платіжний сервіс PrivatBank. Коли він підтверджує оплату на своїй стороні, CRM перевіряє підпис callback, фіксує результат у замовленні й синхронізує його статус.
Як працює
Callback оплати
LiqPay шле data/signature на endpoint адаптера.
Запис платежу
Створюється crm_order_payments із сумою й статусом.
Оновлення статусу
Замовлення переходить у «Підтверджено», якщо було «Очікує».
Безпека
- Перевірка обох варіантів з офіційної callback-документації LiqPay: base64 SHA3-256 у формулі та base64 SHA1 у виконуваних прикладах
- Без зберігання даних картки (PAN/CVV)
- Private key лише для підпису — не повертається в UI
- Прив'язка до замовлення за order_id
Необовʼязкова тестова валідація
Після збереження private key callback працює одразу — тест не активує і не блокує адаптер. За бажанням у налаштуваннях можна згенерувати підписаний payload і локально перевірити секрет та формат без запису платежу.
Підключення
- 1
Додайте адаптер LiqPay
Вкажіть private key і створіть адаптер. Унікальний callback URL зʼявиться лише на сторінці створеного адаптера.
- 2
Передавайте URL як server_url
Додавайте згенерований URL у server_url кожного LiqPay Checkout/payment-запиту. result_url — інший параметр: він повертає браузер покупця.
- 3
За бажанням перевірте локально
Згенеруйте тестовий payload і підтвердьте підпис. Це діагностика, а не умова прийому реальних callback-ів.
Часті запитання
Чи зберігаються дані картки?
Ні. Ми зберігаємо лише статус, суму й ідентифікатор транзакції — без PAN/CVV.
Як знайти потрібне замовлення?
За order_id з callback зіставляється externalId замовлення в CRM.
Чи може CRM створити або повернути платіж LiqPay?
Ні. Цей adapter лише приймає підписані callback-и й записує їх результат. Checkout, списання, hold, refund і перевірка статусу через API залишаються у storefront або кабінеті LiqPay.
Підключіть LiqPay
Підтверджені статуси оплат синхронізуються із замовленням автоматично.
Почати безкоштовно