PayKeeper — что умеем и чего пока нет (апрель 2026)
✅ Что умеем
Подключение к PayKeeper
- Владелец франшизы в админке привязывает PayKeeper-аккаунт к юрлицу (логин, пароль, ID)
- К каждой торговой точке привязывается свой терминал PK
- Можно приостановить интеграцию без удаления и включить обратно
- Видно журнал всех входящих уведомлений от PK (платежи, возвраты, чеки)
Приём платежей
- Кассир за стойкой (десктоп-касса) проводит оплату через PayKeeper-терминал — всё работает из нашей кассовой программы
- Статус платежа возвращается обратно в заказ (оплачено / отклонено)
- Принимаем уведомления от PK об оплатах и чеках
Выгрузка каталога в PayKeeper
- Заводим товар в нашем ERP → через несколько секунд он появляется в ЛК PayKeeper
- Изменяем цену / название / налог → автоматически обновляется в PK
- Удаляем товар → удаляется и в PK
- Модификаторы раскладываются правильно: «Капучино» со структурным модификатором «размер» (S/M/L) превращается в 3 отдельных товара в PK; добавки «сироп» становятся отдельными addon-товарами
- Категории пишем префиксом в названии: «Кофе / Холодное / Айс Латте» — чтобы кассир в ЛК PK видел структуру
- Каждую ночь запускается автоматическая сверка каталога (на случай если что-то разъехалось)
- В админке есть блок «Каталог в PayKeeper»:
- видно сколько товаров синхронизировано
- кнопка «Пересинхронизировать» если нужно вручную
- журнал всех прогонов с ошибками по каждому товару
- красная кнопка «Очистить каталог в ЛК PK» если накопился мусор (сносит всё и перезаливает)
⬜ Что пока не умеем
Каталог
- Не ловим изменения из PayKeeper обратно — если кассир что-то правит в ЛК PK (цену, название), у нас об этом никто не знает. PayKeeper пока не даёт такую возможность со своей стороны; будем подключать как только выкатят
- Категории грузим только префиксом в имени — хотим нормально подтягивать как теги PK, но ещё не разобрались с их API тегов
- Не синкаем картинки товаров — в ЛК PK они без фото
- Не синкаем штрих-коды и ТРУ-коды (коды честного знака) — пока хардкод «нет»
Возвраты и чеки
- Возврат с кассы не делаем — кассир ходит в ЛК PayKeeper и делает возврат руками. Принимаем только уведомление от PK когда возврат уже сделан
- Не сверяем фискальные чеки — просто сохраняем что пришло, без проверки корректности
- Нет разбивки оплаты (часть картой, часть наличными) — только одна транзакция целиком
- Нельзя отменить начатый платёж — только ждать таймаут
Эксплуатация
- Нет автоматических алертов если синхронизация упала — только в логах. Админ узнаёт случайно зайдя в админку
- Нет графиков / метрик по работе интеграции
- Нет защиты от злоупотребления — если кто-то задолбает кнопку «пересинхронизировать», это нагрузит систему
Коротко одним абзацем
Интеграция с PayKeeper работает в одну сторону: мы управляем нашим ERP — платежи и каталог едут в PK. Всё что касается кассовой работы за стойкой (оплата, чеки, автообновление меню) — готово. Обратная связь из PK (правки в ЛК PK, возвраты со стороны PK) — пока не автоматизирована, требует ручных действий кассира в ЛК PK.
TL;DR (одним экраном)
Работает: онбординг PK, приём платежей с десктоп-кассы, выгрузка каталога (товары / цены / модификаторы) из ERP → PK, ночная автосверка, ручная пересинхронизация, экстренная очистка каталога.
Не работает: правки в ЛК PK к нам обратно не приезжают (PK не даёт), возврат делается руками в ЛК PK, нет картинок / штрих-кодов, нет авто-алертов.
В двух словах: каталог и платежи летят от нас в PK — это есть; всё что требует инициативы с их стороны или руками — нет.