Интеграция цифрового рубля: план ИТ-отдела по неделям для сайта, приложения, кассы и 1С

Редакция NorthCodeСверено 15 ноября 20269 мин чтения

API, callback и 1С

Коротко, на 15.11.2026

Интеграция цифрового рубля строится через API банка: сайт, приложение или касса создают заказ с orderId и универсальным QR, а банк присылает уведомление об оплате (callback). Уведомление может потеряться или прийти повторно, поэтому нужны фоновый опрос статусов и защита от двойного проведения по orderId. Банк России не планирует прямую интеграцию платформы с 1С: учёт получает оплаты от вашего обработчика или из выписки банка.

Как устроена интеграция цифрового рубля

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

СайтПриложениеКасса и КСОРесторанная касса

заказ: orderId, сумма, тип QR

API банкаВозвращает универсальный QR. На телефоне покупатель открывает ссылку кода, на кассе сканирует его.

покупатель подтверждает оплату в приложении своего банка

Платформа цифрового рубля, Банк РоссииДеньги приходят на счёт цифрового рубля продавца в реальном времени.

статус оплаты двумя путями

CallbackБанк сам присылает статус. Может потеряться или прийти повторно.

Фоновый опросВаша система сама спрашивает банк о незакрытых заказах.

проверка orderId: повтор не проводится

1СПоступление, закрытый заказ, возврат, сверка с выпиской.С платформой напрямую не связана

Callback: уведомление, которое банк сам отправляет на адрес вашей системы, когда статус оплаты изменился.

Идемпотентность по orderId: правило обработчика, при котором повторное уведомление по тому же заказу не создаёт второе поступление.

Почему 1С стоит в конце цепочки: Банк России не планирует прямую интеграцию платформы с бухгалтерскими системами вроде 1С (вопрос 31). Через 1С:ДиректБанк автоматической связки тоже нет (Infostart), но обмен файлами в 1С:Бухгалтерии есть: выписку можно загрузить из XML с релиза 3.0.164, распоряжения выгрузить с релиза 3.0.191 (Infostart).

3.0.205Бухгалтерия предприятия ПРОФ и КОРП, 27 августа 2026
11.5.27.81Управление торговлей 11, 30 августа 2026
2.5.27.81ERP 2.5, 30 августа 2026
3.0.14.143Розница 3.0, 5 сентября 2026
2.3.26.22Розница 2.3, 7 сентября 2026

Релизы и статусы по данным 1С на 15.11.2026. Какой релиз нужен вашей конфигурации и что в нём есть из коробки, разобрали на странице «Цифровой рубль в 1С».

Сборка интеграции: план по неделям для ваших систем

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

Сборка интеграцииСроки ваши: стартовая сетка по 5 рабочих дней, это не оценка

Сценарий

Доступ: договор, ключи и тестовый контур банкаФиндиректор, БанкДоговор счёта с Банком России через интернет-банк, ключи подписи выдаёт банк
5 дн.
Заказ и универсальный QR через API банкаБэкенд, Мобильный разработчик, 1С-программистorderId, сумма, тип QR
5 дн.
Расширение 1С:УТ: вид оплаты, статусы, документы1С-программист
5 дн.
Callback и фоновый опрос статусовБэкенд, 1С-программист
5 дн.
Идемпотентность по orderIdБэкенд, 1С-программистПовтор по тому же заказу не проводится
5 дн.
ВозвратыБэкенд, 1С-программист, Бухгалтер
5 дн.
Сверка с выпиской банкаБухгалтер, 1С-программист
5 дн.
Тесты на контуре: потерянный и повторный callback, возвратТестировщик, Вся команда
5 дн.

Для сравнения: пример Infostart, 1С:УТ и API Сбера

Тестовый контур от СбераЖдали 8 рабочих дней
8 дн.
Весь проект у автораОколо 17 дней работ по таблице, из них 7 на расширение УТ
≈ 3 нед.

Шкала в рабочих неделях по 5 дней, белым отмечена цепочка, которая держит срок. Пример сверху: пересказ таблицы автора, один случай, не норма: Infostart, 10.09.2026.

Ваш план

20 рабочих дней, около 4 недель

Срок держит цепочка: Заказ и универсальный QR через API банка → Callback и фоновый опрос статусов → Возвраты → Тесты на контуре. Сократить план можно только на ней: остальные задачи идут параллельно.

Все задачи таблицей: когда нужна, кто делает, после чего

Задача	Когда нужна	Кто делает	Начинается после
Доступ: договор, ключи, тестовый контур	Всегда	Финдиректор, банк	Ни от чего, первым делом
Заказ и универсальный QR через API банка	Сайт, приложение, учёт в 1С	Бэкенд, мобильный разработчик, 1С-программист	Можно начать по документации банка
QR на экране кассы, КСО или ресторанной кассы	Касса, КСО, ресторан	Поставщик кассового ПО, банк	Можно начать сразу
Расширение 1С: вид оплаты, статусы, документы	УТ, Розница, ERP	1С-программист	Можно начать сразу
Callback и фоновый опрос статусов	Всегда	Бэкенд или 1С-программист	Заказ и QR
Идемпотентность по orderId	Всегда	Бэкенд или 1С-программист	Заказ и QR
Возвраты	Всегда	Разработчик и бухгалтер	Callback и опрос
Сверка с выпиской банка	Всегда	Бухгалтер, 1С-программист	Callback и опрос, расширение 1С
Тесты на контуре	Всегда	Тестировщик и вся команда	Все задачи, включая доступ к контуру

Как считается план

Задача начинается, когда закончились все задачи, от которых она зависит. Срок плана: конец последней задачи, тестов.

Недели = рабочие дни ÷ 5, с округлением вверх. Доступ к тестовому контуру идёт параллельно разработке, но тесты ждут его.

Пример Infostart: что в нём на самом деле

Автор дорабатывал 1С:УТ под цифровой рубль через API Сбера. По его таблице трудоёмкости около 17 дней работ, из них 7 на расширение УТ; по календарю около трёх недель, чистой разработки из них половина.

Тестовый контур Сбер дал через 8 рабочих дней. Это один случай, а не норма: Infostart, 10.09.2026.

Сценарий «интернет-магазин»: в каком порядке

Сразу и параллельно: финдиректор открывает доступ к счёту и тестовому контуру, бэкенд по документации банка делает заказ и QR, 1С-программист начинает расширение УТ.

Затем: callback, фоновый опрос и идемпотентность, после них возвраты и сверка. Последними тесты на контуре. Сколько недель на каждый шаг, решает ваша команда: поставьте сроки в схеме выше.

Цифровой рубль для разработчиков: пять технических ловушек

Верить одному callback
Как проявится Оплата прошла, а заказ висит неоплаченным. Или в 1С два поступления по одному заказу.
Что сделать Уведомление может потеряться или прийти повторно. Нужен фоновый опрос статусов незакрытых заказов и обработка повтора по orderId без второго проведения (Infostart).
Путать интервал опроса с таймаутом
Как проявится Цифру «30 секунд» из чужой статьи берут как время ожидания ответа банка.
Что сделать У автора Infostart 30 секунд это интервал, с которым регламентное задание опрашивает незакрытые оплаты. Таймауты берите из документации своего банка.
Один код способа оплаты на все банки
Как проявится Оплаты одного банка распознаются, другого падают в «прочие».
Что сделать В API банков значения разные: Сбер присылает NSPK_DIGITAL_RUB, Альфа-Банк присылает DIGITAL_RUB. Сведите их к своему перечислению в 1С: у автора Infostart это «Карта», «СБП», «ЦифровойРубль».
Не проверять тип QR в ответе банка
Как проявится Покупатель видит QR, но цифровым рублём заплатить не может.
Что сделать У автора Infostart первые две недели банк возвращал тип QR для СБП вместо универсального. Проверяйте тип QR в каждом тестовом заказе и пишите его в журнал после запуска.
Ждать готовый коннектор 1С к платформе
Как проявится Проект стоит: «подождём обновления 1С».
Что сделать Ждать нечего: Банк России не планирует прямую интеграцию платформы с 1С (вопрос 31). Релизы 1С дают вид оплаты, а статусы приходят через API банка или выпиской.

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

Тестовый сценарий перед запуском

Автор Infostart отдельно проверял потерянный и повторный callback по одному orderId (Infostart). Без этих семи шагов на тестовом контуре банка мы бы не запускали.

1
Заказ на тестовом контуреРазработчик
Создайте заказ через API банка: в ответе тип QR универсальный, сумма и orderId совпадают с вашими.
2
Оплата из тестового приложенияРазработчик, 1С-программист
Callback пришёл, заказ стал оплаченным, в 1С поступление с видом оплаты «цифровой рубль».
3
Потерянный callbackРазработчик
Заблокируйте уведомление: фоновый опрос сам находит оплату и закрывает заказ.
4
Повторный callbackРазработчик, 1С-программист
Отправьте уведомление по тому же orderId второй раз: второго поступления нет, в журнале запись о повторе.
5
ВозвратРазработчик, бухгалтер
Полный и, если API банка позволяет, частичный: деньги уходят со счёта цифрового рубля, в 1С документ возврата со ссылкой на заказ.
6
Сверка тестового дняБухгалтер
Выписка банка и документы 1С сходятся строка в строку.
7
Пилот на одной точке или части заказовИТ-директор
Первые дни сверяйте каждое утро; на все каналы раскатывайте, когда расхождений нет.

К каким датам собрать интеграцию:

15 ноября 2026СейчасДо 31 декабря 2026 года операции бизнеса без комиссии: удобно тестировать на живых оплатах.
1 января 2027Комиссия за приём0,3%, не больше 1 500 ₽ за перевод, платит получатель. В сверке появляется строка комиссии.
1 сентября 2027Вторая волнаВыручка больше 30 млн ₽ и на 1 января 2026 клиент значимого банка или банка с универсальной лицензией.
1 сентября 2028Третья волнаОстальные продавцы с выручкой больше 20 млн ₽.

Источники дат: решение совета директоров Банка России, Банк России.

Кто нужен в команде и как быть с iiko

Кто	Что делает	Когда нужен
ИТ-директор или руководитель проекта	План, банк, приоритеты, приёмка	Всегда
Финдиректор	Счёт цифрового рубля, договор с Банком России через интернет-банк, ключи подписи	Всегда, до разработки
Бэкенд-разработчик	Заказ и QR через API банка, callback, фоновый опрос, идемпотентность	Сайт и приложение
Мобильный разработчик	Экран оплаты: на телефоне покупатель не сканирует QR, а открывает ссылку кода	Приложение
1С-программист	Расширение УТ, Розницы или ERP: вид оплаты, статусы, поступления, возвраты	Учёт в 1С
Поставщик кассового ПО	Универсальный QR на экране кассы, КСО или ресторанной кассы	Касса, КСО, ресторан
Бухгалтер	Правила возвратов, сверка с выпиской, строка комиссии с 2027 года	Всегда
Тестировщик	Семь шагов тестового сценария	Перед запуском

Цифровой рубль и iiko: публичных материалов iiko о поддержке цифрового рубля мы на 15.11.2026 не нашли. Уточните у поставщика кассового ПО и у банка, как вывести универсальный QR на экран гостя. Такой сценарий уже пробовали: в пилоте Газпромбанка в Теремке универсальный QR банка выводился на экран кассы для покупателя (материал самого банка, 18.09.2025).

Свяжем сайт, приложение и 1С с API банка: с опросом статусов, защитой от дублей и сверкой. Оплата на сайте →

Частые вопросы

Есть ли готовая интеграция платформы цифрового рубля с 1С?

Нет. Банк России прямую интеграцию платформы с 1С не планирует, а через 1С:ДиректБанк автоматической связки нет. 1С работает через API банка, а выписку в 1С:Бухгалтерию можно загрузить из файла XML с релиза 3.0.164.

Что нужно разработчику для приёма цифрового рубля?

Доступ к API и тестовому контуру банка-участника платформы. Дальше: заказ с orderId и универсальным QR, приём callback, фоновый опрос статусов и обработка повторов по orderId без второго проведения.

Почему одного callback недостаточно?

Уведомление банка может потеряться или прийти повторно. Поэтому статус незакрытых заказов ещё проверяют фоновым опросом, а повтор по тому же orderId не должен создавать второе поступление.

Сколько времени занимает интеграция цифрового рубля?

Зависит от числа систем и от банка. В случае, описанном на Infostart 10.09.2026, по таблице автора около 17 дней работ, из них 7 на расширение 1С:УТ, по календарю около трёх недель; тестовый контур Сбер дал через восемь рабочих дней.

Поддерживает ли iiko цифровой рубль?

Публичных материалов iiko о цифровом рубле мы на 15.11.2026 не нашли. Уточните у поставщика кассового ПО и у банка, как вывести универсальный QR на экран гостя: так работал пилот Газпромбанка в Теремке в 2025 году.

Как часто опрашивать статус оплаты у банка?

Интервал выбирают сами. У автора Infostart регламентное задание опрашивало незакрытые оплаты каждые 30 секунд: это интервал опроса, а не время, которое банк ждёт ответа.

Источники

Соберём интеграцию цифрового рубля

Сайт, приложение, касса и 1С через API банка, с опросом статусов и сверкой. Ответим за 15 минут.