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

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

Подключение возможно несколькими способами: через готовый модуль для типовых конфигураций (1С-Битрикс с обменом в 1С, «1С:Управление нашей фирмой», «1С:Управление торговлей»), через сервис «1С:Сервис приёма платежей» или через API ЮKassa с доработкой конфигурации. Выбор зависит от вашей конфигурации, объёма платежей и наличия сайта.

Перед началом работы убедитесь, что у вас есть зарегистрированный магазин в ЮKassa, доступ к личному кабинету и права администратора в 1С. Ниже разобраны все этапы: от регистрации до проверки первого реального платежа.

Что нужно подготовить перед подключением

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

Определите, какая у вас конфигурация 1С. От этого зависит способ интеграции:

• 1С:УНФ, 1С:Управление торговлей 11, 1С:Комплексная автоматизация — есть встроенная поддержка приёма платежей через сервис «1С:Сервис приёма платежей», который работает с ЮKassa;
• Устаревшие конфигурации (УТ 10.3, УПП) — потребуется внешняя обработка или доработка;
• Интернет-магазин на 1С-Битрикс с обменом в 1С — интеграция настраивается на стороне сайта, а заказы с оплатами передаются в 1С при обмене.

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

Регистрация магазина в ЮKassa и получение ключей

Зарегистрируйтесь в личном кабинете ЮKassa, заполните анкету организации и загрузите запрашиваемые документы. После проверки и подписания договора магазин активируется — обычно модерация занимает несколько рабочих дней. Без этого шага техническая настройка в 1С бесполезна: платежи не будут проходить.

После активации перейдите в раздел «Настройки» → «Ключи API» (в некоторых версиях интерфейса — «Интеграция» → «Ключи API»). Здесь вам понадобятся два параметра:

• shopId — идентификатор магазина, виден сразу;
• Secret key (секретный ключ) — генерируется отдельно и показывается один раз, сохраните его сразу в защищённом месте.

Если планируете принимать оплату с фискализацией чеков через ЮKassa (по 54-ФЗ), дополнительно подключите онлайн-кассу и настройте передачу данных о чеках — это отдельный раздел в личном кабинете, который потребуется и при настройке на стороне 1С.

Способ 1: настройка через «1С:Сервис приёма платежей»

Для типовых конфигураций на управляемых формах (УНФ, УТ 11, КА 2, ERP) самый простой путь — встроенный сервис приёма платежей. Он поддерживает работу с ЮKassa и позволяет выставлять счета со ссылкой на оплату прямо из документов.

1. 1
   Откройте раздел настроек организации или продаж и найдите пункт «Приём платежей» / «Оплата картой и СБП» (название зависит от конфигурации).
2. 2
   Нажмите «Подключить» и авторизуйтесь под учётной записью портала 1С — сервис доступен при действующем договоре ИТС.
3. 3
   Выберите платёжную систему ЮKassa и укажите shopId и секретный ключ из личного кабинета.
4. 4
   Укажите организацию, кассу или банковский счёт для отражения поступлений, а также ставку НДС для чеков.
5. 5
   Сохраните настройки и выполните тестовое выставление счёта.
6. 6
   Проверьте, что в созданном счёте появилась ссылка или QR-код на оплату и её можно открыть в браузере.

После подключения в документах «Счёт на оплату покупателю» появится возможность сформировать ссылку на оплату. Клиент переходит по ней, платит картой, через СБП или иным доступным способом, а 1С получает уведомление о платеже и автоматически создаёт документ поступления денежных средств, закрывая задолженность.

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

Способ 2: интеграция через сайт и обмен с 1С

Если у вас интернет-магазин на 1С-Битрикс, оплата настраивается на стороне сайта, а не в 1С. В административной части Битрикса установите модуль ЮKassa из маркетплейса решений, введите shopId и секретный ключ, выберите способы оплаты и настройте фискализацию.

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

Для самописных сайтов интеграция выполняется по API ЮKassa: сайт создаёт платёж, получает от ЮKassa ссылку на страницу оплаты и обрабатывает вебхуки (уведомления) о смене статуса. В 1С данные попадают через обмен по HTTP, файл или промежуточную базу — это уже задача для разработчика.

Способ 3: прямая работа с API ЮKassa из 1С

Для нетиповых конфигураций или специфических сценариев (автоплатежи, рекуррентные списания, сложные возвраты) можно обращаться к API ЮKassa напрямую из кода 1С через HTTP-запросы. Аутентификация выполняется по паре shopId и секретный ключ с базовой авторизацией.

Типовой запрос на создание платежа выглядит как POST-запрос к API с телом в формате JSON, содержащим сумму, валюту, описание и URL возврата клиента. В ответ ЮKassa возвращает идентификатор платежа и ссылку на страницу оплаты.

Соединение = Новый HTTPСоединение("api.yookassa.ru", 443, ShopId, СекретныйКлюч,,, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/v3/payments");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Idempotence-Key", Строка(Новый УникальныйИдентификатор));
Запрос.УстановитьТелоИзСтроки(ТелоJSON);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);

Ключевые моменты при самостоятельной разработке: обязательно используйте заголовок Idempotence-Key с уникальным значением для каждого платежа — это защищает от двойных списаний при повторной отправке запроса. Статусы платежей получайте либо периодическим опросом API, либо через вебхуки, для приёма которых потребуется опубликованный HTTP-сервис 1С.

Настройка фискализации и чеков

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

В настройках магазина в личном кабинете ЮKassa включите передачу данных для чеков и укажите систему налогообложения. На стороне 1С или модуля сайта проверьте, что в платеже передаются корректные ставки НДС и наименования товаров — ошибки в этих данных приводят к отказам в фискализации или неверным чекам.

Проверьте соответствие ставок НДС в номенклатуре 1С и в передаваемых данных. Частая проблема — товары со ставкой «Без НДС» и «НДС 0%» перепутаны, что для чека имеет принципиальное значение.

Тестирование и проверка работы

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

Порядок проверки: создайте тестовый счёт в 1С, сформируйте ссылку на оплату, оплатите её тестовой картой, дождитесь смены статуса платежа в 1С и убедитесь, что создан документ поступления и закрыта задолженность по счёту. Затем выполните тестовый возврат и проверьте его отражение.

Типичные ошибки и их решение

Если платёж прошёл в ЮKassa, но не отразился в 1С, сначала проверьте статус платежа в личном кабинете ЮKassa, затем — журнал обмена или регламентные задания в 1С. Большинство таких ситуаций связано с остановленными фоновыми заданиями или потерей связи, а не с потерей данных: платёж можно загрузить повторно.

Часто задаваемые вопросы