Собственная CRM или ERP, в которой заказы живут отдельно от денег, быстро становится неудобной: менеджер отправляет клиенту реквизиты, ждёт скриншот перевода, потом вручную ставит «оплачено». Онлайн-эквайринг это убирает: система создаёт счёт, клиент платит по ссылке, статус меняется сам. Для украинского бизнеса чаще всего рассматривают два сервиса: monobank (plata by mono) и LiqPay от ПриватБанка.
Короткий ответ такой. Подключение состоит из пяти частей: счёт с внутренним референсом заказа, ссылка на оплату, вебхук со статусом, проверка его подписи, а также обязательная сверка статусов отдельным запросом и отдельные возвраты. Это несложно, но в каждой части есть мелочи, на которых теряют деньги: дубли вебхуков, оплата без заказа, частичный возврат, подпись, которую никто не проверяет. Мы в Lytvynov Production строим такие модули в CRM и ERP на заказ, а опыт с платежами у нашего основателя не теоретический: Антон Литвинов был senior back-end разработчиком платёжных интеграций для более чем 30 сайтов знакомств Meetic (Match Group) и руководил созданием двух платёжных продуктов в Anycommerce, подробнее на странице фракционный CTO.
Все факты об API ниже взяты с официальных страниц: документации monobank на api.monobank.ua, страниц liqpay.ua и monobank.ua, проверено 2026-11-19. Где они расходятся или неполны, мы это отмечаем.
Сравнение monobank и LiqPay по официальным страницам
| Параметр | monobank (plata by mono) | LiqPay |
|---|---|---|
| Комиссия (проверено 2026-11-19) | 1,3% за оплату украинскими картами, 2% из-за границы; для новых клиентов акция: 0% на первые 30 дней при подключении с 1 ноября по 31 декабря (monobank.ua/e-comm) | Стандартный тариф 1,3% за украинские карты, 2% за зарубежные; есть индивидуальный тариф по запросу (liqpay.ua/tariffs) |
| Создание платежа | POST /api/merchant/invoice/create: сумма в минимальных единицах (копейки), валюта по ISO 4217, по умолчанию 980, merchantPaymInfo с референсом, redirectUrl, webHookUrl |
Параметры data (base64 от JSON) и signature; обязательны версия API, публичный ключ, действие, сумма, валюта (USD, EUR, UAH), описание и уникальный order_id до 255 символов |
| Срок действия счёта | По умолчанию 24 часа, меняется параметром validity |
Параметр expired_date в запросе |
| Вебхук | Отдельный webHookUrl: до 3 попыток POST, пока ответ не 200; подпись в заголовке X-Sign (ECDSA), публичный ключ берётся из /api/merchant/pubkey |
server_url: POST с двумя параметрами, data и signature |
| Проверка статуса без вебхука | GET /api/merchant/invoice/status?invoiceId=... |
Отдельный метод API статуса платежа |
| Возврат | POST /api/merchant/invoice/cancel, полный или частичный (параметр amount), с extRef для идемпотентности на вашей стороне |
API возврата, полный или частичный, на карту, с которой платил клиент |
| Холд (блокировка суммы) | Тип hold, срок 9 дней, дальше отменяется, если не финализировано |
Действие hold (блокировка средств) |
| Повторные платежи | Токенизация карты (по запросу через службу заботы monobank, по умолчанию недоступна) и оплата по токену | Действие subscribe (регулярный платёж) и card_token для оплаты в один клик |
| Фискализация | Связка с ПРРО настраивается в кабинете; тогда merchantPaymInfo обязателен, для возврата передают список товаров |
Отдельный продукт «РРО ПриватБанка» в перечне услуг сервиса |
Две вещи бросаются в глаза. Первая: цены одинаковы на стандартных тарифах, поэтому решающим является не процент, а условия договора, скорость зачисления средств и то, где открыт ваш счёт. Вторую мы ниже разберём подробно: подписи вебхуков устроены совсем по-разному.
Отдельная оговорка о LiqPay. В тексте документации алгоритм подписи описан как base64_encode( sha3-256( private_key + data + private_key) ), а в примерах кода на той же странице использован SHA-1 (проверено 2026-11-19 на liqpay.ua/doc/api/callback). Мы не решаем за документацию, какой вариант правильный в вашем магазине: это проверяется одним тестовым платежом и официальным SDK. Если документация расходится с примерами, доверяйте SDK поставщика, а не кому-либо, кто пишет об этом в сети.
Схема: от счёта в CRM до учёта
Платёжный модуль работает по цепочке, в которой каждый шаг можно тестировать отдельно.
Шаг первый, счёт. Менеджер или клиент нажимает «Оплатить», CRM создаёт внутреннюю запись оплаты со статусом «ожидает» и собственным уникальным референсом (это не номер заказа, потому что на один заказ может быть несколько попыток оплаты). Референс передаётся платёжному сервису: у monobank это поле reference объекта merchantPaymInfo, у LiqPay это order_id.
Шаг второй, ссылка. Платёжный сервис возвращает адрес страницы оплаты. У monobank ответ на создание счёта содержит invoiceId и pageUrl. CRM сохраняет invoiceId (он понадобится для статуса и возврата) и отправляет ссылку клиенту: в мессенджере, письмом, в корзине на сайте или показывает менеджеру как QR.
Шаг третий, вебхук. Когда статус счёта меняется, сервис отправляет запрос на ваш webHookUrl или server_url. Модуль отвечает 200 быстро и ничего долго не считает внутри запроса: он проверяет подпись, кладёт событие в очередь и сразу возвращает ответ. Обработка идёт в фоне.
Шаг четвёртый, статус. Из события CRM определяет состояние заказа: оплачено, частично оплачено, ошибка, возвращено. Только здесь меняется заказ, запускается отгрузка или производство, а клиенту уходит подтверждение.
Шаг пятый, чек. Если вы работаете с ПРРО, фискальный чек формируется на этом этапе: у monobank это настроенная связка, а список товаров идёт в merchantPaymInfo. Отдельно о фискализации мы сейчас не расписываем.
Шаг шестой, учёт и сверка. Оплата записывается в журнал платежей, а раз в сутки CRM сверяет итоги с выписками сервиса и, если нужно, передаёт документы в BAS (как решать, кто главный в данных, разобрано в гайде интеграция CRM с BAS и 1С).
Как узнать об оплате надёжно: вебхук плюс запрос статуса
Вебхук удобен, но ненадёжен, если опираться только на него. Что пишет об этом monobank: бэкенд эквайринга делает до трёх попыток POST, пока не получит ответ 200 OK; подпись идёт в заголовке X-Sign. Отдельно документация говорит, что гарантии порядка доставки нет: вебхук со статусом success может прийти раньше вебхука со статусом processing, поэтому ориентироваться советуют на поле modifiedDate, и актуальным считается тот вебхук, у которого оно больше. Кроме того, для статуса expired вебхук не отправляется вообще (все цитаты с api.monobank.ua/docs/acquiring.html, проверено 2026-11-19).
Отсюда следует простая конструкция, которую мы используем в каждом модуле. Первое: вебхук обновляет состояние платежа только тогда, когда его modifiedDate новее сохранённого, иначе его игнорируют. Второе: отдельная фоновая задача каждые несколько минут берёт все оплаты со статусом «ожидает» или «в обработке» и спрашивает актуальное состояние запросом статуса. Это закрывает и потерянные вебхуки, и просроченные счета, о которых сервис никогда не сообщит.
Для LiqPay логика та же. Документация прямо советует: для получения текущего статуса до финального статуса в callback использовать API статуса платежа, который можно вызвать в любое время. Список статусов в LiqPay богатый: конечные (success, failure, error, reversed, subscribed, unsubscribed), статусы, требующие подтверждения клиента (например, 3ds_verify, otp_verify), и промежуточные (processing, prepared, wait_accept, wait_compensation, hold_wait). CRM должна знать, какие из них конечные, а какие нет, и не отгружать товар на промежуточном статусе.
Проверка подписи вебхука
Это самая важная часть безопасности, и именно её чаще всего пропускают. Адрес вебхука публичный. Если CRM доверяет любому запросу с текстом «success», посторонний может «оплатить» заказ без денег.
У monobank подпись это ECDSA: тело запроса подписано, а подпись лежит в заголовке X-Sign. Публичный ключ сервиса берётся методом GET /api/merchant/pubkey, и документация содержит примеры верификации на нескольких языках. Есть две практические мелочи. Подпись проверяют по сырым байтам тела запроса, до разбора JSON: если сначала разобрать, а потом снова сериализовать, пробелы и порядок полей изменятся, и подпись не сойдётся. И ключ кешируют, но с возможностью обновить, а не зашивают в код навсегда.
У LiqPay запрос содержит два параметра, data (base64 от JSON) и signature. Подпись считается из приватного ключа магазина, самих данных и ещё раз приватного ключа, и сравнивается с полученной. Приватный ключ никому кроме вашего разработчика не передают, в CRM он живёт в переменных окружения, а не в репозитории. Точный алгоритм хеширования, как мы писали выше, сверяйте с SDK.
После проверки подписи есть ещё одна, о которой забывают: проверка суммы. Вебхук говорит, что счёт на сумму X оплачен, а CRM должна сравнить X с суммой заказа, на который выставляли счёт. Поддельную подпись она не спасёт, но от ошибки в конфигурации или от клиента, изменившего сумму в обход, защищает.
Типичные ошибки, которые стоят денег
Дубль вебхука. Сервис может повторить вебхук (monobank прямо описывает до трёх попыток), а сеть может доставить один запрос дважды. Если каждый вебхук превращается в проведение платежа, в журнале появляется двойная оплата, а менеджер отгружает дважды. Решение: идемпотентность. Событие записывают по ключу «идентификатор счёта плюс статус плюс время изменения», и повторное событие с таким же ключом ничего не меняет.
Оплата без заказа. Клиент оплатил, а заказ к этому моменту удалили или отменили, либо вебхук пришёл на референс, которого CRM не знает. Нельзя просто ответить ошибкой и забыть: деньги уже у магазина. Нужен отдельный список «неопознанных оплат» для менеджера с вариантами действий: привязать к заказу, вернуть.
Частичный возврат. Клиент вернул один товар из трёх. CRM должна создать возврат на сумму этого товара, а не на весь заказ. У monobank метод отмены принимает сумму, а при включённой фискализации и перечень товаров для чека возврата (это поле обязательно, если опция активирована). Возвраты хранят отдельными записями, связанными с оплатой, потому что одна оплата может иметь несколько возвратов, и исходная сумма никогда не редактируется. У LiqPay возврат выполняется автоматически на карту, с которой платил клиент, и по документации за счёт будущих платежей, либо со счёта компании, если он открыт в ПриватБанке и это согласовано в договоре. Поэтому ликвидность для возвратов нужно учитывать заранее.
Просроченный счёт. Клиент открыл ссылку вчера, а счёт по умолчанию живёт 24 часа. Для expired у monobank вебхука нет, поэтому без фонового опроса заказ зависнет со статусом «ожидает». Решение: либо фоновый опрос, либо сознательно заданная длительность validity, соответствующая вашему процессу.
Разная валюта и копейки. Сумма в monobank передаётся в минимальных единицах, в копейках, целым числом, а в LiqPay как число с запятой. Типичная ошибка: передать 1500 и получить счёт на 15 гривен или наоборот. Модуль должен иметь один внутренний формат денег (целое число копеек плюс код валюты) и единственное место, где он преобразуется в формат конкретного сервиса.
Возврат мимо системы. Нельзя допускать никаких «возвратов» вне API: только через модуль, который пишет операцию в журнал и вызывает метод сервиса. Иначе сверка не сойдётся, а деньги уйдут без следа в учёте.
Как это тестировать
Monobank предоставляет тестовую среду: для неё используют токен, который выдают на api.monobank.ua, без терминала или разрешения на тестирование эквайринга. В тестовой среде для оплаты можно вводить любой номер, дату и CVV карты, если номер валиден по алгоритму Луна, при этом финансовая авторизация не выполняется. Это позволяет прогнать весь путь от счёта до вебхука без реальных денег.
Наш подход ко всем внешним интеграциям такой: каждая прячется за интерфейсом с тестовой реализацией, которая имитирует поведение сервиса, включая дубли вебхуков и задержки. На ней пишутся автоматические тесты граничных случаев, которые почти невозможно воспроизвести на живом сервисе: вебхук success раньше processing, повторная доставка, оплата неизвестного референса, частичный возврат. Живой тестовый платёж мы делаем уже в конце, чтобы убедиться в подписи и настройках кабинета.
Когда готовый модуль, а когда собственная интеграция
Если вы продаёте с сайта на готовой платформе и CRM у вас готовая (KeyCRM или SalesDrive), оплата monobank и LiqPay там уже поддерживается, и собственный код не нужен (сравнение возможностей и цен есть в гайде CRM на заказ или готовая CRM). Собственная интеграция оправдана, когда оплата в CRM сложнее кнопки «заплатить»: счета по частям, предоплата и остаток, оплата от имени юрлица, подписки с нестандартным расписанием, сверка с BAS, многосторонние расчёты с агентами или партнёрами, разная логика для разных клиентов. Тогда платёжный модуль это часть вашей модели денег, а не приложение к ней.
Об учёте заказов и склада, связанном с оплатами, см. учёт заказов и склада. А сколько стоит вся система, разобрано в гайде сколько стоит разработать CRM.
Сколько это стоит
Платёжный модуль входит в проект CRM или ERP: минимальный проект в Lytvynov Production стоит от 10 000 USD, полноценная CRM/ERP 40 000-90 000 USD. Модуль для одного сервиса (счёт, ссылка, вебхук с проверкой подписи, возвраты, сверка) это заметная, но не главная часть бюджета; дополнительный сервис за тем же интерфейсом дешевле, потому что каркас уже есть. Точную оценку даём после просмотра вашего процесса приёма оплат.
Материал подготовил Антон Литвинов, основатель Lytvynov Production. Факты об API проверены 2026-11-19 на api.monobank.ua, liqpay.ua и monobank.ua; мы не запускали платежи с боевыми ключами, поэтому перед запуском проверьте каждый шаг на тестовых платежах.
Следующий шаг
Опишите, как вы сейчас принимаете оплаты: реквизиты, ссылки, терминал, какой эквайринг, какие в заказах бывают возвраты и предоплаты. Мы скажем, достаточно ли готового модуля, и назовём диапазон цены собственного. Записаться на консультацию.