• Інтеграції · LiqPay API

Інтеграція LiqPay: оплата карткою на сайті

Інтеграція LiqPay — це підключення платіжного шлюзу так, щоб покупець оплатив карткою просто в чекауті, а замовлення саме перейшло у статус оплаченого. Робіт тут чотири: сам шлюз, обробка зворотного виклику з перевіркою підпису, поведінка при перерваному платежі й повернення коштів з адмінки. Кнопка «оплатити» — найпростіша з них, і саме через це решту зазвичай не роблять. Строк — 6–10 робочих днів від отримання ключів. Суму називаємо після безкоштовної перевірки чекауту. Той самий шлюз працює й у чаті: наш LEO Chat виставляє рахунок LiqPay у діалозі, на ключах платіжного провайдера магазину.
Подивитись, як це працює
Вартість
після безкоштовного аудиту
Гарантія
30 днів після підписання акта
Що дивимось першим
реальний чекаут, а не логотипи платіжних систем у підвалі
Вартість
після безкоштовного аудиту
Гарантія
30
днів після підписання акта
Що дивимось першим
реальний чекаут, а не логотипи платіжних систем у підвалі
Перевірка чекауту
безкоштовно, 1–2 робочих дні
Строк підключення
6–10
робочих днів від отримання ключів
Ламається найчастіше
статус після оплати і сценарій перерваного платежу
Як приймаємо роботу
тестовий режим плюс один живий платіж із поверненням
Кому підходить

Ситуації, у яких ця послуга дає результат

Сценарій 1 із 4

Замовлення оформлюється на сайті, а гроші беруть руками

Покупець натиснув «замовити», менеджер надіслав реквізити в месенджер, потім чекає скрін квитанції й перебиває статус у адмінці. На десяти замовленнях це терпимо, на сотні — окрема посада. Картка в чекауті прибирає з цього ланцюжка три кроки й переносить звірку з менеджера на зворотний виклик від шлюзу.

Розберемо вашу ситуацію на безкоштовному аудиті
Кейси

Задачі та результат у цифрах — усі показники зняті нашим виміром

інтернет-магазин натуральної косметики на продуктах бджільництва

Задача
Дати покупцеві оплатити карткою одразу, а не чекати рахунок від менеджера, і не втратити при цьому швидкість сторінки.
Рішення
Магазин на OpenCart: платіжний шлюз, оплата карткою ПриватБанку й післяплата, доставка Новою Поштою. Розмітка Store, Organization, ContactPoint, графік роботи й пошукова дія.
Результат
Вимір 31.07.2026: перша відповідь сервера 126,3 мс, повне завантаження HTML 172,4 мс при 196,3 КБ — найшвидший результат серед 24 виміряних магазинів. Каталог 81 товарна сторінка. Знайдені дефекти: у карті сайту 271 запис на 116 унікальних адрес, окремі товари продубльовані по 2–4 рази; аналітика застаріла — стоїть Universal Analytics, а властивості GA4 немає взагалі, тобто подію покупки нема куди передавати.

інтернет-магазин офіційного продавця садового інструменту

Задача
Обслужити в чекауті і роздрібного покупця з карткою, і компанію з рахунком-фактурою, додавши оплату частинами.
Рішення
Магазин на OpenCart із чотирма способами розрахунку — картковий шлюз, безготівковий рахунок-фактура, готівка при отриманні й оплата частинами — і двома перевізниками. Увімкнено HSTS, дві мовні версії.
Результат
Вимір 31.07.2026: чотири способи розрахунку й два перевізники, HSTS з max-age 31536000. У карті сайту 1 300 унікальних адрес — близько 1 213 карток товару і близько 70 категорій. Перша відповідь сервера 625 мс, повне завантаження 752,5 мс при 350,4 КБ. Знайдений дефект: 4 236 записів у карті сайту на 1 300 реальних адрес — у середньому 3,3 дубля на адресу.

офіційний інтернет-магазин садового інструменту світового бренду

Задача
Тримати в одному чекауті вісім способів розрахунку — від картки до безготівкового з ПДВ і покупки частинами — і не зламати на цьому оформлення.
Рішення
Магазин на OpenCart за HTTP/2 з увімкненим HSTS: картковий шлюз, покупка частинами, оплата за реквізитами, безготівковий з ПДВ, готівка при отриманні, розстрочка. Чотири служби доставки з підписаними логотипами.
Результат
Вимір 31.07.2026: вісім способів оплати й чотири перевізники — найповніший набір серед виміряних магазинів. У карті сайту 8 690 унікальних адрес, з них 8 609 листових сторінок. Перша відповідь 789,4 мс, і в ці мілісекунди входить 301-редирект на мовну гілку. Знайдені дефекти: 33 493 записи в карті сайту на ті самі 8 690 адрес; JSON-LD лише Organization і ContactPoint.
Що входить

Повний перелік робіт і того, що ви отримуєте на виході

  • Підключаємо LiqPay у чекауті: Visa, Mastercard, Apple Pay, Google Pay і Privat24 йдуть одним шлюзом, окремий модуль під кожен спосіб не потрібен
  • Обробляємо зворотний виклик із перевіркою підпису — статус замовлення міняється сам, без менеджера в кабінеті банку
  • Розписуємо сценарій перерваної оплати: покупець повертається на сайт зі збереженим кошиком і може спробувати ще раз
  • Робимо сторінки успішної й невдалої оплати, де написано, що робити далі, а не «сталася помилка»
  • Вмикаємо повернення коштів з адмінки — повне й часткове, без листування з підтримкою шлюзу
  • Заводимо статуси під платіж: очікує оплати, оплачено, скасовано, повернуто — і фіксуємо, що робить кожен
  • Ключі виносимо в змінні оточення, тестовий режим лишаємо перемикачем для подальших перевірок
  • Передаємо подію покупки в GA4 із сумою й номером замовлення — інакше рекламі нема на що спиратись
  • Проганяємо живий платіж на реальну суму й одразу повертаємо його: тестовий режим бойові ключі не перевіряє
  • Пишемо інструкцію менеджеру: де дивитись платіж, як оформити повернення, що робити з «оплата зависла»
  • Гарантійний строк 30 календарних днів на виконані роботи
Коли ця послуга не підходить

Що не входить у роботу — щоб не було сюрпризів на здачі

  • Договір з платіжним провайдером і проходження перевірки — оформлюється на вас
  • Комісії еквайрингу й тарифні домовленості з банком
  • Юридичні тексти: оферта, умови повернення коштів, політика конфіденційності
  • Бухгалтерська звірка платежів і фіскалізація чеків — окремий обсяг робіт
  • Інші платіжні системи в тому ж чекауті — рахуємо окремо
Етапи роботи

Прозорі етапи з погодженням на кожному кроці

Загальний строк:3–10 днів

  1. Прохід чекауту з боку покупця

    1–2 робочих дні

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

  2. Ключі, статуси, тестовий режим

    1 робочий день

    Приймаємо публічний і приватний ключі, виносимо їх у змінні оточення, заводимо статуси замовлення під платіж і домовляємось, який статус що означає для вашого менеджера.

  3. Шлюз і зворотний виклик

    1–3 робочих дні

    Підключаємо оплату в чекауті й пишемо обробник відповіді шлюзу з перевіркою підпису та захистом від повторної обробки того самого платежу.

  4. Сценарії помилок і повернення коштів

    1–2 робочих дні

    Перервана оплата зі збереженим кошиком, повторна спроба, сторінки успіху й відмови з людським текстом, повне й часткове повернення з адмінки.

  5. Подія покупки в аналітиці

    1 робочий день

    Передаємо покупку в GA4 через Tag Manager із сумою й номером замовлення, перевіряємо, що подія не дублюється при оновленні сторінки подяки.

  6. Живий платіж і передача

    1 робочий день

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

Безкоштовний аудит

Безкоштовна перевірка сценарію оплати

Оплату міряємо з боку покупця, а не з боку коду: кладемо товар у кошик, оформлюємо як гість і дивимось, які способи сайт справді пропонує на кроці розрахунку. Потім звіряємо цей список із тим, що написано на сторінці «Оплата і доставка». Розбіжність трапляється частіше, ніж здається власникам.

Що ми міряємо

  1. Що реально доступно в чекаутіУ виміряному магазині нижньої білизни логотипи privat24, visa і liqpay стояли в підвалі сайту, а на кроці розрахунку було рівно два методи — обидва з оплатою при отриманні. Перевірили на всіх чотирьох способах доставки: карткового платежу немає взагалі.
  2. Що відбувається після успішної оплатиЧи міняється статус замовлення сам, чи менеджер звіряє платежі руками у виписці. Друге працює на десяти замовленнях і розсипається на сотні.
  3. Що відбувається при невдалій оплатіКуди потрапляє покупець, чи лишається кошик, чи може він спробувати ще раз. Найдешевше місце, де магазини втрачають уже готові замовлення.
  4. Зворотний виклик і його підписЧи звіряє сайт підпис відповіді шлюзу своїм приватним ключем. Без цієї звірки статус «оплачено» теоретично виставляється ззовні, без грошей.
  5. Повернення коштівЧи оформлюється повернення з адмінки й чи є під це письмова процедура у вашого менеджера. Зазвичай немає ні того, ні того.
  6. Чи є куди приземлити подію покупкиДивимось, який лічильник стоїть на сайті. У виміряному магазині косметики працює Universal Analytics, яку Google вимкнув 1 липня 2023 року, а властивості GA4 немає — оплату підключити можна, порахувати її нічим.

Що ви отримуєте

  • Список способів оплати, доступних у справжньому чекауті, поруч зі списком з інформаційної сторінки.
  • Перелік необроблених сценаріїв: невдала оплата, повторна спроба, часткове повернення.
  • Стан аналітики: чи є куди передавати подію покупки.
  • Оцінку робіт і строку з поділом на обов'язкове й бажане.
  • Розмову на 20–30 хвилин із вами або вашим бухгалтером по цьому списку.

Строк: 1–2 робочих дні від моменту, коли ми отримали адресу сайту

Чому це безкоштовно

Бо прохід чекауту займає в нас години, а помилка в статусах замовлень коштує вашому менеджеру щоденної ручної звірки. Дешевше показати цифри й назвати суму один раз. Список лишається вам у будь-якому разі — навіть якщо підключати оплату ви передумаєте.

Що далі

Далі — кошторис на конкретний перелік робіт зі строком по етапах, договір, рахунок, акт.

Коротка форма: контакт і адреса сайту
Договір і документи

Працюємо офіційно

Договір, акт і рахунок — на кожен проєкт, а не тільки на великий. Без документів у вас немає ні прав на роботу, ні підстави провести витрати.

Нам довіряють6 брендів

Нам довіряють: Kvant Energy, GYPSUN, Naturel Cosmetics, Pancer Protection, LUGI, BeeTech

Умови, зафіксовані письмово8 пунктів

  • Договір, акт і гарантія 30 днів

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

  • ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • Права й доступи — ваші

    Код, дизайн і матеріали переходять до вас після повної оплати. Домен, хостинг, репозиторій, аналітику оформлюємо на вас.

  • Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

  • Договір, акт і гарантія 30 днів

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

  • ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • Права й доступи — ваші

    Код, дизайн і матеріали переходять до вас після повної оплати. Домен, хостинг, репозиторій, аналітику оформлюємо на вас.

  • Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

NDA підписуємо на запит. Після завершення співпраці наші доступи до ваших сервісів видаляємо самі.

Не знайшли свій випадок?

Опишіть, як це влаштовано у вас, — відповімо, чи підходить «Інтеграція LiqPay» і що це означає у вашій ситуації. Без брифу й без дзвінка: одне питання, одна відповідь.

Що впливає на вартість

Чому дві однакові на вигляд задачі рахуються по-різному

  • Стан статусів замовленняЯкщо в магазині живуть лише «новий» і «виконано», під платіж доводиться заводити ще чотири й вирішувати, що робить кожен: чи знімає товар із залишку, чи шле лист покупцю. Це розмова з вашим менеджером, і вона займає більше часу, ніж сам шлюз.
  • Платформа й спосіб підключенняКоробковий модуль під OpenCart або WooCommerce ставиться й налаштовується за день. Чекаут, дописаний руками, або власний фронтенд на Next.js потребують свого обробника зворотного виклику — це вже написання коду, а не встановлення.
  • Скільки сценаріїв закриваємоТільки успішна оплата — це мінімум. Перервана оплата з поверненням кошика, повторна спроба, часткове повернення, платіж, що прийшов із затримкою, — кожен пункт має свою гілку в коді й свою перевірку.
  • Стан аналітикиПодію покупки треба кудись передати. Якщо на сайті висить мертва Universal Analytics і властивості GA4 немає, спершу ставимо аналітику, і це окремий рядок кошторису. Лічильник сам по собі нічого не покращує — він лише дає побачити.
  • Скільки способів оплати стоятиме поручКожен додатковий спосіб — свій статус, свій сценарій повернення, свій абзац в інструкції менеджера і своя комісія. Тому кількість способів не самоціль: рахуємо ті, якими платить ваш сегмент.
Технології та інтеграції

На чому будуємо і з чим це з'єднується

Стек

  • LiqPay API — один шлюз закриває Visa, Mastercard, Apple Pay, Google Pay і Privat24; межа: тарифи, ліміти й строки виплат визначає банк, не інтеграція
  • Перевірка підпису: signature = base64(sha1(приватний ключ + data + приватний ключ)) — без звірки статус «оплачено» виставляється ззовні
  • OpenCart 3 і 4 — модулі коробкові, але збірка під 4.x є не в кожного постачальника; версію фіксуємо до старту
  • WooCommerce — офіційний плагін; правки в ньому переживають не кожне оновлення, тому виносимо їх окремо
  • Next.js — обробник зворотного виклику пишеться руками на серверному маршруті; це довше за встановлення модуля
  • HTTPS + HSTS — по HTTP шлюз відповідь не надішле, а браузер попереджає покупця саме на введенні картки
  • Змінні оточення для ключів — приватний ключ у репозиторії дорівнює втраченому ключу

Інтеграції

  • LiqPay
  • Visa / Mastercard
  • Apple Pay / Google Pay
  • Privat24
  • післяплата як паралельний сценарій
  • GA4 — подія покупки
  • Google Tag Manager
  • KeyCRM
Шлюз у чекауті проти переказу за реквізитами

Чим цей варіант відрізняється від альтернативи

Реквізити в месенджеріНаш підхід
Хто підтверджує оплатуменеджер, за скріном квитанції з випискизворотний виклик шлюзу, автоматично
Коли покупець платитьпісля відповіді менеджера — від хвилин до наступного дняодразу, поки рішення ще гаряче
Ціна помилки в статусіпереплутане замовлення знаходять на звірці наприкінці місяцястатус ставить код, помилка відтворювана й лагодиться
Повернення коштівручний переказ і листування з покупцемкнопка в адмінці, повне або часткове
Витратикомісії немає, але є час менеджера на кожне замовленнякомісія еквайрингу з кожного платежу
Що потрібно від вас

Без цього не почнемо — краще підготувати заздалегідь

  1. Публічний і приватний ключі з кабінету платіжного провайдера — видають вам, не підряднику.
  2. Доступи до сайту й адмінки з правом установлювати модулі.
  3. Рішення, які статуси замовлення означають оплачений і скасований платіж.
  4. Юридичні тексти про повернення коштів: вони мають бути на сайті до запуску оплати.
  5. Товар на невелику суму, на якому ми проведемо живий платіж і повернення.
  6. Менеджера або бухгалтера, який працюватиме з поверненнями після передачі.
Якщо чогось із цього немає — скажіть, підкажемо, як зібрати або зробимо самі окремою задачею.
Часті питання

Те, що питають найчастіше — з конкретними відповідями

у підвалі сайту вже стоять іконки Visa і платіжного шлюзу — оплата ж підключена?

Не обов'язково, і це найпоширеніша ілюзія. У виміряному нами магазині нижньої білизни в підвалі висіли логотипи privat24, visa і платіжного шлюзу, а в реальному чекауті було рівно два способи — обидва «оплата при отриманні». Ми перевірили це на всіх чотирьох способах доставки, тобто картковий платіж на сайті не підключений узагалі. Логотип у підвалі — картинка, вона нічого не вмикає. Тому перевірку ми починаємо не з коду, а з проходу чекауту: товар у кошик, гостьове оформлення, запит списку доступних методів.

навіщо перевіряти підпис зворотного виклику, якщо адресу обробника ніхто не знає?

Бо саме зворотний виклик каже сайту «гроші прийшли», а адреса обробника видима в коді сторінки оплати. LiqPay надсилає два поля: data — закодований JSON із сумою й статусом, і signature, який рахується як base64(sha1(приватний ключ + data + приватний ключ)). Обробник має перерахувати підпис своїм ключем і зіставити. Якщо цього немає, будь-хто може надіслати «оплата успішна» і отримати замовлення зі статусом оплаченого без грошей. У коробкових модулях звірка зазвичай є, у дописаних руками обробниках — зазвичай немає.

що буде, якщо покупець перервав оплату на півдорозі?

Має повернутися на сайт зі збереженим кошиком і зрозумілим повідомленням. Сценарій, який ми бачимо регулярно: порожня сторінка помилки, очищений кошик, замовлення в адмінці в невизначеному статусі й менеджер, який не знає, дзвонити чи ні. Частина цих людей просто йде, і це найдорожча втрата в магазині — вона трапляється після того, як покупець уже сказав «так». Обробка перерваного платежу входить у роботу, а не рахується окремим рядком.

як ви переконуєтесь, що оплата справді працює?

Тестовий режим показує, що код не падає, і не більше. Бойові ключі, реальні ліміти й реальна поведінка банку в ньому не перевіряються. Тому наша рекомендація й наша практика: після тестів робимо живий платіж реальною карткою на невелику суму, дивимось, як статус замовлення міняється сам, і одразу оформлюємо повернення з адмінки. Дві операції за десять хвилин закривають питання, яке інакше вилазить на першому клієнті. Ще одна рекомендація: не вимикайте післяплату в перший місяць — вона страхує вас, поки збирається статистика.

чи обов'язково взагалі вмикати онлайн-оплату?

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

скільки способів оплати варто тримати в чекауті?

Стільки, скільки ви готові обслуговувати. У виміряних магазинах ми бачили від двох до десяти. Найповніший набір — вісім способів і чотири перевізники в магазині садового інструменту; поруч магазин того ж профілю живе на чотирьох способах, включно з рахунком-фактурою й оплатою частинами. Чесна межа: десять логотипів самі по собі не продають. Значення має наявність саме тих способів, якими платить ваш сегмент, а кожен зайвий додає комісію, статус і рядок у звірці. Робоча база для роздробу — картка плюс післяплата, далі за потребою.

як я побачу, скільки замовлень оплачують карткою?

Через подію покупки в GA4 із сумою й номером замовлення — її ми передаємо в межах робіт. Але передавати треба кудись: у виміряному магазині косметики на сайті працює Universal Analytics, яку Google вимкнув 1 липня 2023 року, а властивості GA4 немає взагалі. Аналітика виглядає робочою і мертва третій рік. Такі речі видно на перевірці до початку робіт. І окрема межа: GA4 показує тенденцію, а не бухгалтерську істину — зводити його цифри з кабінетом шлюзу треба свідомо, розбіжність у кілька відсотків там нормальна.

скільки це триває і що входить у гарантію?

6–10 робочих днів від отримання ключів. Розкладка: прохід чекауту 1–2 дні, ключі й статуси 1, шлюз і зворотний виклик 1–3, сценарії помилок і повернень 1–2, подія покупки 1, живий платіж і передача 1. Довше буває тоді, коли в замовленні немає потрібних статусів і їх заводять разом з інтеграцією. Гарантійний строк — 30 календарних днів після приймання: помилки з нашого боку виправляємо безкоштовно. Це не покриває нових доробок, зміни тарифів банку й наслідків самостійних правок у коді.

Почніть із проходу чекауту, а не з кошторису

Дайте адресу сайту — за 1–2 робочих дні повернемось зі списком способів оплати, які справді доступні покупцеві, переліком необроблених сценаріїв і оцінкою робіт. Якщо картка вам зараз не потрібна, почуєте це першим листом.

З виміряних кейсівВимір 31.07.2026: перша відповідь сервера 126,3 мс, повне завантаження HTML 172,4 мс при 196,3 КБ

Дивитись кейси
  • Відповідь протягом 2 годин
  • Без зобов’язань
  • Працюємо за договором

Прайса на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази, і цифра «від» у такому разі нічого не пояснює. Спершу безкоштовний аудит — рахуємо ваші сторінки, дублі й швидкість, — потім називаємо суму й строк і фіксуємо їх у договорі.