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

Модуль представляет собой клиентское приложение 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/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
...

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

[main]
...

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

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

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

В кассовом ПО реализовано сохранение способа чтения номера карты и флагов операции при оплате через процессинг Сбербанк с использованием клиентского приложения 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. Чтобы заработал пин-пад, необходимо создать ссылку на порт, созданный драйвером, в директории процессинга Cбербанк:

   ln -s /dev/ttyPos0 /linuxcash/cash/paysystems/sb/ttyS99

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

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

   Пример настройки

   ; ttyPos-устройство
   ttypos_port="/dev/ttyPos0"
   
   ; COM-порт для работы с usb-устройством (ссылка на ttyPos-устройство)
   com_port="/dev/ttyS99"

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

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

Прочитать о настройке программы для оплаты несколькими юридическими лицами можно в статье "Банковские платежные системы".

Особенности использования терминала Сбербанк для нескольких юридических лиц:

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

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

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

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

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

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

Для возможности оплаты по биометрии необходимо в БД Dictionaries в таблице Valut  настроить дополнительную валюту с параметром mode=32768.

Для пин-пада WizarPOS необходимо выполнить дополнительную настройку:

1. Установить пакет usbserial-wizarpos (дополнительно к пакету artix45-plugin-sb):

   aptitude install usbserial-wizarpos

2. Создать символьную ссылку на порт, к которому подключен пин-пад, в директории процессинга Сбербанк:

   ln -s /dev/ttyUSB0 /linuxcash/cash/paysystems/sb/ttyS99

Для пин-пада Kozen дополнительная настройка не требуется.

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

На кассе

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

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

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

На пин-паде

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