Как подключить облачную онлайн-кассу к сайту и сервису: пошагово

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

Кому подходит облачная онлайн-касса

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

Интернет-магазин с оплатой на сайте

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

Подписка, SaaS и сервис с API

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

Курьер, офлайн-точка и смешанные продажи

Выбирайте модель по месту и способу расчета. Если покупатель оплачивает заказ на сайте до передачи товара, облачная касса закрывает онлайн-часть сценария. Если деньги принимает курьер или кассир при передаче товара, заранее определите, как будет формироваться и выдаваться чек в момент расчета: решение зависит от процесса приема денег и модели доставки. Не закладывайте отдельную физическую ККТ автоматически, но и не считайте облачную кассу универсальной заменой для очных расчетов.

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

Что подготовить до подключения

Соберите доступы и назначьте ответственных до установки модуля. Тогда регистрация, настройка ОФД и интеграция не остановятся на середине процесса.

  • КЭП и доступ в личный кабинет ФНС. Они понадобятся для регистрации ККТ и передачи регистрационных сведений.
  • Данные ИП или ООО. Подготовьте реквизиты пользователя ККТ и сведения, которые запросит регистрационная форма.
  • ККТ и фискальный накопитель. Получите от поставщика данные модели, заводского номера и параметры, необходимые для регистрации и активации.
  • ОФД. Заключите договор и получите параметры обмена с оператором.
  • Доступы к платежам и сайту. Нужны права в CMS, платежном кабинете, API-ключи и доступ к журналам событий.
  • Матрица расчетов. Сопоставьте каждый статус платежа с действием: чек оплаты, чек возврата, чек зачета предоплаты или отсутствие чека.
  • Ответственные. Назначьте владельца процесса, технического специалиста и сотрудника, который ежедневно контролирует ошибки кассы и ОФД.

Официальные сервисы и материалы по применению ККТ доступны на сайте ФНС России. Не передавайте доступ к КЭП подрядчику без внутреннего порядка: регистрацию и подписание документов должен контролировать уполномоченный сотрудник бизнеса.

Как подключить облачную онлайн-кассу: пошаговый запуск

  1. Составьте карту платежных событий. Для каждого статуса укажите действие: сформировать чек оплаты, зачесть предоплату, оформить возврат или не делать ничего. Статусы «счет создан» и «платеж ожидается» не используйте как основание для фискализации.
  2. Выберите способ интеграции. Для типовой CMS подойдет готовый модуль, если он передает состав заказа и поддерживает ваши возвраты. Для собственного сайта, приложения и подписок подключайте API и включайте журналирование запросов.
  3. Зарегистрируйте ККТ и завершите процедуру. Подайте сведения в личном кабинете ФНС, получите регистрационный номер ККТ, сформируйте отчет о регистрации в кассовом сервисе и передайте сведения этого отчета в ФНС предусмотренным способом. Регистрацию считайте завершенной только после выполнения всех этих действий.
  4. Настройте ОФД. Внесите параметры оператора в кассовый сервис и убедитесь, что тестовые фискальные документы получают корректный статус передачи. Сообщение CMS «подключено» не подтверждает прием документа ОФД.
  5. Свяжите платежи и кассу. Передавайте идентификатор заказа, идентификатор платежа, сумму, валюту, состав заказа и контакт покупателя. На тестовом чеке проверьте название позиции, количество, цену, скидку, сумму, ставку или признак НДС, предмет расчета и способ расчета.
  6. Защитите обработку webhook. Принимайте уведомления только после проверки подписи или другого механизма аутентификации, который дает платежный провайдер. Дополнительно сверяйте сумму, валюту и идентификатор заказа с данными вашей системы; храните идемпотентный ключ и не создавайте повторный чек по одному платежу.
  7. Проверьте агентские реквизиты. Если вы работаете как агент, передайте применимые реквизиты агента и поставщика вместе с данными расчета. Не заменяйте их технической строкой из платежного модуля.
  8. Проведите приемочные тесты. Сделайте успешную оплату, возврат и повторную доставку одного webhook. Если вы принимаете авансы, добавьте предоплату с зачетом или доплатой.
  9. Утвердите регламент. Зафиксируйте, где искать статус платежа, чека и ОФД, кто разбирает ошибку и какие номера заказа, платежа и чека передавать в поддержку.

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

Как выбрать облачную кассу: критерии для бизнеса

Сравнивайте не название сервиса, а способность связки «платежи — касса — ОФД» провести ваши реальные операции. До оплаты тарифа запросите тестовый доступ либо проведите контрольный заказ на тестовом контуре.

Критерий Что спросить или проверить Кому критично
Интеграция Есть ли модуль для вашей CMS или платежного сервиса; передает ли он состав заказа, скидки и контакты покупателя. Магазинам на CMS и проектам с коротким сроком запуска.
Платежные сценарии Поддерживаются ли оплата, предоплата, зачет предоплаты, доплата, отмена, полный и частичный возврат. Бизнесу с возвратами, оплатой частями и авансами.
API и webhook Есть ли проверка подписи уведомлений, документация по ошибкам, идемпотентность, статусы чека и поиск по платежу. SaaS, подпискам и кастомным интеграциям.
Реквизиты чека Можно ли передать предмет и способ расчета, НДС, данные товара или услуги, а для агентских схем — применимые данные агента и поставщика. Каталогам товаров, услугам и агентам.
Личный кабинет Есть ли журнал ошибок, поиск чека, выгрузка документов и статус передачи в ОФД. Бухгалтерии и поддержке.
Стоимость и состав тарифа Разложите счет на ККТ или аренду, фискальный накопитель, ОФД, лимиты чеков, подключение, доработки и поддержку. Отдельно уточните стоимость сверх лимита и работ по API. Всем, кто сравнивает поставщиков и бюджет запуска.
Разделение проектов Можно ли отдельно вести витрины, юридические лица, роли пользователей и потоки расчетов. Агентам и мультибрендовому бизнесу.
Поддержка Кто диагностирует проблему в API, кассе и ОФД; какие каналы и порядок эскалации предусмотрены. Бизнесу с постоянным потоком платежей.

Оценивайте эквайринг вместе с кассой: платежный провайдер должен передавать подтвержденный статус оплаты и данные заказа, которые нужны для чека. Критерии выбора платежного решения собраны в статье «Интернет-эквайринг для интернет-магазина: выбор, сравнение и подключение оплаты».

Ошибки при запуске и как их убрать

Останавливаются на получении регистрационного номера. После РН ККТ сформируйте отчет о регистрации и передайте его сведения в ФНС предусмотренным способом. Не запускайте боевые чеки, пока не завершен весь регистрационный контур.

Фискализируют создание счета. Свяжите выпуск чека с подтвержденной оплатой. Для подписки проверяйте факт успешного списания, а не только запуск рекуррентного платежа.

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

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

Проверяют только успешную оплату. Минимальный набор приемки: оплата, возврат и повторное webhook. Для авансов добавьте предоплату с зачетом или доплатой; для подписок — повторное списание и отмену.

Не контролируют необработанные чеки. Настройте ежедневный просмотр журнала ошибок и сверку успешных платежей с выпущенными чеками. Если обнаружили расхождение, сначала определите узел: платежный сервис, ваша интеграция, касса или ОФД.

Контроль после подключения

  1. Создайте контрольный заказ и оплатите его тем способом, который будет доступен покупателям.
  2. Сверьте платеж и чек: заказ, сумму, валюту, позиции, скидку, налоговые параметры, предмет и способ расчета.
  3. Проверьте наличие чека в личном кабинете кассового сервиса и статус передачи документа в ОФД.
  4. Убедитесь, что электронный чек отправлен на e-mail или телефон, указанный покупателем.
  5. Оформите возврат и убедитесь, что сформирован отдельный корректный документ.
  6. Сопоставьте журнал успешных платежей с журналом чеков за тестовый период: у каждой операции должен быть понятный результат.
  7. Сохраните номера заказа, платежа и чека в регламенте поддержки.

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

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

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

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

Нужно ли регистрировать облачную кассу в ФНС до приема оплаты на сайте?

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

Подходит ли облачная касса для интернет-магазина и подписочного сервиса?

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

Нужен ли ОФД для облачной кассы?

Да, для стандартной работы ККТ настройте договор и обмен с ОФД. ОФД принимает фискальные документы от кассы и передает сведения в налоговые органы.

Что проверить после подключения облачной кассы?

Сделайте оплату, возврат и проверьте чек, его статус у ОФД и доставку покупателю. Если продаете по предоплате или подписке, добавьте тест зачета аванса, доплаты и повторного webhook без создания второго чека.