ЮKassa — самый частый выбор для приёма онлайн-оплаты в интернет-магазинах на 1С-Битрикс. Формально подключение занимает полчаса, но корректная работа с чеками, статусами и возвратами требует понимания того, как модуль sale обменивается данными с платёжным шлюзом. Разбираем настройку по шагам глазами интегратора.
Что такое ЮKassa и как она работает в Битрикс
ЮKassa (бывшая Яндекс.Касса) — это платёжный агрегатор, который принимает деньги за вас: банковские карты, СБП, кошелёк ЮMoney, Сбербанк Онлайн, рассрочку. Покупатель уходит с сайта на защищённую платёжную форму ЮKassa, оплачивает и возвращается на страницу результата. Ваш сайт при этом не хранит данные карт и не попадает под жёсткие требования PCI DSS.
В 1С-Битрикс за приём оплаты отвечает модуль sale и его сущность «Платёжная система» (/bitrix/admin/sale_pay_system.php). Для ЮKassa используется штатный обработчик yandexcheckout (в старых редакциях — yandex). Он формирует запрос на создание платежа через API v3 и принимает уведомления о смене статуса.
- Redirect-сценарий — оплата на стороне ЮKassa, подходит большинству магазинов.
- Виджет — форма встроена в вашу страницу оформления (нужен отдельный ключ).
- Смарт-платёж — единая кнопка со всеми доступными способами.
Что получить в личном кабинете до настройки
Перед тем как открывать админку Битрикс, зарегистрируйте магазин в ЮKassa и дождитесь подключения (проверка занимает 1–3 рабочих дня). В личном кабинете вам понадобятся два ключевых реквизита:
| Реквизит | Где взять | Назначение |
|---|---|---|
| shopId | Настройки → магазин | Идентификатор магазина |
| Секретный ключ | Интеграция → Ключи API | Авторизация запросов API v3 |
test_*) и боевой (live_*). Не перепутайте — на боевом ключе тестовые карты не пройдут, а на тестовом реальные деньги не спишутся.Отдельно в кабинете включите нужные способы оплаты (карты, СБП, ЮMoney) и, если работаете по 54-ФЗ, привяжите онлайн-кассу или включите фискализацию силами ЮKassa.
Настройка платёжной системы в админке
Заходим в Магазин → Платёжные системы → Добавить. Выбираем обработчик ЮKassa и заполняем параметры:
- shopId и Секретный ключ — из личного кабинета.
- Способ оплаты по умолчанию — как правило, «Банковская карта» или «Смарт-платёж».
- Тип чека / фискализация — если чек формирует ЮKassa, укажите ставку НДС и предмет расчёта.
- Тестовый режим — на время отладки включаем, потом снимаем.
Привяжите платёжную систему к нужным способам оплаты покупателя и к валюте магазина. Если у вас несколько сайтов (мультисайтовость), проверьте, что платёжка привязана к правильному LID и типу плательщика.
HTTP-уведомления и смена статуса заказа
Ключевой момент, который чаще всего ломается. ЮKassa не сообщает об оплате синхронно — она отправляет асинхронное HTTP-уведомление (webhook) на ваш сайт. Именно оно помечает заказ оплаченным, даже если покупатель закрыл вкладку.
В личном кабинете ЮKassa в разделе Интеграция → HTTP-уведомления укажите URL обработчика Битрикс. Обычно это адрес вида:
https://ваш-домен.ru/bitrix/tools/sale_ps_result.php
Подпишитесь минимум на события payment.succeeded, payment.canceled и refund.succeeded. При приёме уведомления модуль sale сверяет сумму и статус платежа через API и выставляет заказу флаг «Оплачен».
- Если оплаты «висят» неоплаченными — проверьте доступность URL извне и отсутствие блокировок по IP/WAF.
- Сумма в уведомлении должна совпадать с суммой заказа до копейки, иначе платёж отклоняется.
- Логи полезно смотреть в самом кабинете ЮKassa — там видно код ответа вашего сервера.
Чеки 54-ФЗ, СБП и рекуррентные платежи
Если вы продаёте физлицам, при каждой оплате нужен фискальный чек. Есть два пути:
| Схема | Кто пробивает чек | Когда выбрать |
|---|---|---|
| Чек на стороне ЮKassa | ЮKassa (арендованная касса) | Нет своей ККТ, простая номенклатура |
| Чек на стороне Битрикс | Ваш модуль ОФД/касса | Есть своя касса, сложные ставки НДС |
В Битрикс за формирование чеков отвечает подсистема кассовых чеков (Магазин → Настройки → Кассы ККМ). Важно правильно задать ставку НДС и признак предмета/способа расчёта в товарах и доставке.
СБП включается как отдельный способ оплаты в кабинете ЮKassa и появляется на платёжной форме автоматически. Рекуррентные (автоматические) платежи для подписок требуют сохранения способа оплаты: при первом платеже включается флаг save_payment_method, а последующие списания инициируются по расписанию через API.
Возвраты и сверка платежей
Возврат средств покупателю в Битрикс оформляется через возврат оплаты в карточке заказа. Модуль отправляет в ЮKassa запрос refund, и деньги возвращаются на исходную карту или в СБП. При частичном возврате важно, чтобы был пробит корректирующий чек «возврат прихода».
- Полный возврат — заказ отменяется, статус оплаты снимается.
- Частичный возврат — возвращается сумма по конкретным позициям.
- Срок зачисления на карту покупателя — до нескольких рабочих дней (зависит от банка).
Итог
Подключение ЮKassa к 1С-Битрикс — это не только ввод shopId и ключа, но и корректная настройка HTTP-уведомлений, фискализации по 54-ФЗ, возвратов и, при необходимости, рекуррентных платежей и СБП. Ошибки в webhook или в тестовом режиме приводят к «потерянным» оплатам, поэтому связку всегда нужно проверять на реальных транзакциях.
Мы в B2Bsite подключаем ЮKassa и другие платёжные системы под ключ: настраиваем чеки, сверку с 1С, возвраты и подписочные списания, а затем сдаём связку с полным прогоном сценариев оплаты. Если нужна надёжная приёмка денег без сюрпризов на боевом трафике — поможем.
Частые вопросы
Нужен ли собственный сертификат PCI DSS для приёма карт через ЮKassa?
Нет. Данные карты вводятся на стороне ЮKassa, ваш сайт их не хранит и не обрабатывает, поэтому тяжёлая сертификация PCI DSS не требуется. Достаточно валидного SSL-сертификата на домене.
Почему заказ оплачен в ЮKassa, но в Битрикс висит неоплаченным?
Почти всегда причина в HTTP-уведомлениях: URL обработчика недоступен извне, заблокирован файрволом или WAF, либо не совпадает сумма. Проверьте доступность sale_ps_result.php и логи ответов в кабинете ЮKassa.
Можно ли принимать оплату по СБП через ЮKassa?
Да. СБП включается отдельным способом оплаты в личном кабинете ЮKassa и после этого автоматически появляется на платёжной форме без доработок на стороне Битрикс.
Кто пробивает фискальный чек — ЮKassa или мой сайт?
Возможны оба варианта. Если у вас нет своей онлайн-кассы, чек формирует ЮKassa. Если касса есть, чек можно пробивать через кассовую подсистему Битрикс и своего ОФД.
Поддерживаются ли подписки и автоплатежи?
Да, через рекуррентные платежи. При первом списании сохраняется способ оплаты, а последующие платежи инициируются автоматически по расписанию через API ЮKassa.
Как сделать возврат покупателю?
Возврат оформляется в карточке заказа Битрикс, модуль отправляет запрос на возврат в ЮKassa. При этом нужно пробить корректирующий чек возврата прихода, если оплата фискализировалась.
В чём разница между тестовым и боевым ключом?
Тестовый ключ (test_) работает только с тестовыми картами и не списывает реальные деньги, боевой (live_) — с настоящими платежами. Перед запуском обязательно переключите обработчик на боевой ключ и снимите тестовый режим.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.