Настройка Форинт Pay service для оплаты услуг через

Настройка Форинт Pay service для оплаты услуг через
платежную систему Cyberplat
Краткое описание
Назначение
Программный комплекс Форинт Pay service (далее PS) предназначен для поддержки
безналичных платежей и операций с банковскими картами на предприятиях розничной
торговли. Кроме того, PS обеспечивает настройку и функционирование внутренней
системы персональных платежных и дисконтных карт, а также включает сервер
персональной дисконтной системы.
Структура
PS включает в себя следующие компоненты:
Служба обработки запросов
Служба обработки запросов PS – это служба Windows, принимающая запросы от
кассовых терминалов по протоколу http и подключающаяся к серверам платежных систем.
Кроме того, служба обработки запросов постоянно обращается к базе данных посредством
учетной системы PS, выступая в качестве пользователя учетной системы.
Учетная система PS
Учетная система PS представляет собой учетную систему семейства Форинт,
используемую для управления всем программным комплексом, хранения информации о
транзакциях, ведения документов, формирования печатных отчетов и пр. Все
взаимодействие пользователя с PS происходит через учетную систему.
Установка дистрибутива
В процессе установки необходимо указать следующие параметры службы обработки
запросов:

Параметры входа в систему. Способ входа в систему определяет учетную
запись, под которой будет запускаться служба. Может использоваться пользовательская
либо системная учетная запись. При использовании пользовательской учетной записи
необходимо указать имя и пароль пользователя.

Параметры SQL-сервера. В этом разделе задаются параметры подключения к
БД учетной системы. Помимо атрибутов БД необходимо указать тип аутентификации при
подключении к SQL-серверу. Если служба будет запускаться под системной учетной
записью, то может использоваться только аутентификация средствами SQL-сервера (т.е.,
необходимо указать имя и пароль пользователя SQL-сервера). Если служба будет
запускаться под пользовательской учетной записью, то можно использовать также и
Windows-аутентификацию.
При нажатии кнопки «Пропустить» установка службы будет продолжена с
настройками по умолчанию.
Настройка системы
После установки дистрибутива необходимо создать базу данных учетной системы PS
(если установка производится первый раз). Для этого необходимо в утилите
«Конфигуратор»
открыть
файл
конфигурации
учетной
системы
(<Каталог_установки>\Config\config.xml) и выполнить команду «Создать объекты в БД».
Создав базу данных, можно запускать учетную систему PS. При первом запуске
будет предложено выполнение начальной инициализации объектов системы.
Во время выполнения начальной инициализации будут установлены основные
константы и заполнены необходимые справочники учетной системы. Помимо этого,
пользователю необходимо указать некоторые значения, специфичные для его
конфигурации:
Константы



Телефоны владельца;
Адрес владельца;
Наименование владельца.
Пользователи
По умолчанию в учетной системе создан только один пользователь –
«Администратор» с пустым паролем. Для того чтобы другие сотрудники могли работать с
PS, для них необходимо создать учетные записи. Указанную операцию можно выполнить
путем выбора пункта «Список пользователей системы» из подменю «Операции» главного
меню.
Обязательно нужно создать учетную запись для службы обработки запросов. По
умолчанию служба подключается под учетной записью «PayService» без пароля.
Справочники

Кассовые терминалы. В справочник должны быть занесены терминалы,
выполняющие транзакции через PS. Реквизит «Хост» должен содержать имя терминала в
сети;

Поставщики услуг. Справочник содержит список поддерживаемых в
настоящий момент платежных систем, в т.ч., платежную систему «Киберплат». Для
возможности проведения платежей через платежную систему необходимо в форме
справочника заполнить параметры связи (по умолчанию они пустые);

Операторы. В справочник необходимо добавить организации, принимающие
платежи (например, операторы сотовой связи, интернет-провайдеры и т.п.). Для каждого
оператора должен быть задан процессинговый центр (платежная система), через которую
будет производиться оплата (например, «Киберплат»), форма оплаты и идентификатор, а
также параметры, определяемые платежной системой: префикс, минимальный платеж,
процент комиссии.
Выгрузка данных в терминалы
После заполнения справочников необходимо произвести выгрузку части данных в
терминалы. Для этого существует обработка «Синхронизация справочников». Выгрузка
производится через службу обмена данными на терминале.
Запуск службы обработки запросов
Службу обработки запросов имеет смысл запускать после полной настройки
параметров учетной системы. Запуск службы можно произвести из консоли «Управление
компьютером/Службы» (название службы – «Сервер платежей») либо выполнив команду
«net start PayServiceSvc». Если все было выполнено правильно, служба запустится и
сможет обрабатывать запросы от терминалов.
В процессе функционирования служба обработки запросов ведет историю в
системном журнале событий «PayService» (консоль «Управление компьютером/Просмотр
событий»). В большинстве случаев просмотр журнала событий позволяет определить
причину ошибки, невозможности запуска службы или некорректной обработки запроса.
Что делать в случае ошибки
При инсталляции дистрибутива служба обработки запросов не была
установлена.
Скорее всего, был выбран вход в систему с пользовательской учетной записью и
неправильно указан логин или пароль, либо учетная запись пользователя не имеет прав
для установки службы. В первом случае необходимо указать правильный логин/пароль, во
втором случае можно установить службу с правами другого пользователя;
Невозможно запустить установленную службу обработки запросов.
В большинстве случаев причина этого будет описана в журнале событий. Возможны
следующие ситуации:

Файл конфигурации не найден. Проверить в файле настроек службы
параметр
«AppFolder».
В
нем
должен
содержаться
путь
к
папке
«<Каталог_установки>\Config», в которой должен находиться файл конфигурации
config.xml;

Службе не удалось подключиться к базе данных. Необходимо проверить в
файле настроек службы, параметр «ConnString». Он должен содержать строку
подключения к SQL-серверу. При аутентификации средствами SQL-сервера строка
должна иметь вид «Integrated Security=False;Persist Security Info=False;Initial
Catalog=БазаДанных;Data Source=Сервер;User ID=пользователь;pwd=пароль», в случае,
если производится Windows-аутентификация, строка должна быть следующей: «Integrated
Security=SSPI;Persist Security Info=False;Initial Catalog=БазаДанных;Data Source=Сервер»;

Службе не удалось подключиться к учетной системе. Необходимо проверить
в файле настроек службы, параметр «AppUser». При первой установке там должно быть
значение «PayService». В учетной системе Форин Учетная запись с таким именем должна
быть создана;
На запрос кассового терминала служба возвращает сообщение «Ошибка
сервера авторизации».
Причина ошибки описана в журнале событий. Чаще всего это неправильно заданные
параметры связи с платежной системой.
Параметры связи для платежной системы «Киберплат»:

Host. URL процессинга без протокола;







SecretKeyFile. Файл с секретным ключом клиента. Путь задается
относительно каталога драйвера. Получать у поставщика;
Serial. Серийный номер секретного ключа клиента. Получать у поставщика;
PublicKeyFile. Файл с открытым ключом сервера. Путь задается
относительно каталога драйвера. Получать у поставщика;
Password. Пароль клиента. Получать у поставщика;
SD. Получать у поставщика;
AP. Получать у поставщика;
OP. Получать у поставщика.
Пример параметров связи:








Host = payment.cyberplat.ru
SecretKeyFile = cyberplat\secret.key
Serial = 64182
PublicKeyFile = cyberplat\pubkeys.key
Password = 1111111111
SD = 17031
AP = 17032
OP = 17034