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

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

1 Описание
2 Примеры работы
- 2.1 Клавиатурная касса
  - 2.1.1 Динамический QR
  - 2.1.2 Статический QR
- 2.2 SetTouch
  - 2.2.1 Динамический QR
  - 2.2.2 Статический QR
3 Настройка
- 3.1 На сервере
  - 3.1.1 Настройка кнопки быстрой оплаты
- 3.2 Настройка статического QR-кода
4 Экспорт в ERP
- 4.1 Экспорт чека продажи
5 Статьи по теме

Описание

Плагин оплаты QR-кодом от Яндекс Пэй предоставляет возможность гибко управлять режимом работы СБП (статический или динамический QR) на уровне шаблонов касс и типов оплат. Например, на кассах самообслуживания можно использовать динамический QR, а на Touch кассах - статический (при отсутствии дисплея покупателя).

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

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

Динамический QR

Кассир добавляет товары в чек, переходит к расчету и выбирает способ оплаты QR-код от Яндекс Пэй (Динамический QR).

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

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

Касса выводит сообщение кассиру: Оплата с помощью сервиса “Яндекс Пэй и Сплит“. Попросите покупателя отсканировать QR-код для оплаты.

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

Статический QR

Кассир добавляет товары в чек и выбирает тип оплаты QR-код от Яндекс Пэй (Статический QR).

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

Касса выводит сообщение кассиру: Оплата с помощью сервиса “Яндекс Пэй и Сплит“. Попросите покупателя отсканировать QR-код для оплаты.

Покупатель сканирует QR-код с таблички/наклейки, размещенной в кассовой зоне.
Покупатель подтверждает оплату в приложении.
Касса регистрирует чек.

SetTouch

Динамический QR

1. Кассир добавляет товары в чек и выбирает способ оплаты QR-код от Яндекс Пэй (Динамический QR).

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

На дисплее покупателя отображается QR-код. При отсутствии дисплея покупателя QR-код печатается на чековой ленте.

Касса выводит сообщение кассиру: Оплата с помощью сервиса “Яндекс Пэй и Сплит“. Попросите покупателя отсканировать QR-код для оплаты.

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

Статический QR

Кассир добавляет товары в чек и выбирает тип оплаты QR-код от Яндекс Пэй (Статический QR).

Кассир подтверждает сумму оплаты нажатием кнопки ОПЛАТИТЬ.

Касса выводит сообщение: Оплата с помощью сервиса “Яндекс Пэй и Сплит“. Попросите покупателя отсканировать QR-код для оплаты.

Покупатель сканирует QR-код с таблички/наклейки, размещенной в кассовой зоне.
Покупатель подтверждает оплату в приложении.
Касса регистрирует чек.

Настройка

На сервере

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

Кликните Платежные системы → введите в правую секцию поиска яндекс → установите флажок QR-код от Яндекс Пэй → кликните СОХРАНИТЬ.

Кликните по процессингу QR-код от Яндекс Пэй.

4. Введите необходимые настройки на вкладке ОБЩИЕ.

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

Параметр

Описание

Адрес подключения *

Вводится веб-адрес сервиса.

Пример: https://pay.yandex.ru/api/merchant

API-ключ *

Ключ авторизации в сервисе.

Задайте требуемые настройки на вкладках QR-КОД ОТ ЯНДЕКС ПЭЙ (ДИНАМИЧЕСКИЙ QR) и QR-КОД ОТ ЯНДЕКС ПЭЙ (СТАТИЧЕСКИЙ QR) → кликните СОХРАНИТЬ.

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

Параметр	Описание
Время жизни заказа (в секундах)	Время, за которое покупатель должен успеть подтвердить оплату. При превышении указанного времени процесс оплаты потребуется запустить заново. Минимально допустимое значение 180 секунд, максимальное - 604800
Передавать общий код при наличии одинаковых товаров	При наличии одинаковых товаров в чеке в процессинг передается общий код. Настройка должна быть включена, иначе не продать, если в чеке например две весовые позиции с одинаковым кодом товара.
ID товара *	Идентификатор/артикул товара, который будет передаваться в запросе на оплату вместо всех позиций чека. Стоимость товара будет равна сумме чека. Максимальное количество символов - 2048.
Наименование товара *	Универсальное наименование товара, используемого для передачи в запросе на оплату. Максимальное количество символов - 2048.
Таймаут соединения (сек., по умолчанию: 3)	Время соединения с сервисом при попытке оплаты.
Таймаут ожидания ответа (сек., по умолчанию: 10)	Время ожидания ответа от сервиса после инициализации оплаты.
Количество попыток для запроса (по умолчанию: 5)	Количество попыток отправки запросов на создание платежа.
Разрешить смешанную оплату	Включает возможность смешанной оплаты и частичного возврата с помощью QR-кода от Яндекс Пэй. По умолчанию настройка выключена, смешанная оплата запрещена.
требует пропорциональный возврат	При возврате позиций чека, оплаченного смешанной оплатой, типы оплат будут пропорционально распределены между возвращаемыми позициями.
частичный возврат чека запрещен	Разрешен только возврат чека полностью.
возврат по чеку доступен всегда	Функциональность не поддерживается в данной версии плагина.
допускать запрет других типов оплат	Функциональность не поддерживается в данной версии плагина.
использовать одну оплату для разделенных чеков	Функциональность не поддерживается в данной версии плагина.
признак автоматического применения оплаты для физ.лиц (оплата будет скрыта)	Функциональность не поддерживается в данной версии плагина.
признак автоматического применения оплаты для юр.лиц (оплата будет скрыта)	Функциональность не поддерживается в данной версии плагина.
разрешить использовать оплату для выдачи наличных	Функциональность не поддерживается в данной версии плагина.
код оплаты для передачи в систему событий	Код оплаты для передачи в систему событий: `yandex.pay.dynamic.payment.plugin` - динамический `yandex.pay.static.payment.plugin` - статический
возвращать дополнительными способами вместо плагина	При оформлении возврата чека, оплаченного с помощью плагина QR-код от Яндекс Пэй, денежные средства могут быть возращены только выбранными типами оплат из списка. Возврат по QR-коду от Яндекс Пэй недоступен.
Дополнительные способы возврата, доступные всегда Если включена "возвращать дополнительными способами вместо плагина", то этот список используется вместо плагина. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы.	Список типов оплат, всегда используемых для выполнения возврата в дополнение к QR-коду от Яндекс Пэй.
Способы возврата, дополнительно доступные по решению плагина Если включена "возвращать дополнительными способами вместо плагина", то этот список не применяется. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы.	Список типов оплат, используемых для выполнения возврата при невозможности завершить возврат плагинным типом оплаты. Функциональность не поддерживается в данной версии плагина.

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

Перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → в секции Типы оплат установите флажок QR-код от Яндекс Пэй (Динамический QR) и/или QR-код от Яндекс Пэй (Статический QR) → кликните СОХРАНИТЬ → перезагрузите кассовый модуль.

Настройка кнопки быстрой оплаты

Для настройки кнопки быстрой оплаты на кассе SetTouch подключитесь к базе данных set на сервере SetRetail/SetCentrum с помощью PgAdmin или SetConsole.

Вставьте соответствующий тип оплаты для кассы SetTouch в соответствии с логикой ранжирования типов оплат (скрипт для выполнения можно взять из статьи по ранжированию).

Пример для статического QR:

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

Статический

{ "paymentId" : "yandex.pay.static.payment.plugin", "fastAccessRank" : 5, "rank" : 5}

Динамический

{ "paymentId" : "yandex.pay.dynamic.payment.plugin", "fastAccessRank" : 5, "rank" : 5}

Настройка статического QR-кода

Для возможности использования способа оплаты с помощью статического QR-кода произведите в базе данных кассы catalog настройку, которая добавляет плагинное свойство в модуле yandex.pay.sbp.service с ключом static.qrc.id и значением в виде идентификатора статического QR-кода для оплаты. Идентификатор QR-кода предоставляется сервисом "Яндекс Пэй" и является уникальным для каждой кассы.

1. Скачайте нужный скрипт:

– добавляет свойство;
– обновляет уже существующее.

2. Замените значение параметра property_value на актуальный идентификатор статического QR-кода.

3. Выполните скрипт в БД кассы catalog.

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

Экспорт в ERP

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

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

<purchase ...>

<payments>
- typeClass - тип плагинной оплаты:
  - yandex.pay.static.payment.plugin - QR-код от Яндекс Пэй (Статический QR)
  - yandex.pay.dynamic.payment.plugin. - QR-код от Яндекс Пэй (Динамический QR)
- plugin-property - плагинные свойства оплаты:
  - cash.transaction.date - дата и время транзакции.
  - payment.amount - сумма оплаты.
  - cash.operation.id - номер заявки, 32 символа.
  - terminal.id - идентификатор терминала. Состоит из следующих данных:
    - префикс (латинская Y);
    - номер магазина (4 знака по умолчанию, для магазинов с пятизначным номером передается 5 знаков);
    - номер кассы (3 знака);
    - если знаков меньше, добавляются нули перед значениями и магазин (до 4 знаков) и касса (до 3 знаков).
  - payment.method.type - тип платёжного метода. Возможные значения:
    - CARD - карта;
    - SPLIT- Сплит;
    - SBP - СБП;
    - SPLIT_SBP - Сплит, платежи по которому будут списываться по СБП;
    - UNIQR_REUSABLE - статический Универсальный Платёжный QR-код (УПК);
    - UNIQR_ONETIME - динамический Универсальный Платёжный QR-код (УПК).
</payments>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="99999" userName="Иванов Иван Иванович" operationType="true" cashOperation="INCOME" operDay="2026-03-01+03:00" shop="9198" cash="62" shift="27" number="3" saletime="2024-03-01T17:16:23.249+03:00" begintime="2024-03-01T17:13:28.959+03:00" amount="16.20" discountAmount="1.80" inn="1234567890" fiscalDocNum="57;3">
        ...
        <payments>
          <payment order="0" typeClass="yandex.pay.static.payment.plugin" amount="16.20" description="QR-код от Яндекс Пэй (Статический QR) "/>
            <plugin-property key="payment.method.type" value="SBP"/>                
            <plugin-property key="cash.transaction.date" value="2026-03-01T13:14:24.606000Z"/>                
            <plugin-property key="payment.amount" value="51.08"/>                
            <plugin-property key="cash.operation.id" value="E3EEBC55E70346F9AB876EE241B73F40"/>
            <plugin-property key="terminal.id" value="Y9198062"/>
        </payments>
    </purchase>
</purchases>

SetRetail10 ◾️ Сервис оплаты QR-код от Яндекс Пэй

Описание

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

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

Динамический QR

Статический QR

SetTouch

Динамический QR

Статический QR

Настройка

На сервере

Настройка кнопки быстрой оплаты

Настройка статического QR-кода

Экспорт в ERP

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

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