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

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

Реализована поддержка для следующих типов касс:

Клавиатурная (POS)
SetTouch
CSI K

Описание

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

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

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

Ограничения

Смешанная оплата запрещена.
Возврат только для касс POS и SetTouch.
Произвольный возврат запрещён.

Настройка

На сервере

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

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

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

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

Параметр	Описание
Адрес подключения *	Вводится веб-адрес сервиса. Пример: https://sandbox.pay.yandex.ru/api/merchant/v1
API-ключ *	Ключ авторизации в сервисе.
Доступна оплата Яндекс Пэй	Доступные способы оплаты. Должен быть установлен хотя бы один флажок.
Доступна оплата в Сплит
Время жизни заказа (в секундах)	Время, за которое покупатель должен успеть подтвердить оплату. При превышении указанного времени процесс оплаты потребуется запустить заново Минимально допустимое значение 180 секунд, максимальное - 604800
ID товара	Идентификатор/артикул товара, который будет передаваться в запросе на оплату вместо всех позиций чека. Стоимость товара будет равна сумме чека. Максимальное количество символов - 2048.
Наименование товара	Универсальное наименование товара, используемого для передачи в запросе на оплату. Максимальное количество символов - 2048.
Таймаут соединения (сек., по умолчанию: 3)	Время соединения с сервисом при попытке оплаты.
Таймаут ожидания ответа (сек., по умолчанию: 10)	Время ожидания ответа от сервиса после инициализации оплаты.
Количество попыток для запроса (по умолчанию: 5)	Количество попыток отправки запросов на создание платежа

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

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

6. Кликните .

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

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

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. Проверьте, что процессинг Яндекс Пэй и Сплит в статусе не используется.

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

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

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

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

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

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

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

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

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

SetTouch

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

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

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

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

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

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

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

CSI K

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

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

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

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

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

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

Экспорт в 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>

.

Портал поддержки продуктов CSI

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

Описание

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

Ограничения

Настройка

На сервере

На кассе

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

SetTouch

CSI K

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

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

SetTouch

CSI K

Экспорт в ERP

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