Що знадобиться
- Бізнес-акаунт LiqPay (liqpay.ua), підключений до вашого банку.
- Схвалення LiqPay для вашого типу діяльності (перевіряється при реєстрації акаунта).
Покрокова інструкція
- 1Увійдіть у бізнес-кабінет LiqPay
Відкрийте liqpay.ua, увійдіть під своїм акаунтом (той самий, яким користуєтесь для приймання оплат).
liqpay.ua → Вхід
- 2Відкрийте розділ API
У кабінеті перейдіть Мій бізнес → API. Там показані Публічний ключ (public_key) і Приватний ключ (private_key) вашого магазину.
Мій бізнес → API
- 3Скопіюйте обидва ключі
Публічний ключ можна показувати будь-де (він не секретний), Приватний ключ — тримайте в таємниці, саме він підписує запити.
💡 Якщо ключів ще немає — LiqPay видає їх одразу після підтвердження реєстрації акаунта. - 4Вставте ключі у CRM
Налаштування → Інтеграції → Платіжні шлюзи → LiqPay. Вставте Публічний і Приватний ключ, натисніть «Підключити».
- 5За потреби увімкніть тестовий режим
Позначка «Тестовий режим (sandbox)» дозволяє перевірити повний цикл оплати без реального списання грошей — LiqPay використовує ті самі ключі, лише позначає запит як тестовий.
💡 Не забудьте зняти позначку перед реальним використанням — інакше клієнти не зможуть оплатити насправді. - 6Поставте LiqPay у каскад оплат
Каскад — це порядок, у якому клієнт бачить способи оплати на сторінці рахунку: перший у списку буде головною кнопкою, решта — «або оплатити через …». Якщо створити платіж у першому шлюзі не вдалось, сторінка одразу підсвітить наступний.
Налаштування → ФОП → Профіль ФОП → Каскад платіжних шлюзів (для всього воркспейсу — Налаштування → Інтеграції → Платіжні шлюзи → Дефолтний каскад воркспейсу)
💡 Зміна порядку діє лише на НОВІ рахунки: уже надісланий рахунок назавжди несе той каскад, що діяв на момент його створення.
Куди що вставляти
| Поле у формі | Що вставити |
|---|---|
| Публічний ключ | public_key з розділу Мій бізнес → API у кабінеті LiqPay. |
| Приватний ключ | private_key з того ж розділу — тримайте в таємниці. |
| Тестовий режим (sandbox) | Позначте лише на час перевірки інтеграції. |
Часті питання
Ні — LiqPay використовує ОДНІ Й ТІ САМІ ключі для реальних і тестових платежів, різницю робить лише позначка «Тестовий режим» у запиті. Реальні гроші не списуються, поки цю позначку увімкнено.
Ні. Приватний ключ ніколи не передається в браузер — CRM використовує його лише на сервері для підпису запитів і перевірки підтверджень оплати.
Так і має бути. Каскад «фотографується» в момент створення рахунку, тож зміна пріоритету застосовується лише до нових рахунків і посилань на оплату. Уже виданий рахунок лишається з тим набором способів, який бачив клієнт від початку.
У каскад можна поставити лише ПІДКЛЮЧЕНІ шлюзи: LiqPay і Monobank — після збереження ключів у «Платіжних шлюзах», решту — після активації в інфраструктурі (напишіть у підтримку). Відкликаний креденшл прибирає шлюз із каскаду при наступному збереженні.