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

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

Логирование

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

Настройка пинпада

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

• Интерфейс кассира на пинпаде

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

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

Настройка пинпада PAX SP30

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

Параметры для подключения пинпада настраиваются в файле /opt/ttyPos/conf.ini.

ttypos_port

com_port

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

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

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

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

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

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

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

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

На кассе

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

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

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

На пинпаде

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