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

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

1 Описание
2 Ценность
3 Примеры работы
- 3.1 Клавиатурная касса
- 3.2 SetTouch
- 3.3 SetSCO v3
4 Ограничения
5 Настройка
- 5.1 Сервер
- 5.2 Касса
  - 5.2.1 Настройка партнерского идентификатора (merchantLogin)
  - 5.2.2 Настройка подключения к процессингу
    - 5.2.2.1 Клавиатурная касса
    - 5.2.2.2 SetTouch
    - 5.2.2.3 SetSCO v3
6 Экспорт в ERP
- 6.1 Экспорт чека продажи
7 Статьи по теме

Описание

Возможность подключить на кассе оплату через СБП Сбербанк по новому API-протоколу.

Ценность

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

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

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

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

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

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

Касса выводит QR-код на дисплее покупателя при наличии или печатает на чековой ленте.

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

SetTouch

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

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

Касса выводит QR-код на дисплее покупателя.

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

SetSCO v3

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

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

Касса выводит QR-код для оплаты на дисплей.

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

Ограничения

Не поддерживается произвольный возврат.
Параметр terminalId не используется для идентификации терминала оплаты СБП, вместо него используется merchantLogin.
Идентификатор транзакции trx.id в текущей версии (10.4.18.0) передается только в ответе на запрос статуса при успешной продаже. В данной реализации предусмотрена автоматическая запись значения trx.id в чек возврата, если данный атрибут будет передаваться со стороны Сбера.
Функционал статической кассовой ссылки не поддерживается в данный момент.

Настройка

Сервер

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

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

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

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

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

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

Параметр	Описание

Параметр	Описание
Логин клиента (UserName)	Логин клиента для подключения к процессингу
Пароль Клиента (Password)	Пароль для подключения к процессингу
Партнерский идентификатор (merchantLogin)	Уникальный идентификатор партнёра.
Использовать Партнерский идентификатор настроенный на кассе (useCashMerchantLogin)	При включении позволяет отражать операции каждой кассы на отдельном tid. Подробное описание настройки в главе Настройка партнерского идентификатора (merchantLogin) https://crystals.atlassian.net/browse/SRTZ-4323 https://crystals.atlassian.net/browse/CR-14802 10.4.22.010.4.21.110.4.20.7
Описание (Description)	Описание. Текстовое поле, например: ”Оплата СБП”

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

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

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

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

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

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

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

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

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

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

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

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

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

Перейдите на вкладку НАСТРОЙКА МЕНЮ → нажмите .

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

Касса

Настройка партнерского идентификатора (merchantLogin)

В настройках плагина установите флажок Использовать Партнерский идентификатор настроенный на кассе (useCashMerchantLogin) → кликните .

Откройте на редактирование файл /home/tc/storage/crystal-cash/config/plugins/bank-sberbank_sbp_ecom-config.xml.

Введите значение параметра <property key="merchantLogin" value="sbertest_1125_1"/> → сохраните файл → перезагрузите кассовый модуль.

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

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

Переключитесь на экран визуализации кассового модуля.
Перейдите в кассовое меню → выберите Конфигуратор.

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

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

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

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

SetTouch

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

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

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

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

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

SetSCO v3

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

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

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

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

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

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

Экспорт в ERP

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

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

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

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

<purchase ...>

<payments>
- typeClass="BankQRPaymentEntity" - оплата по QR-коду.
  - Плагинные свойства оплаты:
    - trx.id - уникальный Идентификатор Операции СБП;
    - qrc.id - идентификатор QR-кода по которому была совершена оплата;
    - qr.type - тип QRC: динамический или кассовая ссылка;
    - cash.transaction.id - идентификатор операции платежа;
    - code - код операции платежа. Для оплат с типом BankQRPaymentEntity значение sbp.
    - cash.transaction.date - дата и время выполнения транзакции;
    - bank.id - название банка/процессинга;
    - subclass - подтип оплаты;
    - merchant.id - уникальный идентификатор партнёра в разрезе ТК;
    - operation.id - идентификатор операции;
    - order.id - уникальный идентификатор заказа в системе партнёра;
    - terminal.number - номер терминала, через который выполнена оплата СБП Сбер.
</payments>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="111" userName="Админ a дмин" operationType="true" operDay="2025-07-08+03:00" shop="3115" cash="39" shift="2" number="2" saletime="2025-07-08T18:09:59.369+03:00" begintime="2025-07-08T17:22:18.127+03:00" amount="51.08" discountAmount="0.00" inn="7802781104">
        <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="12"/>
        <plugin-property key="CASHIER_NAME" value="Админ a дмин"/>
        <plugin-property key="UID_PURCHASE" value="08a60f0c-dad7-4b48-8548-d0978a74dc7f"/>
        <plugin-property key="KPP" value="780201001"/>
        <plugin-property key="CASH_TIME_ZONE" value="+03:00"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="00732" barCode="4600732000000" count="1.000" cost="32.04" nds="20.0" ndsSum="5.34" discountValue="0.00" costWithDiscount="32.04" amount="32.04" dateCommit="2025-07-08T17:22:18.144+03:00">
                <plugin-property key="countryName" value="Россия"/>
                <plugin-property key="ffdTag2108"/>
                <plugin-property key="salesTax" value="0"/>
                <plugin-property key="minimalPrice" value="-1"/>
            </position>
            <position order="2" departNumber="1" goodsCode="00731" barCode="4600731000001" count="1.000" cost="19.04" nds="20.0" ndsSum="3.17" discountValue="0.00" costWithDiscount="19.04" amount="19.04" dateCommit="2025-07-08T17:22:26.926+03:00">
                <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="51.08" description="Оплата по QR-коду">
                <plugin-property key="trx.id" value="B5189150955705010000120011560101"/>
                <plugin-property key="qrc.id" value="AD10007LO2EPRAUA88PA5PI4RQVF5OIN"/>
                <plugin-property key="qr.type" value="QR_DYNAMIC"/>
                <plugin-property key="cash.transaction.id" value="110010"/>
                <plugin-property key="code" value="sbp"/>
                <plugin-property key="cash.transaction.date" value="2025-07-08 18:09:58.521"/>
                <plugin-property key="bank.id" value="СберСБПЕСОМ"/>
                <plugin-property key="subclass" value="СберСБПЕСОМ"/>
                <plugin-property key="merchant.id" value="sbertest_1125"/>
                <plugin-property key="operation.id" value="e78a6af7-12a5-5df7-1f64-b5d5008b8207"/>
                <plugin-property key="order.id" value="55453110-de88-4d28-8401-d4213ae7ee2e"/>
                <plugin-property key="terminal.id" value="20288435"/>
            </payment>
        </payments>
    </purchase>
</purchases>

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

Описание

Ценность

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

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

SetTouch

SetSCO v3

Ограничения

Настройка

Сервер

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

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

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

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

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

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

Касса

Настройка партнерского идентификатора (merchantLogin)

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

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

SetTouch

SetSCO v3

Экспорт в ERP

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

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