Покупатель оформил заказ, дошёл до оплаты — и упёрся в «переведите на карту менеджеру». Половина таких клиентов не платит: неудобно, непонятно, нет доверия. Онлайн-оплата картой прямо на сайте убирает это трение и заметно поднимает долю оплаченных заказов. ЮKassa — один из самых распространённых платёжных сервисов в рунете, и в 1С-Битрикс он подключается штатным обработчиком.
В этой статье — пошаговое подключение приёма оплаты через ЮKassa к магазину на 1С-Битрикс: настройка платёжной системы, кассовые чеки по 54-ФЗ, обработка уведомлений об оплате, тест и связка с обменом заказов в 1С. Полноценную настройку приёма платежей и учёта мы делаем в рамках автоматизации продаж и склада на 1С.
Коротко
- ЮKassa подключается штатным обработчиком платёжной системы Битрикса — по shopId и секретному ключу.
- При оплате от физлиц нужен кассовый чек по 54-ФЗ: настройте состав чека и ставки НДС.
- Ключевой механизм — уведомления об оплате: без них деньги приходят, а заказ остаётся неоплаченным.
- Всё сначала проверяют в тестовом режиме, и только потом переключают на боевые ключи.
Что даёт ЮKassa магазину
ЮKassa — платёжный агрегатор, который принимает оплату разными способами (карты, кошельки, рассрочка, СБП) и переводит деньги на ваш счёт. Для магазина это означает:
- Оплата на сайте. Клиент платит сразу при оформлении, а не переводом «на карту».
- Больше оплаченных заказов. Удобная оплата снижает долю брошенных и «повисших» заказов.
- Соответствие 54-ФЗ. Возможность пробивать кассовые чеки через онлайн-кассу.
- Автоматизацию. Заказ сам переходит в «оплачен» без ручной сверки платежей.
Ключевое здесь — автоматизация: правильно подключённая ЮKassa снимает с менеджеров ручную сверку оплат и убирает человеческие ошибки в статусах заказов.
Что нужно подготовить до старта
Перед настройкой на сайте нужен минимальный набор готовых вещей:
| Что нужно | Зачем | Откуда взять |
|---|---|---|
| Договор с ЮKassa | Приём платежей и вывод средств | Личный кабинет ЮKassa |
| shopId и секретный ключ | Авторизация запросов к API | Раздел интеграции в ЮKassa |
| Онлайн-касса | Чеки по 54-ФЗ | Своя ККТ или облачная от ЮKassa |
| Настроенное налогообложение | Корректные ставки НДС в чеке | Настройки магазина и 1С |
Без действующего договора и учётных данных настройка не заработает, поэтому эти пункты закрывают заранее. Онлайн-касса нужна, если принимаете оплату от физлиц и обязаны пробивать чеки.
Штатный обработчик в 1С-Битрикс
Хорошая новость: в редакциях Битрикса с торговым каталогом (Малый бизнес, Бизнес и старше) ЮKassa подключается штатным обработчиком платёжной системы. Отдельный модуль из Маркетплейса, как правило, не требуется.
Платёжная система в Битрикс — это связка «обработчик + настройки», которая привязывается к способам оплаты в заказе. Обработчик ЮKassa отвечает за формирование запроса на оплату, редирект клиента и приём подтверждения. Для нетиповых сценариев (сплитование платежей, маркетплейс-модель с выплатами продавцам) обработчик дорабатывают или строят интеграцию через API — это ближе к разработке модуля маркетплейса.
Настройка платёжной системы пошагово
Базовое подключение в админке выглядит так (названия пунктов зависят от редакции):
- Добавьте платёжную систему. В разделе «Магазин → Платёжные системы» создайте новую и выберите обработчик ЮKassa.
- Введите учётные данные. Укажите shopId и секретный ключ из личного кабинета ЮKassa.
- Настройте способы оплаты. Выберите, какие методы (карты, СБП, кошельки) показывать клиенту.
- Привяжите к типу плательщика. Определите, для каких плательщиков и служб доставки доступна эта оплата.
- Задайте параметры чека. Если пробиваете чеки — включите фискализацию и настройте состав чека.
- Сохраните и проверьте. Убедитесь, что оплата появляется в оформлении заказа.
После этого на шаге оплаты заказа у клиента появится способ «Банковская карта / ЮKassa», а при выборе — редирект на защищённую платёжную форму.
Кассовые чеки по 54-ФЗ
Если вы принимаете оплату от физлиц, закон 54-ФЗ требует формировать кассовый чек при каждом расчёте. ЮKassa умеет пробивать чеки через подключённую онлайн-кассу — свою или облачную от самого сервиса.
Механика такая: при оплате Битрикс передаёт в ЮKassa состав чека (позиции заказа, цены, ставки НДС, признаки расчёта), а ЮKassa отправляет данные в кассу, которая формирует фискальный чек и передаёт его в налоговую. Клиент получает чек на почту или телефон.
Ставки НДС и состав чека
Самая частая причина проблем с чеками — неправильные ставки НДС. В чек передаётся ставка по каждой позиции, и она должна соответствовать вашей реальной системе налогообложения:
- Соответствие налогообложению. На УСН обычно «без НДС», на ОСН — конкретная ставка по товару.
- Ставка на уровне товара. НДС настраивается в свойствах товара и приходит из 1С при обмене.
- Признак предмета расчёта. Товар, услуга, доставка — у каждого свой признак в чеке.
- Согласованность с 1С. Данные о ставках в чеке и в учётной системе не должны расходиться.
Ошибка в ставке приводит к отклонению чека кассой или к расхождениям с налоговой. Поэтому ставки НДС сверяют с бухгалтерией и настройками 1С до запуска.
Уведомления и статус оплаты
Это самый важный и самый недооценённый механизм. После успешной оплаты ЮKassa уведомляет сайт через уведомление (webhook на специальный URL обработчика). Именно это уведомление переводит заказ в статус «оплачен».
Чтобы это работало:
- URL уведомлений доступен извне. Обработчик не закрыт файрволом, robots или авторизацией.
- Проверка подлинности. Обработчик проверяет, что уведомление действительно от ЮKassa, а не подделка.
- Идемпотентность. Повторные уведомления не задваивают оплату заказа.
- Логирование. Уведомления пишутся в лог для диагностики спорных случаев.
Безопасность обработки входящих уведомлений — отдельная важная тема, мы разбирали её в статье про безопасность REST и вебхуков в Битрикс. Если уведомления не обрабатываются, деньги приходят в ЮKassa, но заказ на сайте висит неоплаченным.
Тестовый режим и проверка
Запускать приём оплаты сразу на боевых ключах — риск. ЮKassa даёт тестовый режим, и им обязательно надо воспользоваться:
- Настройте на тестовых данных. Укажите тестовые shopId и ключ.
- Проведите пробные оплаты. Оплатите заказ тестовыми картами разных сценариев (успех, отказ).
- Проверьте статус заказа. Убедитесь, что после оплаты заказ переходит в «оплачен» автоматически.
- Проверьте чек. Состав, ставки НДС и признаки расчёта в тестовом чеке корректны.
- Переключитесь на бой. Только убедившись в работе всего цикла, вводите боевые учётные данные.
Связка с обменом заказов в 1С
Оплата на сайте — только половина картины. В большинстве магазинов заказы и их статусы выгружаются в 1С, где формируются документы и ведётся учёт. Когда заказ помечается оплаченным на сайте, эта информация должна доехать в 1С при обмене.
Здесь важно согласовать статусы: что на сайте значит «оплачен», как это отражается в 1С, кто источник истины по факту оплаты. Без согласования менеджеры видят расходящуюся картину — на сайте оплачено, в 1С нет, или наоборот. Настройка стабильного обмена заказами — часть автоматизации, и её мы закрываем услугой автоматизации на 1С.
Безопасность ключей
Секретный ключ ЮKassa — это, по сути, пароль от приёма ваших денег. Обращаться с ним нужно соответственно:
- Только на сервере. Ключ никогда не попадает в клиентский код или в разметку страницы.
- Защищённое хранение. Хранится в настройках платёжной системы или защищённой конфигурации, не в публичных файлах.
- Ограниченный доступ. К настройкам платёжной системы имеют доступ только доверенные администраторы.
- Ротация при утечке. При подозрении на компрометацию ключ немедленно меняют в кабинете ЮKassa.
Частые ошибки
- Не настроены уведомления. Оплата проходит, а заказ остаётся неоплаченным.
- Запуск без теста. Первую же боевую оплату ловят с ошибкой в составе чека.
- Неверные ставки НДС. Чек отклоняется кассой или расходится с налогообложением.
- Приём оплаты без чека. Нарушение 54-ФЗ и риск штрафов.
- URL уведомлений закрыт. Файрвол или авторизация блокируют входящие от ЮKassa.
- Рассинхрон с 1С. Статусы оплаты на сайте и в учёте не согласованы.
Чек-лист подключения
- Договор и ключи готовы. Есть действующий договор, shopId и секретный ключ.
- Платёжная система настроена. Обработчик ЮKassa добавлен, способы оплаты выбраны.
- Фискализация включена. Онлайн-касса подключена, состав чека настроен.
- Ставки НДС сверены. Ставки соответствуют налогообложению и данным из 1С.
- Уведомления работают. URL доступен, подпись проверяется, повторы не задваивают оплату.
- Тест пройден. Пробные оплаты, смена статуса и чек проверены в тестовом режиме.
- Связка с 1С согласована. Статусы оплаты доезжают в учёт при обмене.
- Ключи защищены. Секретный ключ хранится безопасно, доступ ограничен.
Вывод
Подключить ЮKassa к магазину на 1С-Битрикс несложно — обработчик штатный, и базовая настройка занимает немного времени. Но дьявол в деталях: кассовые чеки по 54-ФЗ, правильные ставки НДС, обработка уведомлений об оплате и согласование статусов с 1С. Именно на этих деталях чаще всего спотыкаются, и именно они превращают «оплату вроде работает» в надёжный приём платежей.
Главное правило — не запускать приём оплаты без теста и без настроенных уведомлений. Пройдите весь цикл в тестовом режиме, убедитесь, что заказ автоматически становится оплаченным и чек формируется корректно, и только потом включайте боевые ключи. А чтобы связать оплату с учётом без ручной сверки, настройте это вместе с автоматизацией продаж и склада на 1С.
