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

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

   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"

   
   

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

...

...

Начиная с версии 4.6.94 для кассового ПО реализована возможность отправки единого запроса на оплату товара по нескольким юридическим лицам с использованием процессинга Сбербанк.

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

Info
Указание номера отдела реализовано в sb_pilot версии 11.41.04 и выше.

...

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

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

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

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

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

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

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

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

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

   Code Block
   language text
   aptitude install usbserial-wizarpos

   
   

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

   Code Block
   language text
   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. При невыполнении одного из условий на экран будет выведено соответствующее сообщение.

...