Так. Krokul CRM інтегрується з LiqPay. З угоди Krokul формує сторінку оплати LiqPay з order_id угоди, а колбек LiqPay на server_url після перевірки підпису проводить планову оплату фактом. Зв’язку будують через API і вебхуки Krokul.
Менеджер натискає «Посилання на оплату» в угоді. Krokul складає checkout LiqPay з action pay, сумою й валютою планової оплати, описом і order_id, що веде на угоду, підписує data приватним ключем магазину й дає клієнту посилання на сторінку оплати.
Після оплати LiqPay надсилає на server_url поля data і signature. Krokul перевіряє підпис, декодує data, знаходить угоду за order_id і для статусу success проводить план фактом. Подія payment.received іде в облік, а повне покриття рахунку дає invoice.paid.
Krokul зберігає payment_id LiqPay як зовнішній ключ оплати. Повторний колбек з тим самим payment_id знаходить уже проведену оплату й другого факту не створює.
Колбек зі статусом reversed означає, що LiqPay повернув гроші. Krokul записує повернення в угоду, зменшує оплачене й лишає запис у стрічці, щоб бухгалтер бачив причину розбіжності з рахунком.
Статуси failure і error лишають оплату плановою, а в стрічці угоди з’являється запис про невдалу спробу. Менеджер бачить, що клієнт пробував платити, і може запропонувати інший спосіб.
| LiqPay | Напрям | Krokul | Коли |
|---|---|---|---|
| Checkout: action pay, amount, currency, description, order_id, server_url | Krokul → LiqPay | Планова оплата угоди | Менеджер створює посилання на оплату |
| Колбек на server_url зі статусом success | LiqPay → Krokul | Оплата-факт угоди, подія payment.received | Клієнт оплатив |
| payment_id | LiqPay → Krokul | Зовнішній ключ оплати | Під час першого колбека |
| Колбек зі статусом reversed | LiqPay → Krokul | Повернення в угоді, запис у стрічці | Після повернення коштів |
| Колбек зі статусом failure або error | LiqPay → Krokul | Запис про невдалу спробу, план лишається відкритим | Оплата не пройшла |
payment/api-create з cardUuid угоди й прив’язує payment_id LiqPay до оплати через externalRef/api-set.payment.received та invoice.paid, щоб облік дізнавався про гроші. Доставка несе заголовок x-crm-signature, і ваш приймач перевіряє його секретом.Krokul рахує base64 від хешу рядка private_key + data + private_key, як описано в документації LiqPay. Колбек без правильного підпису Krokul відхиляє й нічого не проводить.
Krokul зберігає payment_id як зовнішній ключ оплати. Повторний колбек з тим самим payment_id другого факту не створює.
Запис у стрічці угоди зі статусом LiqPay. Планова оплата лишається відкритою, і менеджер може надіслати нове посилання.
Повернення коштів і скасування оплати робиться в кабінеті LiqPay або через його API, а Krokul отримує результат колбеком зі статусом reversed. Регулярні платежі й донати (дії subscribe і paydonate) лишаються в LiqPay, а для оплати угоди Krokul використовує дію pay.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
LiqPay є торговою маркою її власника. Krokul не афілійований із LiqPay.