• Интеграции · LiqPay API

Интеграция LiqPay: оплата картой на сайте

Интеграция LiqPay – это подключение платежного шлюза так, чтобы покупатель оплатил картой прямо в чекате, а заказ именно перешел в статус оплаченного. Работ здесь четыре: сам шлюз, обработка обратного вызова с проверкой подписи, поведение при прерванном платеже и возврат средств из админки. Кнопка «оплатить» — самая простая из них, и именно поэтому остальные обычно не делают. Срок – 3–10 рабочих дней от получения ключей. Сумму называем после бесплатной проверки чекаута.

Посмотреть, как это работает
Стоимость
после бесплатного аудита
Гарантия
30 дней после подписания акта
Что смотрим первым
реальный жут, а не логотипы платежных систем в подвале
после бесплатного аудита
Стоимость
30
Гарантия

дней после подписания акта

реальный жут, а не логотипы платежных систем в подвале
Что смотрим первым
бесплатно, 1–2 рабочих дня
Проверка чекаута
3–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: восемь способов оплаты и четыре перевозчика – самый полный набор среди измеренных магазинов. В карте сайта 8690 уникальных адресов, из них 8609 листовых страниц. Первый ответ 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 рабочий день

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

Бесплатная проверка сценария оплаты

Оплату меряем со стороны покупателя, а не со стороны кода: кладем товар в корзину, оформляем как гость и смотрим, какие способы сайт действительно предлагает на шаге расчета. Затем сверяем этот список с тем, что написано на странице Оплата и доставка. Разница происходит чаще, чем кажется владельцам.

Что мы измеряем

  • Что реально доступно в чекатеВ измеренном магазине нижнего белья логотипы privat24, visa и liqpay стояли в подвале сайта, а на шаге расчета было ровно два метода – оба с оплатой при получении. Проверили на всех четырех способах доставки: карточного платежа нет вообще.
  • Что происходит после успешной оплатыМеняется ли статус заказа сам или менеджер сверяет платежи руками в выписке. Второе работает по десяти заказам и рассыпается на сотни.
  • Что происходит при неудачной оплатеКуда попадает покупатель, остается корзина, может ли он попробовать еще раз. Дешевое место, где магазины теряют уже готовые заказы.
  • Обратный вызов и его подписьСверяет ли сайт подпись ответа шлюза своим частным ключом. Без этой сверки статус «оплачен» теоретически выставляется извне, без денег.
  • Возврат средствОформляется ли возвращение из админки и есть ли под это письменная процедура вашего менеджера. Обычно нет ни того, ни того.
  • Есть ли куда приземлить событие покупкиСмотрим, какой счетчик стоит на сайте. В измеренном магазине косметики работает Universal Analytics, которую Google отключил 1 июля 2023 года, а свойства GA4 нет – оплату подключить можно, посчитать ее нечем.

Что вы получаете

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

Срок: 1–2 рабочих дня с момента, когда мы получили адрес сайта

Почему это бесплатно

Ибо проход чекаута занимает у нас часы, а ошибка в статусах заказов стоит вашему менеджеру ежедневной ручной сверки. Дешевле показать цифры и назвать сумму один раз. Список остается в любом случае — даже если подключать оплату вы передумаете.

Что дальше

Далее – смета на конкретный перечень работ со сроком по этапам, договор, счет, акт.

Короткая форма: контакт и адрес сайта

  • Договор, акт и гарантия 30 дней

    На каждый проект письменный договор: объём, сроки, сумма, порядок приёмки. После сдачи — акт и счёт, затем 30 календарных дней гарантии.

  • ФОП и безналичный расчёт

    Исполнитель — зарегистрированный ФОП. Оплата на счёт с закрывающими документами.

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

    Код, дизайн и материалы переходят к вам после полной оплаты. Домен, хостинг, репозиторий оформляем на вас.

  • Портал клиента вместо переписки

    Во время работы вы получаете доступ к порталу: договоры, счета, акты и статус проекта в одном месте.

  • Заказчики из Европы

    Среди работ — проекты для Норвегии, Болгарии, Молдовы и Испании.

  • Цифры, которые можно проверить

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

  • Сначала аудит, потом сумма

    Прайса на сайте нет намеренно: объём одной и той же работы у двух клиентов отличается кратно.

  • Говорим «нет», когда не уверены

    Если задача не наша или срок нереальный — скажем сразу.

Не нашли свой случай?

Опишите, как это устроено у вас, — ответим, подходит ли «Интеграция 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 показывает тенденцию, а не бухгалтерскую истину — сводить его цифры с кабинетом шлюза нужно сознательно, расхождение в несколько процентов там нормальное.

Сколько это длится и что входит в гарантию?

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

Начните с прохода чекаута, а не со сметы

Дайте адрес сайта — за 1–2 рабочих дня вернемся со списком способов оплаты, действительно доступных покупателю, перечнем необработанных сценариев и оценкой работ. Если карта вам сейчас не нужна, услышите это первым письмом.

Из измеренных кейсовИзмерение 31.07.2026: первый ответ сервера 126,3 мс, полная загрузка HTML 172,4 мс при 196,3 КБ

Смотреть кейсы
  • Ответ в течение 2 часов
  • Без обязательств
  • Работаем по договору

Прайса на сайте нет намеренно: объём той же работы у двух клиентов отличается в разы, и цифра «от» в этом случае ничего не объясняет. Сначала бесплатный аудит — считаем ваши страницы, дубли и скорость, — потом называем сумму и срок и фиксируем их в договоре.