Описание

Плагин Яндекс Пэй и Сплит предоставляет возможность оплаты чека по QR-коду через сервис "Яндекс Пэй".

Поддерживаются следующие способы оплаты:

Обратный QR – покупатель предъявляет QR-код из своего мобильного приложения для сканирования кассой.
- Доступен с версии 10.4.1.0
Динамический QR (прямой) – покупатель сканирует QR-код, отображаемый на дисплее покупателя или напечатанный на чековой ленте.
- Доступен с версии 10.4.14.0
Cтатический QR (прямой) – покупатель сканирует QR-код с таблички или наклейки на кассе.
- Доступен с версии 10.4.19.0

Выбор используемого типа QR-кода производится в настройках плагина.

Преимущества

Для Яндекс Пэй:
- комиссия от платежей;
- повышение лояльности клиентов;
Для ритейлеров:
- поддержание конкуренции по QR-оплатам между поставщиками услуг;
- снижение комиссии по безналичным платежам;
- повышение лояльности постоянных клиентов;
- реализация дополнительной возможности оплаты для покупателей;
Для покупателя:
- ускорение процесса оплаты посредством QR;
- дополнительная возможность оплаты.

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

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

Обратный QR

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

2. Кассир выбирает способ оплаты Яндекс Пэй и Сплит.

3. Касса запрашивает сканирование QR-кода покупателя.

4. Кассир сканирует QR-код с экрана покупателя.

5. Касса отображает сообщение “Выполняется запрос к процессингу”.

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

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

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

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

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

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

Дальнейший процесс оплаты аналогичен обратному QR.

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

1. Кассир добавляет товары в чек и выбирает тип оплаты Яндекс Сплит.

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

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

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

Дальнейший процесс оплаты аналогичен сценарию с обратным QR.

SetTouch

Обратный QR

1. Кассир добавляет товары в чек и нажимает кнопку быстрого выбора оплаты Яндекс Пэй и Сплит.

Или нажимает кнопку выбора типов оплат и выбирает Яндекс Пэй и Сплит.

2. Касса запрашивает сканирование QR-кода покупателя.

3. Кассир сканирует QR-код с экрана покупателя.

4. Касса отображает сообщение “Выполняется запрос к процессингу”.

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

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

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

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

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

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

Дальнейший процесс оплаты аналогичен обратному QR.

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

1. Кассир добавляет товары в чек и выбирает тип оплаты Яндекс Сплит.

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

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

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

Дальнейший процесс оплаты аналогичен сценарию с обратным QR.

CSI K

Обратный QR

1. Покупатель добавляет товары в чек и выбирает тип оплаты Яндекс Пэй и Сплит.

2. Касса запрашивает сканирование QR-кода для оплаты.

3. Покупатель сканирует QR-код из приложения.

4. Касса отображает сообщение о процессе оплаты.

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

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

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

1. Покупатель добавляет товары в чек и выбирает тип оплаты Яндекс Пэй и Сплит.

2. Касса отображает QR-код для оплаты. Покупатель сканирует QR-код.

Дальнейший процесс оплаты аналогичен обратному QR.

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

1. Покупатель добавляет товары в чек и выбирает тип оплаты Яндекс Сплит.

2. Покупатель подтверждает сумму к оплате, нажимая кнопку Продолжить.

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

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

Дальнейший процесс оплаты аналогичен сценарию с обратным QR.

Ограничения

Смешанная оплата запрещена (до версии SetRetail 10.4.16.0). Начиная с версии 10.4.16.0 доступна частичная оплата с помощью Яндекс Пэй и Сплит.
Возврат только для касс POS и SetTouch.
Произвольный возврат запрещён.

Настройка

На сервере

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

2. Введите в строке поиска яндекс → кликните Платежные системы → введите в правую секцию поиска яндекс → установите флажок Яндекс Пэй и Сплит → кликните .

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

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

Параметр	Описание
Адрес подключения *	Вводится веб-адрес сервиса. Пример: https://sandbox.pay.yandex.ru/api/merchant
API-ключ *	Ключ авторизации в сервисе.
API-ключ кассового программного обеспечения для статического QR	API-ключ кассового программного обеспечения для статического QR-кода. SR-8364 - Получение подробных данных проблемы… СТАТУС CR-14173 - Получение подробных данных проблемы… СТАТУС 10.4.19.0
Доступна оплата Яндекс Пэй	Доступные способы оплаты. Должен быть установлен хотя бы один флажок.
Доступна оплата в Сплит
Время жизни заказа (в секундах)	Время, за которое покупатель должен успеть подтвердить оплату. При превышении указанного времени процесс оплаты потребуется запустить заново. Минимально допустимое значение 180 секунд, максимальное - 604800
ID товара	Идентификатор/артикул товара, который будет передаваться в запросе на оплату вместо всех позиций чека. Стоимость товара будет равна сумме чека. Максимальное количество символов - 2048.
Наименование товара	Универсальное наименование товара, используемого для передачи в запросе на оплату. Максимальное количество символов - 2048.
Таймаут соединения (сек., по умолчанию: 3)	Время соединения с сервисом при попытке оплаты.
Таймаут ожидания ответа (сек., по умолчанию: 10)	Время ожидания ответа от сервиса после инициализации оплаты.
Количество попыток для запроса (по умолчанию: 5)	Количество попыток отправки запросов на создание платежа.
Обратный QR (по умолчанию)	Включает тип оплаты обратным QR, при котором кассир сканирует динамический QR-код, сформированный пользователем в приложении Яндекс Пэй. Выбран по умолчанию. Одновременно может использоваться только один тип QR-кода. Если в настройках выбрано несколько типов QR-кодов одновременно или не выбран ни один, после сохранения автоматически применяется значение Обратный QR (по умолчанию). MMTR-104 - Получение подробных данных проблемы… СТАТУС CR-13166 - Получение подробных данных проблемы… СТАТУС 10.4.14.0
Динамический QR Название настройки до версии 10.4.19.0: Прямой QR.	Включает тип оплаты прямым QR, при котором покупатель сканирует динамический QR-код, который печатается на пречеке или отображается на дисплее покупателя. По умолчанию выключен. Одновременно может быть выбран только один тип QR-кода. MMTR-104 - Получение подробных данных проблемы… СТАТУС CR-13166 - Получение подробных данных проблемы… СТАТУС 10.4.14.0
Статический QR	Включает тип оплаты прямым QR, при котором покупатель сканирует статический QR-код, размещенный на специальной наклейке или табличке в кассовой зоне. По умолчанию выключен. Одновременно может быть выбран только один тип QR-кода. SR-8364 - Получение подробных данных проблемы… СТАТУС CR-14173 - Получение подробных данных проблемы… СТАТУС 10.4.19.0
Разрешить смешанную оплату	Включает возможность смешанной оплаты и частичного возврата с помощью Яндекс Пэй и Сплит. По умолчанию настройка выключена, смешанная оплата запрещена. MMTR-179 - Получение подробных данных проблемы… СТАТУС CR-13755 - Получение подробных данных проблемы… СТАТУС 10.4.16.0
Валюта (по умолчанию: RUB) *	Валюта SR-8416 - Получение подробных данных проблемы… СТАТУС CR-14345 - Получение подробных данных проблемы… СТАТУС 10.4.20.0

5. На вкладке ЯНДЕКС ПЭЙ И СПЛИТ установите дополнительные флажки настроек, если требуется.

Название настройки	Описание
требует пропорциональный возврат	При возврате позиций чека, оплаченного смешанной оплатой, типы оплат будут пропорционально распределены между возвращаемыми позициями.
частичный возврат чека запрещен	Разрешен только возврат чека полностью.
допускать запрет других типов оплат	Функциональность не поддерживается в данной версии плагина.
возвращать дополнительными способами вместо плагина	При оформлении возврата чека, оплаченного Яндекс Пэй и Сплит, денежные средства могут быть возращены только выбранными типами оплат из списка. Возврат Яндекс Пэй и Сплит недоступен.
Дополнительные способы возврата, доступные всегда Если включена "возвращать дополнительными способами вместо плагина", то этот список используется вместо плагина. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы.	Список типов оплат, всегда используемых для выполнения возврата в дополнение к Яндекс Пэй и Сплит.
Способы возврата, дополнительно доступные по решению плагина Если включена "возвращать дополнительными способами вместо плагина", то этот список не применяется. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы.	Список типов оплат, используемых для выполнения возврата при невозможности завершить возврат плагинным типом оплаты. Функциональность не поддерживается в данной версии плагина.

6. Кликните .

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

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

CR-13755 - Получение подробных данных проблемы… СТАТУС

10.4.16.0

Начиная с версии 10.4.16.0 тип оплаты Яндекс Пэй и Сплит переименован в Яндекс Сплит.

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

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

Пример скрипта.

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

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

На кассе

Настройка конфигурации

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

1. В конфигураторе войдите во Внешние процессинги.

2. Проверьте, что процессинг Яндекс Пэй и Сплит в статусе используется.

SetTouch

1. Откройте на просмотр файл /home/tc/storage/crystal-cash/config/modules/payments-config.xml.

2. Проверьте, что в списке присутствует тип оплаты yandex.pay.payment.plugin.

3. В настройках кассы войдите во Внешние системы.

4. Проверьте, что сервис Яндекс Пэй и Сплит активирован.

CSI K

1. Перейдите в Меню → Конфигуратор.

2. Выберите Внешние процессинги.

3. Проверьте, что процессинг Яндекс Пэй и Сплит в статусе не используется.

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

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

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

Пример 1 – добавляет свойство;
Пример 2 – обновляет уже существующее.

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

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

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

Экспорт в ERP

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

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

<purchase ...>

<payments>
- yandex.pay.payment.plugin - плагин оплаты Яндекс Пэй и Сплит.
  - cash.transaction.date - дата и время транзакции.
  - payment.amount - сумма оплаты.
  - cash.operation.id - номер заявки, 32 символа.
  - terminal.id - идентификатор терминала. Состоит из следующих данных:
    - префикс (латинская Y);
    - номер магазина (4 знака по умолчанию, для магазинов с пятизначным номером передается 5 знаков);
    - номер кассы (3 знака);
    - если знаков меньше, добавляются нули перед значениями и магазин (до 4 знаков) и касса (до 3 знаков).
</payments>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="99999" userName="Иванов Иван Иванович" operationType="true" cashOperation="INCOME" operDay="2024-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">
        <plugin-property key="PROMO_PRINT_DISABLED" value="true"/>
        <plugin-property key="FN_DOC_NUM_IN_SHIFT" value="2"/>
        <plugin-property key="FISCAL_DOC_ID" value="57"/>
        <plugin-property key="CASHIER_NAME" value="Иванов Иван Иванович"/>
        <plugin-property key="UID_PURCHASE" value="ee39a7c9-8980-4e2b-b9b4-ba34a6626de6"/>
        <plugin-property key="KPP" value="987654321"/>
        <plugin-property key="CASH_TIME_ZONE" value="+03:00"/>
        <positions>
            <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="1.000" cost="18.00" nds="20.0" ndsSum="2.70" discountValue="1.80" costWithDiscount="16.20" amount="16.20" dateCommit="2024-03-01T17:13:28.986+03:00" insertType="2">
                <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="yandex.pay.payment.plugin" amount="16.20" description="Яндекс Пэй и Сплит"/>
                <plugin-property key="cash.transaction.date" value="2024-02-19T13: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

CSI K

Обратный QR

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

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

Ограничения

Настройка

На сервере

На кассе

Настройка конфигурации

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

SetTouch

CSI K

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

Экспорт в ERP

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