PayKeeper для бизнеса: как подключить интернет-эквайринг и запустить прием платежей на сайте

PayKeeper стоит подключать, когда вы можете связать платеж с конкретным заказом, принять защищенное серверное уведомление и провести возврат без ручного поиска операции. Не открывайте форму оплаты, пока не проверите весь маршрут: заказ → платеж → статус в CMS → чек → возврат.

Когда PayKeeper имеет смысл подключать

Интернет-магазин: оплата из корзины

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

Передавайте в интеграцию номер заказа, сумму, позиции и контакт покупателя. Кассовую часть дистанционных продаж разберите отдельно: онлайн-касса для интернет-магазина: выбор, подключение и запуск.

Онлайн-сервис или школа: ссылка и выдача доступа

Связывайте ссылку на оплату с внутренним идентификатором заказа. После подтвержденного платежа выдавайте доступ автоматически; после возврата закрывайте доступ по правилам вашей услуги и фиксируйте это действие в CRM.

Если продаете услуги, заранее настройте номенклатуру и сценарии чеков. Полезный ориентир — онлайн-касса для услуг: как понять, нужна ли она вашему бизнесу и что выбрать.

B2B: счет для компании и оплата от физлица

Разделите процессы. Безналичный перевод между организациями и оплата картой или СБП от физлица по ссылке — разные сценарии учета и ККТ. Для оплаты физлицом создавайте отдельный заказ с составом продажи и не смешивайте его с оплатой счета от организации.

Что подтвердить у PayKeeper до договора

Не считайте функцию доступной только потому, что она упомянута в обзоре или у конкурента. Платежные методы, рекуррентные платежи, возвраты и формат подключения зависят от договора, банка-эквайера и выбранной технической схемы.

  1. Запросите коммерческие условия. Укажите методы оплаты, средний чек, месячный оборот, сайт и категорию товаров или услуг. Комиссию сравнивайте по вашему набору методов, а не по одной рекламной ставке. В этой статье ставка не приводится: универсального тарифа для всех проектов нет.
  2. Проверьте способ интеграции. Для CMS запросите название модуля, совместимые версии платформы и инструкцию установки. Для разработки проверьте официальную документацию PayKeeper: создание платежа, уведомления, подпись запросов, возвраты и тестирование.
  3. Зафиксируйте методы оплаты. Получите письменное подтверждение, какие методы включат именно вашему магазину и на каких условиях. Отдельно спросите о платежных ссылках, повторных списаниях и полном или частичном возврате, если эти сценарии нужны.
  4. Определите кассовую схему. Установите, какая ККТ формирует чек, кто передает состав заказа и как создается чек возврата. Требования к применению ККТ публикует сайт ФНС России.

Таблица проверки PayKeeper перед запуском

Критерий Что проверить Кому критично Что запросить
Методы оплаты Какие методы доступны по вашему договору и как меняется комиссия Всем проектам Коммерческое предложение по вашему обороту и методам
CMS-модуль Совместимость с версией CMS, передачу суммы, номера заказа и позиций Интернет-магазину Ссылку на модуль и инструкцию установки
API и уведомления HTTPS, проверку подписи, формат ответа, повторы и журнал операций Самописному сайту, CRM Официальную документацию API PayKeeper
Возвраты Полный и частичный возврат, статусы, права сотрудников Магазину и сервису Порядок возврата в кабинете или через API
Рекуррентные платежи Согласие клиента, отмену подписки, отказ в списании Подпискам и школам Подтверждение доступности по договору и техническое описание
Фискализация Передачу состава заказа, чек предоплаты, оплаты и возврата Расчетам с физлицами, где нужна ККТ Схему связки с вашей ККТ или облачной кассой
Поддержка Канал обращений, время реакции, порядок эскалации Проектам с продажами 24/7 Регламент поддержки

Как запустить PayKeeper: пошаговый чеклист

  1. Получите боевые и тестовые доступы. Проверьте реквизиты компании, домен, URL уведомлений и назначение платежей. Тестовые ключи храните отдельно от боевых.
  2. Подключите CMS-модуль или API. Передавайте номер заказа, сумму и состав покупки. Данные банковской карты не должны проходить через ваш сервер.
  3. Настройте защищенные уведомления. Принимайте их по HTTPS. Для каждого уведомления сверяйте подпись по документации PayKeeper, номер заказа, сумму и валюту с локальным заказом; неизвестные или не совпавшие сообщения не должны менять статус заказа.
  4. Защитите обработку от повторов. Сохраняйте идентификатор платежа и результат обработки. Если уведомление пришло повторно, не создавайте второй заказ, не выдавайте доступ повторно и не формируйте дублирующее действие. Это называется идемпотентностью: один и тот же сигнал дает один результат.
  5. Настройте журнал и очередь ошибок. Записывайте время уведомления, идентификатор операции, номер заказа, проверку подписи и ответ обработчика. Необработанные уведомления помещайте в отдельную очередь для повторной обработки после исправления ошибки.
  6. Настройте ККТ под фактический расчет. Для полной оплаты, предоплаты и возврата могут потребоваться разные чеки и реквизиты. Сначала согласуйте сценарий с кассовой интеграцией, затем проверьте чек на каждом тестовом платеже. Для дистанционной торговли часто подходит облачная схема; порядок выбора описан в статье облачная фискализация для интернет-магазина, сервиса и онлайн-услуг.
  7. Проведите приемочные тесты. Выполните успешную и неуспешную оплату, отмену, повторное уведомление, полный и частичный возврат. По каждой операции сверяйте статус CMS, запись в журнале, деньги, доступ к товару или услуге и кассовый чек.

Ошибки при подключении PayKeeper

Заказ становится оплаченным после возврата покупателя на сайт. Исправление: меняйте статус только после проверенного серверного уведомления.

Уведомление принимается без проверки подписи и суммы. Исправление: сверяйте подпись, номер заказа, сумму и валюту; запросы с ошибкой сохраняйте в журнале и не исполняйте.

Повторное уведомление повторно выдает товар. Исправление: храните идентификатор платежа и отмечайте операцию обработанной до выдачи доступа или смены статуса.

Возврат не проверен до старта. Исправление: назначьте сотрудника с правами на возврат и проведите полный и частичный возврат по всей цепочке: PayKeeper, CMS, ККТ и CRM.

Форма оплаты открыта до настройки кассы. Исправление: сначала протестируйте чеки для реальных сценариев — предоплаты, окончательного расчета, возврата, — затем включайте прием денег.

Ежедневная сверка после запуска

Назначьте источником платежной истины реестр или отчет PayKeeper за день. До следующего рабочего дня сопоставляйте его с заказами в CMS или CRM, операциями возврата и кассовыми чеками.

Для каждого расхождения создавайте задачу с номером заказа, идентификатором платежа, суммой, датой и текущим статусом. Сначала выясните, получено ли уведомление; затем проверьте журнал обработчика, статус возврата и чек. Не закрывайте задачу, пока статусы в платежном реестре, заказе и кассовой системе не приведены к документированному результату.

Нужна интеграция PayKeeper без ручной сверки? Оставьте заявку в Интернет Касса. На первом контакте разберем ваш сценарий оплаты, проверим CMS или API, определим кассовую схему и дадим список работ для запуска.

Частые вопросы

Нужна ли онлайн-касса при подключении PayKeeper?

Да, если ваш расчет требует применения ККТ по 54-ФЗ. PayKeeper принимает платеж, но не заменяет кассу: схему чека на оплату, предоплату и возврат настройте по фактической модели расчетов.

Можно ли подключить PayKeeper к сайту без программиста?

Да, если для вашей CMS есть совместимый модуль и он корректно передает заказ, статусы и данные для вашей кассовой схемы. Самописный сайт, нестандартная корзина или интеграция с CRM требуют настройки API и серверных уведомлений.

Что важнее при выборе PayKeeper: комиссия или интеграция?

Сначала проверьте интеграцию. После теста статусов, возвратов и передачи заказа в кассу запросите комиссию по нужным методам оплаты и посчитайте расходы на доработку и ручную обработку.

Подходит ли PayKeeper для подписок и регулярных платежей?

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