Как подключить ЮKassa к Битрикс: инструкция

Коротко: Чтобы подключить ЮKassa к Битрикс, необходимо выбрать подходящий модуль, настроить платежную систему через раздел «Магазин» (для сайта) или «Центр продаж» (для Bitrix24) и прописать URL обработчика. Важно учитывать, что с 2026 года комиссия включает НДС 22%, а выплаты на карты возможны только физическим лицам.

Кстати, в AmSales мы делаем внедрение и настройку Битрикс24 и разработку сайтов и приложений под ключ. Если нужна помощь - напишите нам.

Автоматизация приема платежей - это не просто кнопка «Оплатить» на сайте. Это связка вашего интернет-магазина, CRM-системы и банковского эквайринга, которая работает без участия менеджера. Если процесс настроен криво, вы получите либо «повисшие» заказы, которые не перешли в оплаченные, либо проблемы с налоговой из-за отсутствия чеков. Сегодня, 26 сентября 2026 года, стандарты интеграции стали жестче, особенно в части передачи маркировки и работы с новыми протоколами API.

Выбор модуля ЮKassa для вашего сайта

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

В каталоге 1С-Битрикс сейчас актуален модуль «ЮКасса (Yookassa): прием платежей, эквайринг, автоплатежи, передача маркировки». Его версия 1.4.4 от августа 2026 года - это мощный инструмент для тех, кому важна работа с чеками и маркированным товаром. Если рассматривать вопрос через призму бюджета, то модуль юкасса битрикс цена которого составляет 4 000 руб., окупается за счет снижения нагрузки на бухгалтерию и исключения ошибок при передаче данных в систему маркировки. Это критично, если вы продаете одежду, парфюмерию или другие категории товаров, подлежащие контролю.

Существует также вариант «Платёжный модуль ЮКасса Старт». Он более универсален в плане протоколов: поддерживает как старый HTTP, так и новый API-протокол. Это полезно, если у вас старая версия системы или специфическая архитектура сайта, которая конфликтует с современными требованиями безопасности. Однако для большинства современных проектов на актуальных версиях Битрикса (v.17.6.0 и выше) предпочтительнее использовать новые API-решения, так как они быстрее и стабильнее обрабатывают запросы.

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

Сравнение вариантов подключения

Настройка платежной системы в 1С-Битрикс

Процесс настройки сильно зависит от того, используете ли вы классический интернет-магазин на базе 1С-Битрикс или работаете через CRM Bitrix24. В первом случае логика строится вокруг корзины и оформления заказа. Если вы хотите подключить юкасса к битрикс на сайте, путь будет следующим: заходите в административную панель, выбираете раздел Магазин, далее Настройки и затем Платежные системы. Там вам нужно найти обработчик ЮKassa (yandexcheckout).

Важный нюанс: официальная инструкция, актуальная на конец сентября 2026 года, требует, чтобы ваша версия системы была не ниже 17.6.0. Если у вас более старая сборка, вы можете столкнуться с тем, что настройки API просто не будут отображаться или будут работать некорректно. После выбора обработчика система попросит вас ввести идентификаторы (ShopID и Secret Key), которые вы должны заранее получить в личном кабинете ЮKassa.

После ввода ключей необходимо проверить работоспособность. Недостаточно просто сохранить настройки. Нужно убедиться, что статус заказа в Битриксе меняется на «Оплачен» сразу после успешной транзакции. Для этого критически важно правильно указать URL обработчика. Согласно технической документации, он должен вести на /bitrix/tools/sale_ps_result.php. Если вы ошибетесь хотя бы в одном символе, уведомление от банка не дойдет до сайта, и клиент увидит «Ожидание оплаты», хотя деньги с его карты уже списаны. Это самая частая причина жалоб в техподдержку.

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

Интеграция ЮKassa в CRM Bitrix24

Если ваш бизнес строится не вокруг витрины сайта, а вокруг прямых продаж через менеджеров, вам нужна настройка юкасса в bitrix24. Здесь логика иная. Мы не настраиваем корзину, мы настраиваем возможность выставления счета прямо из сделки. Это позволяет клиенту получить ссылку на оплату в мессенджер или на почту, нажать на нее и мгновенно завершить покупку.

Путь настройки в CRM выглядит так: CRM -> Продажи -> Управление продажами -> Центр продаж -> Платежные системы. В отличие от сайта, здесь подключение часто происходит через авторизацию. Вам предложат войти в аккаунт Яндекса, к которому привязана ваша ЮKassa. Это современный и безопасный способ, который избавляет от необходимости вручную переписывать длинные ключи API и снижает риск ошибки.

Интеграция позволяет автоматизировать жизненный цикл сделки. Как только клиент вводит данные карты и нажимает «Оплатить», Bitrix24 получает сигнал. Сделка автоматически переходит на следующий этап воронки, например, с «Счет выставлен» на «Оплачено». Это освобождает РОПа и менеджеров от необходимости вручную проверять банковскую выписку и передвигать карточки клиентов. В 2026 году, когда скорость реакции на запрос клиента определяет конверсию, такая автоматизация является стандартом индустрии.

Однако будьте внимательны с типами сделок. Если вы используете Bitrix24 для работы с B2B-сектором, где преобладают счета на оплату по расчетному счету, ЮKassa может быть лишь одним из инструментов. Но для сегмента B2C или микро-бизнеса, где важна моментальная оплата картой или через СБП, интеграция через Центр продаж является обязательной. Она превращает CRM из простого блокнота с контактами в полноценный финансовый инструмент.

Подключение онлайн-чеков и налоговой отчетности

Вопрос налоговой отчетности часто становится «сюрпризом» для предпринимателей после настройки эквайринга. Мало просто принять деньги, нужно еще и выдать чек в соответствии с законом. В случае с ЮKassa процесс автоматизирован, но требует правильной конфигурации в двух местах: в личном кабинете платежной системы и в настройках самого Битрикса.

Сначала вам нужно зайти в личный кабинет ЮKassa и убедиться, что сервис облачной кассы или интеграция с вашей онлайн-кассой активна. Только после этого переходите в настройки платежной системы в Bitrix24 или 1С-Битрикс. Там появится важная опция: «Использовать чеки от ЮKassa». Если ее не включить, платеж пройдет, деньги поступят, но законного документа у покупателя не будет, а у вас - проблем с налоговой.

Интеграция чеков позволяет передавать в фискальный накопитель не только сумму, но и состав заказа: наименования товаров, их количество, ставки НДС и даже данные о маркировке (если вы используете соответствующий модуль). Это избавляет от необходимости вручную пробивать чеки в сторонних сервисах. Весь цикл: оплата -> создание чека -> отправка чека клиенту на email -> передача данных в налоговую - происходит в фоновом режиме за доли секунды.

Важно понимать, что если вы используете стороннюю кассу (не через сервис ЮKassa), то процесс настройки будет сложнее. Вам придется настраивать передачу данных через API вашей кассы. Но для большинства малых и средних компаний использование встроенного функционала «чеки от ЮKassa» является самым коротким и надежным путем, минимизирующим риск человеческой ошибки при заполнении реквизитов.

Технические нюансы API и URL обработчика

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

Одной из самых критичных точек является URL обработчика. Как мы уже упоминали, для 1С-Битрикс это /bitrix/tools/sale_ps_result.php. Если ваш сайт находится за прокси-сервером или использует сложную структуру URL (например, через Nginx с кастомными правилами редиректа), убедитесь, что запросы от ЮKassa (webhook-и) не блокируются и не перенаправляются на страницу 404 или страницу входа в админку. Если обработчик не может «достучаться» до системы, статус платежа не обновится.

Второй нюанс - это работа с SSL-сертификатом. ЮKassa не будет отправлять данные на сайт, если у него нет валидного HTTPS-соединения. В 2026 году использование самоподписанных сертификатов в коммерческих проектах недопустимо. Также стоит обратить внимание на тайм-ауты. Если ваш сервер перегружен и не отвечает на запрос ЮKassa в течение нескольких секунд, система может расценить это как ошибку и не повторить попытку отправки уведомления, что приведет к рассинхронизации данных.

Наконец, при работе с API обратите внимание на логирование. В настройках модуля всегда стоит включить режим логирования ошибок (хотя бы на период внедрения). Если платеж не проходит, в логах будет четко написано: неверный ключ, ошибка формата JSON или ошибка авторизации. Без логов вы будете гадать, почему клиент жалуется на невозможность оплаты, вместо того чтобы просто исправить одну строчку в конфигурации.

Актуальные комиссии и новые правила выплат

Финансовое планирование - это то, на чем многие спотыкаются при масштабировании. С 1 января 2026 года в ЮKassa произошли важные изменения в структуре расходов. Теперь комиссия за проведение платежей увеличивается на сумму НДС. Это означает, что если ваша стандартная комиссия составляет, например, 2.5%, то фактически вы будете платить 2.5% + 22% НДС от этой суммы комиссии. Это нужно обязательно закладывать в юнит-экономику вашего продукта, иначе маржинальность будет ниже ожидаемой.

Еще один важный аспект - это правила выплат. Если вы используете ЮKassa для выплат контрагентам или партнерам, помните о жестком ограничении: выплаты на банковские карты можно делать только на карты физических лиц. Использование бизнес-карт для получения выплат через этот механизм не сработает. Это правило было четко зафиксировано в обновлениях документации в сентябре 2026 года. Если ваш бизнес-процесс завязан на выплаты юрлицам через карты, вам придется искать альтернативные методы, например, через расчетный счет.

Ниже приведена таблица, которая поможет сориентироваться в новых правилах:

Также стоит учитывать, что правила возвратов постоянно уточняются. Например, для метода SberPay (способ SB) теперь действует ограничение: вернуть платеж можно в течение 13 месяцев с момента регистрации заказа. Это довольно длительный срок, который нужно учитывать при управлении оборотным капиталом и при оценке рисков возвратов в вашем магазине.

Методы оплаты: от СБПа до SberPay

Современный покупатель не хочет вводить 16 цифр карты вручную. Он хочет нажать одну кнопку и подтвердить платеж в приложении банка. Поэтому при настройке платежных систем битрикс ваша задача - предоставить максимальный выбор методов оплаты. ЮKassa предоставляет доступ к самому широму спектру инструментов, которые сейчас актуальны на рынке РФ.

Во-первых, это СБП (Система быстрых платежей). Она обеспечивает самую высокую конверсию и минимальные комиссии для бизнеса. Клиент просто сканирует QR-код или переходит по ссылке, и оплата происходит мгновенно. Во-вторых, это экосистемные решения, такие как SberPay. В Bitrix24 через ЮKassa можно подключить не только обычный SberPay, но и его вариации: SberPay по SMS или SberPay QR. Это критически важно для мобильного трафика, где ввод данных карты затруднен.

Кроме того, доступны такие методы, как Альфа-Клик и T-Pay. Они работают по схожему принципу: быстрая авторизация через банковское приложение. Для тех, кто продает дорогие товары, крайне важно наличие опции «покупка в кредит». ЮKassa позволяет интегрировать этот функционал, что значительно увеличивает средний чек. Также не забывайте про виджет ЮKassa - это готовое визуальное решение, которое можно встроить в интерфейс, чтобы пользователю было привычно и понятно, куда нажимать.

Разнообразие методов оплаты напрямую влияет на ваш показатель брошенных корзин. Если у клиента есть привычка платить через конкретный банк (например, через T-Pay), а у вас доступна только классическая оплата картой, вы теряете часть прибыли. Поэтому при настройке всегда проверяйте, чтобы все ключевые методы были активны и корректно отображались на мобильных устройствах.

Типичные ошибки при внедрении эквайринга

Даже профессиональные разработчики иногда допускают ошибки, которые стоят бизнесу денег. Первая и самая распространенная - это игнорирование тестового режима. Многие пытаются настроить всё "в боевом режиме", чтобы сразу увидеть результат. В итоге: первая транзакция реального клиента проходит с ошибкой, статус заказа не меняется, клиент расстроен, деньги списаны, а менеджер не видит заказа. Всегда начинайте с тестов.

Вторая ошибка - неправильная настройка URL обработчика или блокировка вебхуков брандмауэром (firewall) сервера. Вы можете идеально настроить модуль, ввести все ключи, но если ваш сервер не принимает входящие запросы от IP-адресов ЮKassa, магии не произойдет. Статус оплаты в Битриксе будет висеть в ожидании вечно. Проверяйте доступность вашего сайта для внешних запросов и логи сервера на наличие попыток обращения к файлу sale_ps_result.php.

Третья ошибка связана с налогами и чеками. Как мы уже говорили, многие забывают включить опцию «Использовать чеки от ЮKassa». Это приводит к тому, что бизнес работает в "серую" не по своей воле, а по технической ошибке. В 2026 году налоговый контроль автоматизирован, и отсутствие фискальных данных по каждой транзакции - это прямой путь к штрафам. Также проверяйте, чтобы передаваемые в чек суммы и ставки НДС соответствовали вашим реальным ценам в каталоге.

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

Что запомнить

• Для 1С-Битрикс используйте обработчик /bitrix/tools/sale_ps_result.php и версию системы не ниже 17.6.0.
• В Bitrix24 настройка идет через Центр продаж с использованием авторизации через аккаунт Яндекса.
• С 2026 года комиссия включает НДС 22%, а выплаты на карты возможны только физическим лицам.
• Обязательно включайте опцию «Использовать чеки от ЮKassa» для соблюдения налогового законодательства.
• Всегда тестируйте интеграцию в тестовом режиме перед запуском на реальные деньги.