Модуль Сбербанк предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур, которые предоставлены Сбербанком России.

...

.

Модуль представляет собой клиентское приложение sb_pilot и набор файлов и библиотек, необходимых для обращения к процессинговому центру. При проведении оплаты платежной картой кассовая программа вызывает клиентское приложение sb_pilot. Параметрами для этого приложения передаются:

...

После завершения работы приложения, создаются файлы с результатом выполнения операции (файл e) и образом квитанции, которую необходимо распечатать (файл p). Кассовая программа анализирует результат выполнения и при необходимости печатает на чековой ленте содержимое печатного образа.

...

• оплата,
• возврат,
• отмена последней операции,
• сверка итогов,
• печать полного и краткого отчетов,
• прерывание операции оплаты с кассы.

Конфигурирование модуля

Для использования модуля необходимо установить пакет  artix45-plugin-sb. 

aptitude install artix45-plugin-sb

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

dpkg-reconfigure artix45-plugin-sb

Файлы, необходимые для функционирования модуля, располагаются в директории директории /linuxcash/cash/paysystems/sb . 

Файлы клиентского приложения предоставляются сотрудниками банкаавтоматически помещаются в директорию /linuxcash/cash/paysystems/sb/. Одна из версий приложения включена в состав пакета, ее файлы располагаются в директории директории /linuxcash/cash/paysystems/sb/files. Для использования данной версии приложения файлы необходимо скопировать в директорию /linuxcash/cash/paysystems/sb/.

При необходимости выполнения операций, минуя кассовую программу, достаточно запустить скрипт sb_call.sh с нужными параметрами. Данный скрипт вызывает клиентское приложение в специально подготовленном окружении для корректного отображения информации на экране.

Параметры настройки для минивыписок (слипов) и кодовых страниц, в которых клиентское приложение возвращает результат, задаются в файле вызова клиентского приложения задаются в конфигурационном файле /linuxcash/cash/conf/artixsb.conf в секции [main].

Параметры вызова клиентского приложения

...

[main]
encoding=koi8-r
limit=0
 
; Отображать диалоги на пинпадепин-паде
; В противном случаемслучае диалоги будут отображаться на кассе
; По умолчанию true
;dialogsOnPinpad = true

; Время ожидания ответа от пин-пада в секундах
; по умолчанию 300
;timeout = 300

; Список кодов ошибок для которых требуется запрос статуса операции
; По умолчанию 12,99,2004,4338
;statuses = 12,99,2004,4338
...

В кассовом ПО реализована возможность задавать таймаут ожидания ответа от пин-пада при сверке итогов с помощью параметра totalsTimeout. При значении по умолчанию (-1) будет применено значение параметра timeout.

[main]
...

; Время ожидания ответа от пин-пада при сверке итогов в секундах
; Если выставлено значение -1, то используется значение настройки timeout
; по умолчанию -1
;totalsTimeout = -1

Автоматическое добавление карты лояльности в чек при оплате через терминал

В кассовом ПО Artix реализована возможность автоматического добавления карты лояльности в чек при первой (или полной) оплате через процессинг Сбербанк, а также передачи номера карты и суммы начисляемых баллов для отображения информации о них на экране терминала и в клиентском приложении.

Если в приложении СберБанк Онлайн нет привязанной к счету карты лояльности, то при наличии карты лояльности в чеке во время оплаты ее номер передается в терминал. Карта лояльности добавляется в клиентское приложение.

Если в приложении СберБанк Онлайн есть привязанная к счету карта лояльности, то:

• при отсутствии карты лояльности в чеке оплата прерывается, и терминал возвращает номер привязанной карты лояльности. Карта автоматически добавляется в чек, после чего пересчитывается дисконт и завершается оплата.
  

  • Если добавлена карта "Артикс Бонус", то на экран будет выведен диалог списания бонусных баллов. После подтверждения операции списания оставшаяся сумма к оплате пересчитывается.

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

    
    

• при наличии карты лояльности в чеке номер карты, полученный с терминала, игнорируется. Карта в чек не добавляется.

Возможность автоматического применения карты лояльности задается с помощью параметра registerDiscountCard в конфигурационном файле /linuxcash/cash/conf/artixsb.conf секции [SberLoyalty]:

...

;dialogsOnPinpad = true[SberLoyalty]

; Отправлять в терминал номер дисконтной карты и сумму начисляемых баллов.
; Если терминал вернет номер дисконтной карты, то в процессе оплаты карта добавится в чек
; По умолчанию false
;registerDiscountCard = false

Сохранение данных операции и терминала

Сохранение способа чтения номера карты и флагов операции

В кассовом ПО реализовано сохранение способа чтения номера карты и флагов операции при оплате через процессинг Сбербанк с использованием клиентского приложения sb_pilot. В БД Documents таблицу Moneyitem в поле additionaldata записывается json-объект с полями:

• cardEntryMode – способ чтения номера карты,
• operationFlags – флаги операции.

{"cardEntryMode":"E","operationFlags":"00010000"}

Сохранение номера терминала

В кассовом ПО Artix реализовано сохранение идентификатора номера терминала Сбербанк в БД Documents таблицу Moneyitem в поле terminalid.

Логирование

Журнал вызовов клиентского приложения из кассовой программы ведется в основном логе кассовой программы /linuxcash/logs/current/terminal.log. Для идентификации данных, записанных модулем Сбербанк, используется логгер с именем payment. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.

Настройка

...

пин-пада

Необходимо настроить параметры взаимодействия пинпада пин-пада с ККМ:

• Интерфейс интерфейс кассира на пинпадеПечатать пин-паде,

• печатать один образ чека с цифрой впереди,

• При при успешной операции не ждать подтверждения от кассира.

Настройка

...

пин-пада PAX SP30

При установке пакета  ttypos создается директория /opt/ttyPos, в которой хранятся конфигурационные файлы.

Символьная ссылка на файл устройства может создаваться двумя способами:

1. Пакет ttypos содержит драйвер (модуль ядра) для PAX SP30, который создает в системе последовательный порт ttyPos0.

...

1. Чтобы заработал пин-пад, необходимо создать ссылку на порт, созданный драйвером, в директории процессинга Cбербанк:

   Code Block
   language text
   ln -s /dev/ttyPos0 /linuxcash/cash/paysystems/sb/ttyS99

   
   

2. С помощью параметров для подключения пин-пада, которые настраиваются в файле /opt/ttyPos/conf.ini.

   Наименование	Тип данных

...

1. 	Описание	Примечания
   ttypos_port	строковый

...

1. Наименование порта, созданного драйвером	Если указана настройка com_port, то на данный порт создается ссылка
   com_port	строковый	Наименование ссылки, создание которой запускает скрипт /opt/ttyPos/setport.sh при подключении устройства

   
   

   Code Block
   language text title Пример настройки
   ; ttyPos-устройство ttypos_port="/dev/ttyPos0" ; COM-порт для работы с usb-устройством (ссылка на ttyPos-устройство)

...

1. com_port="/dev/ttyS99"

   
   

Использование одного терминала для нескольких организаций

Использование одного терминала для нескольких организаций необходимо в случаях, когда реализация товаров и услуг выполняется разными организациями. Для реализации данного механизма, кассовая программа вызывает клиентское приложение sb_pilot с дополнительным параметром - идентификатором организации, который соответствует коду отдела настроенного на пинпадепин-паде.

...

• В чеке возврата и возврате по чеку продажи запрещено сторнировать операцию по безналу (согласно протоколу Сбербанка эта операция будет проводиться как оплата, что повлечет за собой снятие комиссии).
• Сверка итогов по безналу и печать отчетов по безналу всегда производится общая по всем отделам (ограничение протокола Сбербанка).

• При возврате по безналу на одно юридическое лицо в рамках текущей банковской смены осуществляется отмена операции оплаты. Если настройками кассы предусмотрено распределение по отделам, то при возврате по безналу в рамках банковской смены выполняется операция возврата (требования процессинга, в отчетах она отражается как отмена).

• После снятия отчета по безналу в другой кассовой смене возврат по безналу проходит запросом возврата.

• Если в чеке продажи присутствуют товары из разных отделов, то после оплаты товара из одного отдела на экран будет выведен диалог "Извлеките карту из пин-пада".

Оплата по биометрии

В кассовом ПО Artix реализована возможность оплаты по биометрии через процессинг Сбербанк с использованием пин-пада Kozen.

Оплата по биометрии возможна двумя способами:

Возможные ошибки при оплате по б/н

На кассе

Для корректного функционирования модуля оплаты на кассе осуществляется проверка наличия файла sb_call.sh и наличия прав на его исполнение. При невыполнении одного из условий на экран будет выведено соответствующее сообщение. 

При корректном запуске скрипта sb_call.sh вызывается файл клиентского приложения sb_pilot. Выполняется проверка наличия файла и наличие наличия прав на его исполнение.

При отсутствии файла sb_pilot  или невозможности его исполнения на экран выдается сообщение "Ошибка чтения файла статуса операции".

На

...

пин-паде

Если настроены диалоги на пинпадепин-паде, то файл sb_call.sh не используется, вызывается файл sb_pilot. При невыполнении одного из условий на экран будет выведено соответствующее сообщение.

...