Подключение онлайн - кассы к сайту нужно, чтобы после оплаты корректно формировался чек, передавался в кассовый сервис и ОФД, а система могла контролировать результат фискализации, возвраты, ошибки и повторные операции.
Настраиваем технический контур от платежного события до подтвержденного статуса чека.
Типовая цепочка выглядит так:
Заказ → Оплата → онлайн - касса → ОФД → Статус чека
При этом каждая система должна понимать, к какому заказу и платежу относится чек, был ли он уже сформирован, требуется ли повторная попытка и что делать при возврате.
Мы занимаемся технической интеграцией. Требования к применению конкретных типов чеков и фискальных сценариев должны соответствовать вашей учетной модели и требованиям, которые определены для бизнеса.
Когда требуется подключение онлайн - кассы
Подключение требуется, когда сайт, интернет-магазин, веб-сервис или приложение принимает онлайн-платежи и должен автоматически запускать процесс фискализации.
Типовые ситуации:
- Запускается прием оплаты на сайте.
- Меняется онлайн - касса или кассовый сервис.
- Меняется платежный провайдер.
- Чеки сейчас формируются вручную.
- Оплата проходит, но чек иногда не создается.
- Чеки зависают при временных сбоях.
- Возникают повторные чеки.
- Некорректно обрабатываются возвраты.
- Нельзя связать чек с конкретным заказом и платежом.
- Нет мониторинга ошибок фискализации.
Проектируем схему фискализации
До подключения определяем, какие системы участвуют в формировании и передаче чека.
В контуре могут находиться:
- Сайт или приложение.
- Система заказов.
- Платежный провайдер.
- онлайн - касса.
- Кассовый облачный сервис.
- ОФД.
- CRM.
- 1С или другая учетная система.
Фиксируем, какая система инициирует фискализацию, кто хранит статус чека и каким образом связываются заказ, платеж и фискальная операция.
Что влияет на стоимость подключения онлайн - кассы
На оценку влияют:
- Используемая касса или кассовый сервис.
- Способ интеграции.
- Количество сценариев оплаты.
- Количество сценариев возврата.
- Наличие частичных возвратов.
- Необходимость интеграции с учетной системой.
- Существующая архитектура сайта.
- Качество документации провайдера.
- Необходимость очередей и механизмов восстановления.
- Требования к мониторингу.
Сроки и стоимость
Стоимость подключения онлайн - кассы - от 30 000 ₽.
Базовый срок - 3-5 дней.
Если требуется нестандартная схема фискализации, несколько систем, сложная учетная интеграция или восстановление существующего проблемного контура, объем определяется отдельно.
Определяем момент формирования чека
Сам факт создания заказа не всегда означает, что чек нужно формировать именно в этот момент.
Событием для фискализации в зависимости от бизнес-процесса может быть:
- Успешная оплата.
- Подтверждение платежа.
- Отгрузка.
- Оказание услуги.
- Другое состояние бизнес-операции.
Техническая логика должна соответствовать реальному жизненному циклу заказа, а не просто вызывать кассу при первом удобном событии.
Учитываем разные сценарии расчетов
При проектировании интеграции учитываем сценарии, которые реально существуют в проекте.
Например:
- Приход.
- Возврат.
- Аванс.
- Предоплата.
- Постоплата.
- Полный возврат.
- Частичный возврат.
Не добавляем сценарии формально. Для каждого из них должно быть понятно, какое бизнес-событие произошло, какой платеж ему соответствует и какую операцию должна выполнить кассовая система.
Подключаем онлайн - кассу к сайту
Способ подключения зависит от выбранного оборудования, кассового сервиса и существующей архитектуры.
Интеграция может выполняться через:
- API кассового сервиса.
- Готовый модуль.
- Платежного провайдера.
- Интеграционный шлюз.
- Собственный backend сайта или приложения.
Если готовый модуль полностью покрывает бизнес-сценарий проекта, нет необходимости создавать собственный интеграционный слой.
Если стандартной интеграции недостаточно, реализуем взаимодействие с кассовым API.
Разделяем оплату и фискализацию
Успешный платеж и успешное создание чека - это связанные, но разные технические операции.
Возможна ситуация, когда деньги уже приняты, но кассовый сервис временно недоступен.
Поэтому система должна отдельно хранить:
- Статус заказа.
- Статус платежа.
- Статус фискализации.
- Идентификатор чека.
- Идентификатор операции у кассового сервиса.
Это позволяет восстановить процесс, если один из участников цепочки временно не ответил.
Связываем заказ, платеж и чек
Для диагностики должно быть возможно пройти всю цепочку одной операции:
Заказ → Платеж → Фискальная операция → Чек → ОФД
Для этого сохраняем необходимые внутренние и внешние идентификаторы.
При ошибке команда должна иметь возможность определить, какой заказ затронут, прошел ли платеж, был ли сформирован чек и на каком этапе остановилась обработка.
Контролируем статусы чеков
Отправка запроса в кассу сама по себе еще не означает, что операция успешно завершена.
В зависимости от провайдера жизненный цикл может включать состояния:
Создан → Отправлен → Обрабатывается → Принят → Ошибка → Повтор
Конкретные названия статусов зависят от используемого сервиса, но внутри проекта должна существовать понятная модель состояния фискальной операции.
Обрабатываем асинхронный результат
Некоторые кассовые сервисы не возвращают окончательный результат непосредственно в ответ на первый запрос.
В таком случае необходимо:
- Зафиксировать создание операции.
- Получить ее внешний идентификатор.
- Дождаться результата.
- Обновить внутренний статус.
- Обработать ошибку, если она возникла.
Для получения результата могут использоваться callback, webhook или периодическая проверка состояния, в зависимости от возможностей конкретного сервиса.
Обрабатываем возвраты
Возврат денег должен быть связан не только с платежной операцией, но и с фискальным контуром.
Проектируем:
- Полный возврат.
- Частичный возврат, если он используется.
- Связь возврата с исходным заказом.
- Связь с исходным платежом.
- Формирование соответствующей кассовой операции.
- Контроль результата.
- Поведение при ошибке.
Сценарий возврата проверяем отдельно, а не считаем автоматически работающим после успешного теста обычной оплаты.
Защищаем от повторной фискализации
Платежные события, webhooks и внутренние сообщения могут доставляться повторно.
Повтор одного события не должен автоматически создавать второй чек для той же операции.
Для этого определяем:
- Уникальный идентификатор операции.
- Правила идемпотентности.
- Проверку уже созданной фискальной операции.
- Поведение при повторном событии.
- Поведение при повторном запросе после timeout.
Обрабатываем временную недоступность кассы
Кассовый сервис, сеть или другой участник цепочки может временно не отвечать.
Такая ошибка не должна автоматически означать потерю чека.
В зависимости от архитектуры используем:
- Очередь операций.
- Повторные попытки.
- backoff.
- Ограничение количества повторов.
- Отложенную обработку.
- Ручное восстановление после критической ошибки.
Не повторяем заведомо некорректные операции
Не каждая ошибка является временной.
Например, ошибка в данных заказа не станет успешной от сотни автоматических повторов.
Поэтому разделяем:
- Временные технические ошибки.
- Ошибки данных.
- Ошибки авторизации.
- Ошибки конфигурации.
- Бизнес-ошибки.
- Ошибки, требующие ручного вмешательства.
Контролируем данные чека
Перед отправкой операции проверяем данные, которые необходимы конкретной интеграции.
Это могут быть:
- Позиции заказа.
- Количество.
- Стоимость.
- Итоговая сумма.
- Данные покупателя.
- Тип операции.
- Способ расчета.
- Другие обязательные параметры кассового сервиса.
Состав полей определяется фактическим контрактом используемой системы и вашей моделью расчетов.
Проверяем согласованность сумм
Итог заказа, платеж и данные, отправляемые на фискализацию, должны согласовываться.
Отдельно проверяем сценарии, в которых присутствуют:
- Скидки.
- Промокоды.
- Доставка.
- Частичная оплата.
- Частичный возврат.
- Изменение состава заказа.
Иначе каждая система может считать итоговую сумму по-разному.
Интеграция онлайн - кассы с 1С и учетной системой
Если учет ведется в 1С или другой системе, определяем, какие данные о чеке и фискальной операции должны передаваться туда.
При этом не смешиваем несколько источников управления одной операцией.
Должно быть понятно, какая система инициирует фискализацию, а какие системы только получают результат.
Если задача значительно шире и требуется полноценная синхронизация 1С, CRM, ERP и сайта, используется отдельная услуга интеграции 1С с сайтом, CRM и ERP.
Логируем жизненный цикл операции
Для диагностики фиксируем ключевые этапы обработки.
Например:
- Получено платежное событие.
- Создана фискальная операция.
- Отправлен запрос в кассу.
- Получен идентификатор операции.
- Получен итоговый статус.
- Запущена повторная попытка.
- Обработан возврат.
- Зафиксирована ошибка.
При этом секреты и чувствительные данные не должны бесконтрольно попадать в логи.
Мониторинг онлайн - кассы
Фискализация работает автоматически, поэтому ошибки также должны обнаруживаться автоматически.
В зависимости от инфраструктуры контролируем:
- Ошибочные чеки.
- Зависшие операции.
- Размер очереди.
- Количество повторов.
- Время обработки.
- Расхождения между платежом и фискализацией.
- Недоступность кассового сервиса.
Как строится подключение онлайн - кассы
1. Разбираем модель продаж
Определяем:
- Что продается.
- Как создается заказ.
- Как принимается оплата.
- Какие существуют возвраты.
- Какие системы участвуют в процессе.
- Где ведется учет.
2. Проектируем фискальный контур
Определяем:
- Какое событие запускает чек.
- Какая система выполняет запрос.
- Как заказ связывается с платежом.
- Как платеж связывается с чеком.
- Где хранится статус.
- Как обрабатывается возврат.
- Как восстанавливается операция после сбоя.
3. Выполняем интеграцию
Подключаем кассовый сервис через предусмотренный им механизм и реализуем необходимые операции.
4. Тестируем рабочие и аварийные сценарии
Проверяем:
- Успешную оплату.
- Формирование чека.
- Получение итогового статуса.
- Полный возврат.
- Частичный возврат, если он используется.
- Повторное платежное событие.
- Повторный запрос.
- timeout.
- Временную недоступность сервиса.
- Некорректные данные.
5. Запускаем и контролируем
После запуска проверяем первые реальные операции, статусы и работу механизмов восстановления.
Что считаем готовым подключением
Подключение онлайн - кассы считается завершенным не тогда, когда один тестовый чек успешно создан.
Проверяем:
- Оплата приводит к нужному сценарию фискализации.
- Заказ, платеж и чек связаны между собой.
- Итоговый статус операции можно определить.
- Возвраты обрабатываются по предусмотренным сценариям.
- Повторное событие не создает неконтролируемый дубль.
- Временный сбой не приводит к молчаливой потере операции.
- Ошибку можно найти и диагностировать.
- Зависшую операцию можно обнаружить.
- Понятно, как восстановить неуспешную обработку.
Что получает команда
В зависимости от проекта результат может включать:
- Интеграцию сайта с онлайн - кассой.
- Схему фискализации.
- Связь платежа, заказа и чека.
- Обработку возвратов.
- Защиту от повторной фискализации.
- Очередь и повторные попытки.
- Логирование.
- Мониторинг критичных операций.
- Описание основных сценариев.
- Критерии приемки.
Типовые ошибки при подключении онлайн - кассы
Чек создается непосредственно в обработчике оплаты
При временной недоступности кассового сервиса операция теряется или требует ручного восстановления.
Оплата и чек считаются одной операцией
Деньги уже приняты, но система не может отдельно определить, завершилась ли фискализация.
Нет защиты от повторного события
Повторный webhook или повторная обработка создают второй чек.
Проверяется только успешная оплата
Возвраты, timeout, повторные события и ошибки кассового сервиса обнаруживаются уже после запуска.
Нет связи между платежом и чеком
При инциденте невозможно быстро определить, к какой оплате относится конкретная фискальная операция.
Ошибки остаются только в логах
Система не показывает, что часть чеков зависла или не была обработана.
Границы услуги
Эта услуга посвящена подключению онлайн - кассы и техническому процессу фискализации.
Если основная задача - подключить прием платежей, банковский эквайринг, СБП или платежный шлюз, используется подключение онлайн-оплаты к сайту.
Если требуется разработка самостоятельного программного интерфейса или сложная интеграция внешнего API, используется API-интеграция и разработка API.
Что нужно для старта
Для первичной оценки достаточно:
- Ссылки на сайт или приложение.
- Названия используемой онлайн - кассы или кассового сервиса.
- Информации о текущем способе приема оплаты.
- Описание основных сценариев продаж.
- Информации о возвратах.
- Информации об учетной системе.
- Документации провайдера, если она доступна.
Если схема уже работает, но часть чеков теряется, дублируется или зависает, начинаем с разбора существующего контура и жизненного цикла проблемной операции.
Надежное подключение онлайн - кассы - это не один успешный запрос в кассовый API. Система должна понимать, какой чек относится к какой оплате, контролировать его состояние и уметь восстановиться после временного сбоя без потери или дублирования операции.
Да. Если действующая платежная система работает и предоставляет необходимые данные для фискализации, менять ее только ради подключения онлайн - кассы не требуется. В таком случае дорабатывается именно цепочка между оплатой, заказом и кассовым сервисом.
Это зависит от используемой кассы или облачного сервиса и от того, как устроены продажи на этих сайтах. Технически несколько источников заказов могут работать с одним кассовым контуром, но для каждой операции должно оставаться понятно, откуда она пришла и к какому заказу относится.
Такую схему можно реализовать, если сайт способен определить, к какой компании относится конкретная продажа, а используемые кассовые сервисы поддерживают необходимые операции. Тогда перед фискализацией нужно однозначно выбирать соответствующий кассовый контур для заказа.
Да. В таком случае сначала исследуется действующая цепочка: откуда приходит событие об оплате, кто отправляет данные в кассу, где хранятся статусы и как обрабатываются ошибки. После этого можно определить, что следует оставить, исправить или переработать.
Возможность параллельной подготовки зависит от конкретной архитектуры и кассовых сервисов. Само переключение нужно проектировать так, чтобы одна продажа случайно не ушла одновременно в старый и новый контур. Поэтому порядок перехода определяется до запуска.
Не обязательно. Если сайт уже собирает все необходимые для продажи и чека данные, изменения могут ограничиться серверной частью. Если кассовому сервису требуются сведения, которых сайт сейчас не получает, тогда может понадобиться дополнить форму или сам процесс оформления заказа.
Само наличие офлайн-продаж не мешает интеграции сайта. Но до настройки нужно понять, используются ли для онлайн- и офлайн-операций одна кассовая инфраструктура или разные контуры, чтобы продажи из разных каналов не смешивались технически.
Набор доступов зависит от используемой схемы. Часто основная интеграция выполняется через кассу или кассовый сервис, который уже взаимодействует с ОФД. Если для настройки, диагностики или проверки требуется информация из других участников цепочки, необходимые доступы определяются отдельно.
Да, если платформа предоставляет подходящий модуль, API или другую возможность интеграции. Сначала имеет смысл проверить готовое решение: если оно полностью поддерживает нужные сценарии, отдельная разработка может не понадобиться. Если возможностей модуля недостаточно, оценивается другой вариант подключения.
Да, но это не всегда простая замена реквизитов. У разных сервисов отличаются API, статусы, способы получения результата и требования к данным. Если интеграция изначально не смешивает внутреннюю логику заказов с особенностями конкретного провайдера, дальнейшую замену обычно выполнить проще.