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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подробнее о платежном модуле ЮКасса

ЮКасса — это современный платёжный сервис для интернет-магазинов, позволяющий принимать онлайн-оплату на сайте. Он включает в себя модуль оплаты, который легко устанавливается на ваш сайт, и платёжный сервис, обеспечивающий безопасность и удобство для покупателей. Чтобы подключить этот модуль, следуйте инструкциям от ЮКасса и установите его в панели управления вашего сайта. После этого вы сможете принимать платежи от покупателей прямо на вашем сайте, обеспечивая удобство и скорость процесса оплаты.

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

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

1. Перейдите на сайт ЮKassa

   

2. Зарегистрируйтесь в ЮKassa

   Подготовьте: ИНН. Нужно будет ввести номер телефона, имя, почту, форму бизнеса и номер ИНН, придумать пароль. Если вы уже регистрировались в ЮKassa или пользуетесь ЮMoney, то зайти можно через существующий аккаунт.

   

3. Заполните данные для договора

   Подготовьте:

   • - реквизиты счёта вашей организации

   • - сведения о государственной регистрации

   • - фото или скан паспорта руководителя

   • - паспортные данные других владельцев компании

   После регистрации вы попадёте в личный кабинет ЮKassa, там мы попросим заполнить данные о вашей организации. Это нужно для оформления договора.

   

4. Отправьте данные на проверку

   Бывает, что мы возвращаем данные на доработку. Например, у нас не получилось зайти на ваш сайт или нужно что‑то дополнить. Тогда мы отправим вам письмо и расскажем в личном кабинете, что именно нужно изменить.

   

5. Подпишите договор

   После проверки пришлём вам договор в личном кабинете ЮKassa. Его нужно будет распечатать, подписать и прислать нам фото.

   

6. Проведите интеграцию для сайта

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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