Как подключить платежный модуль Robokassa

Подключение платежного модуля Robokassa на сайт VirtualityCMS

Платежный модуль — это программный компонент, который обеспечивает приём оплаты на сайте через банки, платёжные шлюзы, сервисы рассрочки или онлайн-кассы. Этому соответствуют такие процессы как списание средств, формирование чеков (54-ФЗ) и обработка статусов транзакций. Модуль Robokassa для VirtualityCMS автоматизирует некоторые из них

Какие способы оплаты можно подключить на VirtualityCMS?

Современный платежный модуль объединяет несколько типов приёма платежей:

• Интернет-эквайринг — банковские карты (Visa, Mastercard, МИР), СБП (QR-код) и прочее.
• Сервисы рассрочки («покупай сейчас, плати потом») — «Долями», «Подели», «Яндекс Сплит», «Плати частями» и другие
• Облачная касса (54-ФЗ) — автоматическая отправка чеков в налоговую, фискальные накопители, ОФД.
• Электронные кошельки — ЮMoney, WebMoney и другие.
• Банковские переводы — квитанции, расчётные счета юрлиц.

В этой статье — пошаговая настройка модуля Robokassa на платформе VirtualityCMS.

54-ФЗ и обязательная онлайн-касса: что нужно знать при подключении Robokassa

Согласно Федеральному закону № 54-ФЗ, при приёме безналичных платежей через интернет необходимо использовать онлайн-кассу. Платежный модуль Robokassa для VirtualityCMS может интегрироваться с облачной кассой, которая автоматически формирует фискальные чеки и передаёт их в ОФД. Это избавляет от покупки физической кассы и упрощает отчётность.

Что должен уметь платежный модуль для соблюдения 54-ФЗ:

• Формировать чек при успешной оплате.
• Отправлять чек на email или SMS покупателю.
• Поддерживать коррекцию чеков (возвраты, отмены).
• Работать с разными системами налогообложения (ОСН, УСН, НПД, патент).

Что должно быть на сайте, чтобы вы могли подключить платежный модуль Robokassa?

Информация о доставке товара или услуги; если доставки нет, нужно указать «самовывоз»

Информация об организации:

• адрес
• номер телефона
• наименование юрлица или ИП
• ИНН/ОГРН

Подробное описание товаров и услуг: цена, характеристики товара или услуги, комплектация и гарантийные условия

Наличие SSL-сертификата на сайте является обязательным условием для согласования и работы платежного модуля Robokassa

Проверьте, что сайт на VirtualityCMS:

• не переадресовывает на сторонние страницы или несуществующие ресурсы
• не содержит неработающие или ещё не готовые разделы или ссылки
• не содержит контент, который нарушает действующее законодательство

Подробнее о платежном модуле Robokassa

Robokassa (Робокасса) – ведущий сервис по приему онлайн-платежей, более 20 лет предлагающий максимально широкий спектр возможностей для оплаты товаров и услуг. На текущий момент сервис работает с юридическими лицами, индивидуальными предпринимателями и самозанятыми, зарегистрированными на территории РФ и Казахстана.

Самые востребованные способы оплат на одной платежной странице одним договором:

– банковские карты: РФ Visa, MasterCard, МИР;

– иностранные банковские карты: Visa, MasterCard, UnionPay; СБП;

– pay-методы: Mir Pay, T-Pay, SberPay, MTS Pay, Яндекс Пэй, Alfa Pay;

– оплата частями (BNPL) от сервисов «Подели» и «Яндекс Сплит»;

– рассрочка и кредит от ОТПбанк;

– карты рассрочки "Халва" и "120 дней без %";

– электронный кошелек ЮMoney.

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

Фискализация для любых случаев

– Robokassa Online - облачная касса с интернет-эквайрингом в одном договоре, полностью поддерживает 54-ФЗ, ФФД 1.2, маркировку и любые системы налогообложения юридических лиц

– Робочеки СМЗ - сервис автоматической отправки чеков для самозанятых и ИП, применяющих налог на профессиональную деятельность в соответствии с 422-ФЗ.

– Робочеки - сервис для быстрого запуска или небольшого количества чеков для юридических лиц, выдаваемых через облачную кассу Robokassa в соответствии с 54- ФЗ.

 

Чтобы подключить платежный модуль Robokassa для сайта необходимо:

1. Перейти на сайт Robokassa

   

2. Зарегистрируйте кабинет продавца

   

3. После регистрации Личного кабинета следующий шаг — анкета. Нажмите «Заполнить анкету» в списке действий на главной странице Личного кабинета.

   

   - Если у вас ИП или ООО, заполните анкету юридического лица. Вам понадобится набор документов ИП или юридического лица.

    

   - Если вы Самозанятый, заполните анкету – понадобится только копия вашего паспорта и справка о постановке на учёт в качестве самозанятого.

4. Создание магазина

   Переходим к созданию магазина. Здесь важно понимать, что под «магазином» подразумевается не только торговая точка, продающая товары. В это понятие входят онлайн-магазины, странички с hand-made товарами, площадки с онлайн-курсами и даже единственным билетом на платный вебинар. Если вы предлагаете любые платные товары или услуги, для Robokassa вы – владелец магазина.

   

    

   Подключить приём платежей можно во вкладке «Мои магазины». После нажатия кнопки «Создать магазин» откроется окно, в котором останется лишь заполнить все обязательные данные от идентификатора до способа вывода средств.

   - Если у вас ИП или юридическое лицо, укажите данные банковского счёта, который ему принадлежит. Или выберите счёт, если вы указывали его ранее.

   - Если вы самозанятый – это будет счёт физического лица.

   После запуска продаж выводить средства обозначенным выше способом вы сможете в разделе «Финансы» — «Баланс и вывод средств». Там же при желании можно настроить автоматический вывод по мере достижения определенной суммы или по графику.

5. Подключение сайта

6. Активация магазина

   Процедура активации магазина начинается после получения от вас необходимой информации:

   - размещения документов в Личном кабинете;

   - внесения информации на подключаемом ресурсе (указана в разделе «Требования к вашему сайту»).

   Для юридических лиц и ИП активация проходит в 2 этапа. Первая – активация приёма платежей: начнем с нее. Если вы закончили с настройками, переходите на главную страницу, в раздел «Мои магазины» > «Настройки» и отправляйте заявку на активацию приёма платежей. RoboKassa одобрит вашу заявку в течение суток – а если возникнут какие-либо проблемы, то помогут.

   

    

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

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

Чеклист после подключения модуля Robokassa на VirtualityCMS

Перед запуском приёма реальных денег выполните обязательные проверки:

1. Тестовый платёж — переведите 1 рубль (или используйте тестовые карты банка). Проверьте списание и зачисление.
2. Формирование чека (54-ФЗ) — убедитесь, что покупатель получает чек на почту/телефон, а в ОФД отображается статус «фискальный признак получен».
3. Callback / webhook — проверьте, что после оплаты заказ в VirtualityCMS меняет статус на «Оплачен».
4. Возврат средств — сделайте частичный или полный возврат, проверьте корректность отражения в админке и кассе.
5. Безопасность — убедитесь, что запросы между VirtualityCMS и платёжным шлюзом идут по HTTPS, а секретные ключи не хранятся в открытом виде.

Безопасность при работе с платежным модулем Robokassa

• PCI DSS — модуль не должен хранить CVV, паны карт или другие чувствительные данные. Всё идёт через платёжный шлюз.
• Подпись запросов — модуль Robokassa проверяет цифровую подпись каждого уведомления от банка, чтобы избежать поддельных запросов.
• Логирование — все транзакции записываются в защищённый лог VirtualityCMS для аудита и решения спорных ситуаций.

Типичные ошибки при интеграции Robokassa и их решение

• «Неверная подпись запроса» — проверьте секретный ключ и кодировку (часто проблема в лишних пробелах или не той кодировке).
• Чек не отправляется в ОФД — убедитесь, что в настройках модуля Robokassa выбран активный ОФД и корректно прописаны система налогообложения и ставка НДС.
• Двойное списание — реализуйте идемпотентность: модуль не должен обрабатывать одно и то же уведомление от банка дважды.
• Ошибка «Транзакция отклонена банком» — проверьте лимиты на стороне эквайринга и правильность валюты заказа.

Где получить помощь по платежному модулю Robokassa для VirtualityCMS?

Техподдержка VirtualityCMS поможет с настройкой модуля, тестированием платежей и соблюдением 54-ФЗ. Для платформы VirtualityCMS доступны готовые интеграции с крупнейшими эквайерами и сервисами рассрочки.

👉 Зарегистрируйтесь в VirtualityCMS и начните принимать платежи через Robokassa уже сегодня с полным соблюдением 54-ФЗ.

Важно про 54-ФЗ и онлайн-кассы

Если ваш модуль Robokassa не поддерживает автоматическую фискализацию чеков, вы нарушаете закон. При использовании облачной кассы внутри модуля все обязательства по 54-ФЗ выполняются автоматически. Подробнее — на официальном сайте ФНС или в документации вашего ОФД.

Инструкция по добавлению способа оплаты

1. Зайти в раздел “Настройки” в админпанели VirtualityCMS.

2. Открыть вкладку “Способ оплаты” и нажать кнопку ДОБАВИТЬ СПОСОБ ОПЛАТЫ.

   

3. В открывшейся окне

   • - указать любое название, например "Оплата банковскими картами";

   • - поставить флаг “Активен”;

   • - добавить иконку при необходимости;

   • - в "Настройки оплаты" выбрать нужный платежный сервис;

   • - выбрать основную валюту (выбрана по умолчанию);

   • - обязательно отметить "Возможные способы доставки";

   • - можно указать минимальное "Описание";

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

Подробнее об условиях работы с магазинами лучше узнавать в поддержке платежного сервиса.

Если у платежного сервиса нет интеграции с VirtualityCMS можно подключить оплату другими платежными сервисами. Это требует участия программиста. Также вы можете оставить запрос технической поддержки на этом сайте.