/
Оплата QR-кодом: Сбербанк V3 (СБП)

Публичное пространство

Оплата QR-кодом: Сбербанк V3 (СБП)

https://crystals.atlassian.net/browse/SRTZ-4291

https://crystals.atlassian.net/browse/CR-14168

10.4.21.0

Описание

В версии 10.4.21.0 реализована оплата через СБП Сбер по новому API-протоколу с использованием кассовой ссылки. Оплата проводится по статичному QR-коду через мобильные приложения банков-партнёров.

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

Ценность

Для бизнеса (ритейлеров):

  • Снижение комиссии за безналичные платежи.

  • Повышение лояльности постоянных клиентов.

  • Реализация дополнительного, современного способа оплаты для покупателей.

  • Поддержание здоровой конкуренции между поставщиками платёжных услуг.

Для покупателей:

  • Ускорение процесса оплаты с помощью сканирования QR-кода (QRC).

  • Появление дополнительного удобного способа расчёта.

Для банка-партнёра:

  • Получение комиссии от совершаемых платежей.

  • Повышение лояльности и вовлечённости клиентов.

Примеры работы

Клавиатурная касса

  1. Кассир добавляет товары в чек и переходит к расчету.

172.29.17.126_11_11_2025-14_22_35.png

  1. Кассир выбирает тип оплаты Оплата по QR-коду, Сбербанк СБП V3.

172.29.17.126_11_11_2025-14_22_59.png

  1. Кассир подтверждает сумму оплаты клавишей ВВОД.

172.29.17.126_11_11_2025-14_23_12.png

  1. Касса отображает сообщение о том, что покупателю необходимо отсканировать QR-код.

172.29.17.126_11_11_2025-15_40_05.png

  1. Покупатель сканирует QR-код и подтверждает оплату в приложении банка;

  2. Касса регистрирует чек.

SetTouch

  1. Кассир добавляет товары в чек и выбирает тип оплаты Оплата по QR-коду, Сбербанк СБП V3.

image-20251112-154409.png

  1. Кассир нажимает ОПЛАТИТЬ.

image-20251112-154446.png

  1. Касса отображает сообщение о том, что покупателю необходимо отсканировать QR-код.

chrome_69AADPWqMU.png

  1. Покупатель сканирует QR-код и подтверждает оплату в приложении банка.

  2. Касса регистрирует чек.

SetSCO v3

  1. Покупатель добавляет товары в чек и нажимает Перейти к оплате.

image-20251112-154953.png

  1. Покупатель выбирает тип оплаты QR-кодом.

image-20251112-155053.png

  1. На экране отображается информационный баннер с текстом Для оплаты используйте NFC или отсканируйте QR-код на кассе.

image-20250422-102956.png

  1. Покупатель сканирует QRC в приложении и подтверждает оплату.

  2. Касса регистрирует чек.

Ограничения

  • Процесс перепривязки кассовой ссылки на другую кассу (изменение привязки для qrcId) является нефункциональной операцией и не может быть инициирован через API. Для его выполнения требуется обращение в службу сопровождения Банка для выполнения сотрудником Банка административной процедуры "отвязки" существующей записи.

  • Не поддерживается произвольный возврат.

Настройка

Сервер

Настройка процессинга

  1. На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → кликните .

image-20251111-193542.png

  1. Введите в строке поиска сбер → кликните Сервисы оплаты по QR-коду → в правом поле поиска введите сбер → установите флажок Сбер V3 (СБП) → кликните .

image-20251111-193820.png

 

  1. Кликните по процессингу Сбер V3 (СБП).

image-20251111-193918.png

 

  1. Выберите магазин или установите флажок Для всей сети → введите необходимые настройки → кликните .

Данные предоставляются банком.

Параметр

Описание

Параметр

Описание

Логин клиента (UserName)

Логин клиента для подключения к процессингу

Пароль Клиента (Password)

Пароль для подключения к процессингу

Партнерский идентификатор (merchantId)

Уникальный идентификатор партнёра

Описание (Description)

Описание. Текстовое поле, например:
”Оплата СБП”

Если указано, то содержание отображается клиенту-физическому лицу в приложении СберБанкОнЛайн (а также в приложениях других банков) в поле «назначение платежа»

Время жизни заказа (мин.)

Период, в течение которого заказ доступен для оплаты, в минутах

  • Минимальное значение - 1

  • Максимальное - 20

Таймаут соединения (сек.)

Время соединения с сервисом при попытке оплаты.

Таймаут ожидания ответа (сек.)

Время ожидания ответа от сервиса после инициализации оплаты.

Количество попыток для запроса

Количество попыток для запроса

image-20251111-194128.png

 

Назначение типа оплаты

  1. Перейдите в Кассовый модуль → Шаблоны касс → кликните требуемый шаблон.

image-20251112-093510.png

  1. Перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → в секции Типы оплат установите флажок Оплата по QR-коду → кликните .

image-20251112-093802.png

 

Добавление банка

  1. Перейдите в раздел Кассовый модуль → кликните Банки → кликните .

image-20251112-094145.png

  1. Введите в поле Название наименование отображаемого банка на кассе с пометкой СБП → выберите из поля со списком процессинг Сбербанк (СБП) ECOM V3 → нажмите .

image-20251112-094257.png

 

Назначение функциональных клавиш и пунктов меню клавиатурной кассы

Для клавиатурной кассы можно назначить быстрый доступ к типу оплат по QR-коду.

Клавиша прикассовой клавиатуры

  1. Перейдите в раздел Кассовый модуль → кликните Кассовое оборудование → нажмите кнопку редактирования шаблона клавиатуры.

image-20250826-234210.png

  1. Назначьте тип оплаты Оплата по QR-коду → в наименовании банка выберите Сбербанк СБП V3 → нажмите Сохранить.

image-20251112-102240.png

 

Кассовое меню

  1. Перейдите в Кассовый модуль → кликните Шаблоны касс → откройте на редактирование шаблон, для которого требуется назначить оплату QR-кодом.

image-20251112-093540.png

  1. Перейдите на вкладку ИНТЕРФЕЙС → нажмите .

image-20251112-103302.png

  1. Назначьте тип оплаты Оплата по QR-коду → в наименовании банка выберите Сбербанк СБП V3 → введите название кнопки → нажмите Применить.

image-20251112-103503.png

 

Касса

Настройка подключения к процессингу

Клавиатурная касса

  1. Переключитесь на экран визуализации кассового модуля. 

  2. Перейдите в кассовое меню → выберите Конфигуратор.

172.29.17.126_11_11_2025-14_19_04.png

  1. Выберите Банки.

172.29.17.126_11_11_2025-14_19_17.png

  1. Выберите Сбербанк СБП V3.

172.29.17.126_11_11_2025-14_19_40.png

  1. Нажмите Задействовать.

172.29.17.126_11_11_2025-14_19_51.png

  1. Нажмите ОТМЕНА → Перезагрузите кассовый модуль.

172.29.17.126_11_11_2025-14_20_25.png

 

SetTouch

  1. В боковом меню выберите Настройки.

image-20251112-104907.png

  1. Нажмите Банки.

image-20251112-104951.png

  1. Выберите Сбербанк (СБП) ECOM V3.

image-20251112-105019.png

  1. Включите использование процессинга → вернитесь на предыдущий экран.

image-20251112-105207.png

  1. Перезагрузите кассовый модуль.

image-20251112-105231.png

 

SetSCO v3

  1. В режиме консультанта нажмите Меню консультанта.

image-20251112-110313.png

  1. Перейдите на вкладку Сервис → выберите Конфигуратор.

image-20251112-110327.png

  1. Нажмите Настройки SCO.

image-20251112-110340.png

  1. Выберите Оборудование POS.

image-20251112-111345.png

  1. Установите флажок Сбербанк СБП V3 → нажмите Сохранить.

image-20251112-111356.png

  1. Перезагрузите кассовый модуль.

image-20251112-111410.png

 

Регистрация кассовой ссылки из меню на кассе

Для роли кассового пользователя установите привилегию Меню сервисных банковских операций → кликните → кликните .

Для клавиатурной кассы задайте пункт меню Банковские операции. В шаблоне по умолчанию данный пункт находится в меню Администратор.

Клавиатурная касса

  1. На клавиатурной кассе выберите пункт меню Банковские операции.

172.29.17.126_11_11_2025-14_25_47.png

  1. Выберите пункт меню Сбербанк СБП V3.

172.29.17.126_11_11_2025-14_26_08.png

  1. Выберите пункт Настройка кассовой ссылки.

172.29.17.126_11_11_2025-14_27_12.png

  1. В случае, если кассовая ссылка уже была настроена, касса предупреждает о том, что ссылка будет перезаписана. Нажмите Перенастроить.

172.29.17.126_11_11_2025-15_17_40.png

  1. Отсканируйте QR-код кассовой ссылки.

172.29.17.126_11_11_2025-14_27_35.png

  1. Касса отображает сообщение об успешной настройке кассовой ссылки.

172.29.17.126_11_11_2025-14_58_09.png

Кассовая ссылка сохраняется в БД catalog таблице sales_management_properties в поле с ключом property_key = 'cashLinkId'.

image-20251112-191332.png

 

SetTouch

  1. В боковом меню перейдите в раздел Смены.

image-20251113-065356.png

  1. Нажмите  → выберите пункт меню Настройка кассовой ссылки.

image-20251113-065321.png

  1. Выберите Сбербанк СБП V3 → нажмите Выбрать.

chrome_iKu9cpCKgP.png

  1. В случае, если кассовая ссылка уже была настроена, касса предупреждает о том, что ссылка будет перезаписана. Нажмите Перенастроить.

chrome_mAaAFAJGqJ.png

  1. Отсканируйте QR-код кассовой ссылки.

chrome_ATkUUux2br.png

  1. Касса отображает сообщение об успешной настройке кассовой ссылки.

chrome_CZMfRskhH3.png

 

SetSCO v3

На кассе самообслуживания настройка кассовой ссылки выполняется по инструкции из статьи https://crystals.atlassian.net/wiki/x/IQByLAE .

image_2025-11-11_13-35-36 (2)-20251111-103550.png

 

Экспорт в ERP

Экспорт в ERP-системы осуществляется в соответствии с интеграционной документацией:

Экспорт чека продажи

<purchase ...> 

  • <payments>

    • typeClass="BankQRPaymentEntity" - оплата по QR-коду.

      • Плагинные свойства оплаты:

        • qr.type - тип QRC: динамический или кассовая ссылка;

        • qrc.id - идентификатор QR-кода по которому была совершена оплата;

        • cash.transaction.id - идентификатор операции платежа;

        • code - код операции платежа. Для оплат с типом BankQRPaymentEntity значение sbp.

        • bank.id - название банка/процессинга;

        • ref.number - RRN (Reference Retrieval Number) номер транзакции оплаты;

        • merchant.id - уникальный идентификатор партнёра, выданный СБП или Сбербанком;

        • subclass - подтип оплаты;

        • order.id - уникальный идентификатор заказа в системе партнёра;

        • operation.id - идентификатор операции;

        • auth.id - код авторизации;

        • terminal.id - номер терминала, через который выполнена оплата СБП Сбер.

        • nspk.operation.id - идентификатор операции НСПК. Для СБП - Идентификатор Операции ОПКЦ СБП. Выгружается как для чеков продажи ("operationType": "PAY"), так и для чеков возврата ("operationType": "REFUND")

  • </payments>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="111" userName="Админ a дмин" operationType="true" operDay="2026-02-18+03:00" shop="8186" cash="62" shift="2" number="1" saletime="2026-02-18T12:30:43.857+03:00" begintime="2026-02-17T16:30:21.696+03:00" amount="10.00" discountAmount="0.00" inn="7802781104"> <plugin-property key="externalSystemId" value="81860621771406950949"/> <plugin-property key="PROMO_PRINT_DISABLED" value="true"/> <plugin-property key="FN_DOC_NUM_IN_SHIFT" value="1"/> <plugin-property key="FISCAL_DOC_ID" value="8"/> <plugin-property key="CASHIER_NAME" value="Админ a дмин"/> <plugin-property key="UID_PURCHASE" value="81e4e038-256a-43fc-9b31-12fcb8ef70b6"/> <plugin-property key="KPP" value="780201001"/> <plugin-property key="CASH_TIME_ZONE" value="+03:00"/> <positions> <position order="1" departNumber="1" goodsCode="01734" barCode="7201734000004" count="1.000" cost="10.00" nds="20.0" ndsSum="1.67" discountValue="0.00" costWithDiscount="10.00" amount="10.00" dateCommit="2026-02-17T16:30:21.730+03:00"> <plugin-property key="beforeManualPrice" value="188.04"/> <plugin-property key="catalogStatistic" value="{&#10; &quot;@type&quot; : &quot;ru.crystals.catalog.CatalogStatistic&quot;,&#10; &quot;fullTimeCustomerMs&quot; : 2961&#10;}"/> <plugin-property key="countryName" value="Израиль"/> <plugin-property key="ffdTag2108"/> <plugin-property key="salesTax" value="0"/> <plugin-property key="minimalPrice" value="-1"/> </position> </positions> <payments> <payment order="0" typeClass="BankQRPaymentEntity" amount="10.00" description="Оплата по QR-коду"> <plugin-property key="qrc.id" value="AS1F002VSD9JPQ6T832B62TC4AFGJEFU"/> <plugin-property key="qr.type" value="QR_CASH_LINK"/> <plugin-property key="cash.transaction.id" value="110005"/> <plugin-property key="code" value="sbp"/> <plugin-property key="bank.id" value="Сбер V3 (СБП)"/> <plugin-property key="ref.number" value="604900016205"/> <plugin-property key="auth.code" value="801670"/> <plugin-property key="operation.id" value="019c701661d771e09331aa17356da0cf"/> <plugin-property key="order.id" value="019c7015-3589-7905-b15f-080bda9c9cc5"/> <plugin-property key="terminal.id" value="20653012"/> <plugin-property key="cash.transaction.date" value="2026-02-18 12:30:40.983"/> <plugin-property key="subclass" value="Сбер V3 (СБП)"/> <plugin-property key="merchant.id" value="101000075796"/> <plugin-property key="nspk.operation.id" value="B6050093038936010B10120011700501"/> </payment> </payments> </purchase> </purchases>

Статьи по теме