Программный модуль Сбербанка России для обслуживания банковских карт на ККМ под управлением DOS
Общие сведения
Интегрируемый программный модуль sb_pilot.exe используется совместно с программным обеспечением контрольно-кассовых машин для проведения платежей по банковским картам. Продукт предназначен для работы под управлением MS-DOS.
Модуль выполняет все операции, необходимые для проведения платежа, начиная со считывания карты (магнитной или микропроцессорной) и заканчивая формированием карточного чека («слипа»), который вызывающая программа должна направить на печать.
Связь c банком может осуществляться через локальную сеть либо через модем, подключаемый напрямую к ККМ.
Требования к аппаратному обеспечению
-
IBM-совместимый компьютер на базе процессора не ниже 80286;
-
объем оперативной памяти не менее 1 МБ;
-
объем свободного дискового пространства не менее 5 МБ;
-
наличие свободного порта RS-232 для подключения ПИН-клавиатуры VeriFone SC5000 или аналогичной (предоставляется Сбербанком бесплатно);
-
Сетевая карта Ethernet.
Требования к программному обеспечению
-
версия MS-DOS не ниже 3.01;
-
объем свободной оперативной памяти не менее 230 K;
-
наличие русификатора клавиатуры/дисплея;
-
наличие сетевой оболочки FTP Software PCTCP, либо Novell TCPIP.
Выполняемые функции
Платежный терминал поддерживает две группы функций:
-
для проведения платежей по картам;
-
служебные функции.
Для проведеня платежей по картам поддерживаются следующие функции:
-
оплата покупки (услуги);
-
возврат покупки;
Служебные функции включают в себя:
-
сверку итогов (ежедневная процедура закрытия смены с распечаткой отчета и очисткой списка операций);
-
вход в технологическое меню (для настройки параметров и др. служебных операций).
Состав программного обеспечения
Установленное программное обеспечение имеет следующий состав файлов:
Sb_pilot.exe
|
Запускаемый файл программы
|
Updosmn.out
|
Основной исполняемый модуль
|
Updoscf.exe
|
Вспомогательный редактор настроек
|
Updosuz.out
|
Служебный модуль-распаковщик (используется при удаленном обновлении ПО)
|
R003.r
|
Файл ресурсов для редактора настроек
|
Example.tlv
|
Файл с настройками (готовится на Windows-машине с помощью программы TlvEdit).
|
Вызов программы
Синтаксис вызова программы следующий:
Sb_pilot.exe <�тип операции> <�сумма операции> <�тип карточки> <�данные 2-й дорожки>
где:
<�тип операции> может принимать значения:
Операция
|
|
тип
|
Назначение
|
|
1
|
Оплата
|
3
|
Возврат покупки
|
7
|
Сверка итогов
|
9
|
Печать контрольной ленты (без сверки итогов)
|
11
|
Вход в технологическое меню
|
12
|
Повтор последнего документа
|
14
|
Загрузка TLV-файла
|
19
|
Загрузка TLV-файла с предварительным удалением старых настроек
|
<�сумма операции> — указывается в копейках;
<�тип карточки> может принимать значения:
0
|
Определять автоматически (рекомендуется)
|
1
|
Visa, Visa Electron
|
2
|
MasterCard
|
3
|
Maestro
|
4
|
Amex
|
5
|
Diners Club
|
9
|
СБЕРКАРТ
|
Если в данной операции сумма не используется, она должна быть равной 0. Если в данной операции тип карточки не используется, он должен быть равен 0.
<�данные 2-й дорожки> - считанный с магнитной карточки Track2, без заголовочных и хвостовых символов. Номер карты отделяется знаком ‘=‘.
Как правило, этот параметр не указывается при вызове программы. В этом случае программа сама выдаст оператору запрос на ввод карточки. При этом карта может быть считана через устройство VeriFone SC5000 либо через встроенный клавиатурный ридер ККМ.
Передача результатов работы программы
По окончании работы программы формируются два текстовых файла — файл обмена и файл чека.
Первый имеет имя e и предназначен для передачи вызывающей программе параметров совершенной операции. Первая строка в этом файле содержит код результата операции, и через запятую – поясняющее текстовой сообщение. Код 0 означает успешное проведение платежа, любое другое значение – отказ или невозможность проведения платежа.
Если код результата равен 0, то для платежной операции последующие строки файла e содержат параметры совершенной операции. Например:
Образец содержания файла
|
Примечание
|
0,Успешно
4276********2106
10/09
013AU3
0007
VISA
1
00870001
20120403173415
481CF86160609155A2310BD83D7512BA34F48328
|
Код результата и текст сообщения
Номер карты (маскированный)
Срок действия карты
Код авторизации
Внутренний номер операции
Название типа карты
Признак карты Сбербанка (1)
Номер терминала
Дата-время операции (ГГГГММДДччммсс)
Ссылочный номер операции (может быть пустым)
Хеш от номера карты
|
Второй файл с именем p (имя может быть изменено) является образом чека для вывода на принтер. Вызывающая программа должна самостоятельно передать этот файл на принтер. Файл чека формируется только в том случае, если код результата равен 0.
Имя файла чека устанавливается в конфигурационном файле программы и обычно имеет значение p. В исключительных случаях можно назначить файлу чека имя prn — тогда он будет печататься сразу, до завершения работы программы.
Конфигурация и настройка
Настроечные параметры программы необходимо подготовить в виде TLV-файла с помощью программы TlvEdit, работающей под Windows. Этот процесс описан в отдельном документе «Руководство по настройке».
Сформированный TLV-файл необходимо поместить в каталог с программой sb_pilot. После этого необходимо запустить программу с параметром 11:
Sb_pilot.exe 11
и в открывшемся меню выбрать пункт «Служебные операции \ Настройки \ Техобслуживание \ Пароль 878787 \ Загрузка параметров». При наличии в каталоге нескольких TLV-файлов программа предложит выбрать нужный.
В случае, если после этого возникает необходимость изменить значение какого-либо параметра, для этого можно воспользоваться программой updoscf.exe. Эта программа редактирует не сам TLV-файл, а импортированные из него параметры (файлы *.d).
|