Публичное пространство
Узбекистан ◾️ Платежный сервис Humo-Rahmat
https://crystals.atlassian.net/browse/SRTG-635
https://crystals.atlassian.net/browse/CR-15872
10.5.1.0
Описание
Плагин Rahmat Kassa Payment Plugin предназначен для подключения новых банковских терминалов Humo в Узбекистане к кассовому модулю SetRetail10 и выполнения оплаты банковской картой.
Плагин обеспечивает обмен кассы с терминалом Rahmat через USB/COM-подключение, инициирует оплату на терминале, получает результат банковской операции и передает данные оплаты в кассовый модуль.
Начиная с версии 10.5.1.0 плагин Rahmat входит в дистрибутив кассового модуля SetRetail10 для возможности оплаты банковской картой на новых терминалах Humo.
Функциональность актуальна для клиентов в Узбекистане, где используются терминалы Humo нового типа.
Начиная с версии 10.5.1.0 добавлена передача в фискальный регистратор FiscalDriveAPI дополнительной информации по оплате банковской картой в Узбекистане — маскированного номера карты в поле CardNumber и идентификатора транзакции RRN/PPTID в поле PPTID. Для внешних терминалов Humo (Rahmat) касса может запрашивать эти данные у кассира, а для интегрированных терминалов — получать их из ответа банковского процессинга.
Подробнее Узбекистан ◾️ Передача и сохранения дополнительной информации при оплате банковским терминалом.
Клавиатурная касса | SetTouch |
|---|---|
|
|
Ценность
Поддержка новых банковских терминалов Humo для рынка Узбекистана.
Возможность принимать оплату банковской картой через терминал Rahmat из кассового модуля SetRetail10.
Передача в оплату дополнительных атрибутов банковской операции: маскированного номера карты, идентификатора транзакции и типа карты.
Сохранение совместимости с логикой фискализации и передачи данных в ОФД для Узбекистана.
Предварительные условия
Используется SetRetail10 версии 10.5.1.0 или выше, либо версия, в дистрибутив которой добавлен плагин Rahmat.
Есть терминал Rahmat/Humo, подключаемый к кассе по USB.
На сервере SetRetail10/SetCentrum доступны разделы настройки внешних процессингов и шаблонов касс.
Плагин согласован для использования с конкретным клиентом и терминалом. Поддержка и дальнейшие права на плагин остаются на стороне разработчика плагина.
Настройка
Сервер
Добавление процессинга выполняется на сервере SetRetail10/SetCentrum по стандартной схеме для внешних процессингов.
1. На сервер SetCentrum/SetRetail10 перейдите в раздел Интеграция → Внешние процессинги → кликните .
2. В строке поиска слева введите Humo → кликните Платежные системы → введите в строке поиска справа Humo → установите флажок Платежная система Humo-Rahmat → кликните СОХРАНИТЬ.
3. В списке платежных систем выберите Платежная система Humo-Rahmat.
Откройте добавленный процессинг для настройки.
4. Настройке подключение к процессингу:
На вкладке ОБЩИЕ укажите магазины, а также параметры
Настройка | Описание |
|---|---|
Путь к порту терминала | Путь подключения к терминалу: Пример: /dev/usbSV0e8dP2006 Подключите терминал к системному блоку кассы → выполните команду для идентификации адреса подключения: ls -la /dev/usb*
|
Таймаут ожидания ответа | Время ожидания ответа от банковского терминала |
На вкладке ОПЛАТА ЧЕРЕЗ HUMO-RAHMAT установите настройки:
Настройка | Включение настройки | Описание |
|---|---|---|
Разрешить смешанную оплату |
| Определяет, можно ли оплатить через обратный QR часть суммы чека. |
Количество попыток для запроса |
| Максимальное количество попыток запроса статуса платежа перед завершением или подтверждением оплаты. |
Пауза между попытками, секунды |
| Пауза между повторными запросами статуса или подтверждения платежа. Рекомендуемое значение — от 3 до 10 секунд. |
Требует пропорциональный возврат |
| При возврате позиций чека, оплаченного смешанной оплатой, типы оплат будут пропорционально распределены между возвращаемыми позициями. |
Частичный возврат чека запрещен |
| Разрешен только возврат чека полностью. |
Возврат по чеку доступен всегда |
| Флаг-признак, разрешающий возврат чека, полученного в другом магазине. Также влияет на поиск чека на сервере для печати копии. |
Допускать запрет других типов оплат |
| Определяет возможность плагина ограничивать (запрещать) использование определённых типов оплат. |
Использовать одну оплату для разделенных чеков |
| Использует одну оплату на полную сумму вместо нескольких при разделении чека. При полном возврате всех разделённых чеков оплата будет возвращаться отдельными частями. |
Признак автоматического применения оплаты для физ.лиц (оплата будет скрыта) | Должен быть снят | Оплата применяется только автоматически для физических лиц из внешних систем. Не допускается сканировать более одного МЧ в рамках чека. Предоплата из второго и последующих не будет применена. |
Признак автоматического применения оплаты для юр.лиц (оплата будет скрыта) | Должен быть снят | Оплата применяется только автоматически для юридических лиц (контрагентов) из внешних систем. Запрещает сканирование более одного МЧ в рамках одного чека. Оплата остаётся скрытой от кассира. |
Разрешить использовать оплату для выдачи наличных |
| Определяет, может ли данный тип оплаты быть использован для операции выдачи наличных (cash-out). Некоторые типы оплат запрещают эту операцию (например, оплата по QR-коду). |
Код оплаты для передачи в систему событий |
| Код оплаты для передачи в систему событий:
|
Возвращать дополнительными способами вместо плагина |
| При оформлении возврата чека, оплаченного с помощью плагина Приорбанк КРОК (Обратный QR), денежные средства могут быть возвращены только выбранными типами оплат из списка. Возврат через QR-платеж плагина недоступен. |
Дополнительные способы возврата, доступные всегда Если включена "возвращать дополнительными способами вместо плагина", то этот список используется вместо плагина. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы. | Устанавливаются в зависимости от бизнесс-процессов магазина | Список типов оплат, всегда используемых для выполнения возврата в дополнение к QR-коду от Приорбанк КРОК. |
Способы возврата, дополнительно доступные по решению плагина Если включена "возвращать дополнительными способами вместо плагина", то этот список не применяется. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы. | Устанавливаются в зависимости от бизнесс-процессов магазина | Список типов оплат, используемых для выполнения возврата при невозможности завершить возврат плагинным типом оплаты. Функциональность не поддерживается в данной версии плагина |
5. Включите Humo-Rahmat в типах оплат SetRetail10
После добавления процессинга необходимо включить соответствующий тип оплаты в шаблоне кассы. Без этого кассир не увидит оплату Humo-Rahmat на кассе.
Перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → в секции Типы оплат установите флажок Оплата черех Humo-Rahmat → кликните СОХРАНИТЬ → перезагрузите кассовый модуль
Касса
Задействуйте процессинг на кассе:
Клавиатурная касса: Меню [Конфигуратор] → Внешние процессинги → проверить, что задействован процессинг Приорбанк КРОК.
SetTouch: Настройки → Внешние системы → проверить, что задействован процессинг Приорбанк КРОК.
Перезагрузите кассу для применения настроек.
Пример работы
Кассир добавляет товары в чек продажи.
Кассир переходит к оплате.
Кассир выбирает тип оплаты Humo-Rahmat или другой тип оплаты, связанный с платежной системой Humo-Rahmat.
Касса передает запрос оплаты в плагин Rahmat.
Плагин обращается к терминалу Rahmat/Humo через настроенный USB/COM-порт.
Покупатель выполняет оплату банковской картой на терминале.
Терминал возвращает результат операции.
Касса завершает оплату и регистрирует чек.
В оплате сохраняются атрибуты банковской операции, если они были получены от терминала.
Дополнительная информация
Плагин Rahmat добавлен для оплаты банковской картой на новых терминалах Humo.
Плагин клиентский: ключевая часть настройки выполняется на кассе.
Для корректной работы терминала требуется стабильный путь устройства. Рекомендуемый путь —
/dev/humo_rahmat_terminal.USB-устройство терминала из инструкции имеет Vendor ID
0e8dи Product ID2006.После установки плагина и изменения настроек кассу необходимо перезагрузить.
Если используется функциональность выбора типа банковской карты для Узбекистана, важно корректно передавать тип карты в чек/ФР/экспорт.
Контрольный чек-лист после настройки
/dev/humo_rahmat_terminal создается после подключения терминала.