Модуль платежей - cyberplatpayment.cyberplat.ru/distr/pmodule/6.0/help/pm6_adm... ·...

123610, г.Москва, ЦМТ-2, Краснопресненская наб.,

д.12 подъезд № 7

Телефон: (495) 967-02-20 Факс: (495) 967-02-08

123610, Moscow, WTC-2, Krasnopresnenskaya nab., 12, entrance # 7

Phone: (495) 967-02-20 Fax: (495) 967-02-08

Модуль платежейРуководство администратора

Версия 6.0

2010

Авторы: Асеева В.А., Шумилина М.Ю.

Модуль платежей. Руководство администратора. Версия 6.0 ОАО КИБЕРПЛАТ

АннотацияНастоящий документ представляет собой руководство администратора по

применению программного обеспечения «Модуль платежей» ОАО КиберПлат, версия 6.0.

Версии документаВерсия Дата Изменения Исполнитель

1.0 16.09.2008 Документ разрабоётан для версии ПО 5.04. Шумилина М.Ю.

2.0 10.02.2010 Документ переработан для версии ПО 6.0, сборка 1117b.

Асеева В.А.

2


Содержание1 Функциональные возможности программы «Модуль платежей» ......................................... 5

2 Установка программы «Модуль платежей» ............................................................................. 7

2.1 Минимальные системные требования ............................................................................... 7

2.2 Инсталляция программы «Модуль платежей» ................................................................. 7

3 Настройки программы «Модуль платежей» .......................................................................... 13

3.1 Функции администратора точки приема платежей ........................................................ 13

3.2 Первый запуск .................................................................................................................... 13

3.3 Регистрация администратора точки приема платежей .................................................. 14

3.4 Изменение пароля администратора ................................................................................ 14

3.5 Импорт данных из предыдущей версии Модуля платежей ........................................... 14

3.6 Создание новой точки ....................................................................................................... 15

3.6.1 Создание новой точки администратором ................................................................. 15

3.6.2 Создание новой точки оператором ........................................................................... 18

3.7 Создание ключей с помощью программы Genkey ......................................................... 20

3.7.1 Хранение ключей на диске компьютера ................................................................... 20

3.7.2 Хранение ключей в электронном ключе eToken ..................................................... 20

3.8 Добавление, редактирование и удаление точки приема платежей ............................... 20

3.8.1 Регистрация новой точки приема платежей ............................................................. 21

3.8.2 Редактирование свойств точки приема платежей ................................................... 23

3.8.3 Удаление точки приема платежа ............................................................................... 23

3.9 Добавление, редактирование, удаление пользователей ................................................. 23

3.9.1 Добавление нового пользователя .............................................................................. 23

3.9.2 Редактирование свойств пользователя ..................................................................... 25

3.9.3 Удаление пользователя .............................................................................................. 25

3.10 Настройка соединения ..................................................................................................... 26

3.11 Настройка списка провайдеров ..................................................................................... 27

3.12 Настройки комиссий ........................................................................................................ 29

3.13 Настройка печати ............................................................................................................ 31

3.14 Настройка проверок ......................................................................................................... 34

3.15 Дополнительные настройки ........................................................................................... 35

3.16 Обновления программы «Модуль платежей» ............................................................... 36

4 Структуры данных .................................................................................................................... 38

4.1 Форматы файлов ключей .................................................................................................. 38

4.2 База данных платежей ....................................................................................................... 39

3


4.3 Формат списка платежей для импорта в программу ...................................................... 40

4.4 Структура запросов на платеж ......................................................................................... 42

4.5 Форматы платежей провайдеров ...................................................................................... 42

5 Справочные материалы ............................................................................................................ 44

5.1 Подключение ККМ к компьютеру и настройка драйвера ККМ ................................... 44

5.1.1 Общие рекомендации по настройке драйверов ККМ ............................................. 44

5.1.2 Настройка драйвера фискального регистратора «Штрих-ФР-К» .......................... 44

5.2 Виды ошибок Модуля платежей ...................................................................................... 47

4


1 Функциональные возможности программы «Модуль платежей»

Программное обеспечение «Модуль платежей» ОАО «КиберПлат» предназначено для приёма платежей за услуги провайдеров и продажи pin-кодов. В процессе работы программа взаимодействует с Интернет-службами КиберПлат, обеспечивая проведение платежей, а также продажу pin-кодов через сервис КиберПлат.

Данное руководство предназначено для администраторов точек приема платежей, в настоящем документе описаны функции собственно администратора точки, работающего с Модулем платежей. Функции оператора точки приема платежей, (которые может выполнять и администратор), описаны в документе «Модуль платежей. Руководство пользователя. Версия 6.0».

Модуль платежей предоставляет возможность непосредственной печати чеков из программы. Системой поддерживаются наиболее распространенные типы контрольно-кассовых машин (ККМ), в частности, ККМ, производимые фирмами «АТОЛ», «ШТРИХ-М», «Инкотекс», ООО «ОКА».

Программа обеспечивает хранение базы принятых платежей и предоставляет большой выбор дополнительных функций, облегчающих приём и последующую обработку платежей.

Модуль платежей предусматривает два базовых варианта схемы проведения платежа:

• непосредственное проведение платежа после ввода данных (Модуль платежей. Руководство пользователя. Версия 6.0. Раздел 2.6. Текущие платежи),

• отложенное проведение платежей (Модуль платежей. Руководство пользователя. Версия 6.0. Раздел 2.7. Отложенные платежи),

Взаимодействие с КиберПлат осуществляется по открытому протоколу, детали реализации протокола опубликованы на сайте КиберПлат.

Протокол взаимодействия с Интернет-службами КиберПлат предусматривает контроль каждого этапа проведения платежа. Все пересылаемые сообщения заверяются электронными цифровыми подписями сторон, имеющими юридическую силу; используется асимметричный алгоритм шифрования RSA с ключами длиной не менее 512 бит. На следующем рисунке представлена функциональная схема работы ПО Модуль платежей.

5

http://www.cyberplat.ru/download/API_CyberPlat.pdf



6


2 Установка программы «Модуль платежей»

2.1 Минимальные системные требованияПеред установкой необходимо убедиться в том, что компьютер, на который выполняется установка программы «Модуль платежей», отвечает следующим требованиям.

• Процессор с тактовой частотой 500 МГц или выше.• Операционная система Microsoft Windows XP или Microsoft Windows 2000.

Операционная система должна обеспечивать поддержку кириллицы.• Оперативная память для Windows 2000, Windows XP - не менее 256 Мб.• Свободное место на жёстком диске 40 Мб плюс дополнительное свободное место

для сохранения данных платежей 10 Мб.• Браузер Microsoft Internet Explorer 5.0 SP2 или более поздняя версия.• Microsoft Office 2000 или более поздняя версия.• Устойчивое соединение с сетью Интернет, рекомендованная скорость передачи

данных – не менее 56 КБит/с.• Рекомендуется использовать UPS – 500 ВА или мощнее.• Microsoft Jet 4.0 Service Pack 8 (SP8) или более поздняя версия (все необходимые

компоненты доступа к данным уже установлены на Вашем компьютере, если на компьютере установлен Microsoft Office 2000 или более поздняя версия).

2.2 Инсталляция программы «Модуль платежей»Перед установкой необходимо скачать с сайта компании «КИБЕРПЛАТ» последнюю версию программы «Модуль платежей».

Для установки необходимо:1. войти под учетной записью «Администратор»;

2. запустить файл pmodule.exe;

3. следовать инструкциям инсталлятора.

Внимание! При установке версии 6.0 Модуля платежей программа проверяет, была ли до этого установлена на компьютере версия 5.04 Модуля платежей. При первом входе в Модуль платежей по запросу программы администратор точки может перенести настройки и базу платежей из версии 5.04 в версию 6.0 (см. раздел Импорт данных из предыдущей версии Модуля платежей).

Этапы инсталляции1.Принятие лицензионного соглашения.

Экран подтверждения лицензионного соглашения представлен на следующем рисунке. Дальнейшая инсталляция возможна только после принятия соглашения.

7

http://payment.cyberplat.ru/distr/pmodule/pmodule.exe


2. Выбор папки установки Модуля платежей представлен на следующем рисунке. При необходимости установить модуль не в ту папку, что указана по умолчанию, нажмите клавишу «Обзор» и выберите папку.

8


4. Выбор устанавливаемых компонентов выполняется с помощью окна, представленного на следующем рисунке.

Внимание! Импорт данных из предыдущей версии описан в разделе Импорт данных из предыдущей версии Модуля платежей.

4. Выбор папки в меню «Пуск». Вы можете отказаться от создания этой папки, установив флажок «Не создавать папку в меню «Пуск».

9


5. Выбор дополнительных задач при установке представлен на следующем рисунке.

В этом окне вы выбираете, где создается ярлык для запуска программы, а также – место размещения конфигурационных файлов.

-- Для всех пользователей – файлы конфигурации размещаются в папке

C:/ Documents and Settings/ All Users/ Local Data/ Application Data/ Cyberplat/ pmodule.

10


-- Только для текущего пользователя - файлы конфигурации размещаются в папке

C:/ Documents and Settings/ <папка пользователя>/ Local Data/ Application Data/ Cyberplat/ pmodule.

В двух перечисленных вариантах установки папка Local Data/ Application Data/ Cyberplat/ pmodule создается автоматически.

-- В папке с программой – этот вариант не рекомендуется использовать. Однако, это возможно сделать для версий операционной системы Windows для версий Windows ХР и ниже. Для операционных систем Windows 7 и Windows Vista такой вариант установки невозможен.

6. Окно подтверждения готовности к установке представлено на следующем рисунке.

Если какие-либо параметры установки вас не устраивают, вы можете вернуться к предыдущему шагу и изменить их. Если параметры вас устраивают, нажмите клавишу «Установить».

7. Процесс установки Модуля платежей отображается в следующем окне.

11


12


3 Настройки программы «Модуль платежей»

3.1 Функции администратора точки приема платежейАдминистратор точки приема платежей выполняет следующие основные функции.

1. Настройка соединения компьютера с Интернетом.

2. Настройка конфигурации точки приема платежей.

3. Создание и удаление пользователей, назначение прав пользователей.

4. Настройка списка провайдеров, поскольку в конкретной точке приема платежей, как правило, не нужен для работы весь список провайдеров, зарегистрированных в системе.

5. Задание и редактирование параметров расчета дополнительной комиссии.

6. Настройка печати чеков.

7. Проверка и коррекция параметров работ точки приема платежей: ограничений по времени работы точки, ограничений сумм платежей.

8. Настройка импорта списка платежей из файла.

3.2 Первый запускЯрлык для запуска программы «Модуль платежей» находится в Меню Пуск/ Программы/ Payment Module или на рабочем столе.

После запуска на экране появится следующее окно «Авторизация пользователя».

При нажатии на кнопку «Регистрация» программа перейдет на операцию Создание новой точки.ВНИМАНИЕ! Для первого входа в программу используйте:

логин - «admin»,

пароль - «1».

В процессе первого запуска Модуля платежей необходимо изменить пароль администратора (Операции/ Конфигурация/ Пользователи/ Задать пароль).

13


В документе «Модуль Платежей. Руководство оператора. Версия 6.0» рассмотрены функции, выполняемые оператором с помощью главного меню, кроме пункта меню Операции/ Конфигурация. Этот пункт главного меню служит для обеспечения функций администратора точки приема платежей, которые будут рассмотрены в настоящем документе.

3.3 Регистрация администратора точки приема платежейПользователь, который первым вошел в Модуль платежей с логином "admin" и паролем "1" приобретает права администратора точки приема платежей. Для этого пользователя нельзя отменить права администратора, в том числе, и при изменении им логина и/или пароля. (Такой порядок работы предусмотрен в программе, чтобы всегда оставался хотя бы один пользователь с правами администратора).

3.4 Изменение пароля администратора Во время первого входа в систему администратор точки изменяет свой пароль далее он входит в систему с новым паролем.

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

Для изменения пароля администратора необходимо в меню выбрать пункт «Операции/ Изменить пароль».

Появится следующее окно задания/смены пароля.

Для принятия изменений нажмите кнопку «ОК», для отмены изменений нажмите кнопку «Отмена».

3.5 Импорт данных из предыдущей версии Модуля платежейМодуль платежей позволяет при установке новой версии программы (версии 6.0) перенести настройки и данные из предыдущей версии программы (версии 5.04).

Из предыдущей версии Модуля платежей импортируются следующие данные.

1. Список активных провайдеров;

2. Настройки расчета дополнительной комиссии;

3. Настройки точек с их ключами;

4. Список пользователей с их правами;

5. Настройки печати, проверок;

6. Дополнительные настройки (закладка Разное);

14


7. База платежей.

Внимание! Перед импортом данных необходимо проверить базу платежей, следует до начала импорта провести все необходимые отложенные, заблокированные и ошибочные платежи. После выполнения импорта данных изменить состояние платежей из старой базы платежей не удастся.Порядок импорта данных из предыдущей версии программы

1. Установить новую версию программы (версия 6.0), порядок установки описан в разделе Инсталляция программы «Модуль платежей».

2. Перед импортом данных следует удалить из папки с данными файл pmodule.db3, в котором хранятся база платежей и настройки Модуля платежей. (В версии 5.04 база платежей и настройки хранятся в файле Cyberterm.mdb). При необходимости повторного импорта данных следует перед импортом повторно удалить файл pmodule.db3.

3. При наличии на компьютере установленной версии 5.04 Модуля платежей программа выдает запрос об импорте данных из версии 5.04.

4. На запрос программы о создании зашифрованной базы данных рекомендуется ответить отрицательно.

5. Запуск импорта данных.

6. Проверка данных после импорта.

3.6 Создание новой точки

3.6.1 Создание новой точки администраторомВ режим создания новой точки пользователь может перейти двумя способами:

1. из главного меню – Операции/ Конфигурация/ Точки, при нажатии кнопки «Мастер настройки точек» открывается окно «Создание точки» (режим для администратора точки приема).

2. из окна авторизации пользователя по клавише «Регистрация» (режим для регистрации оператором новой точки и нового пользователя).

Внимание! Для создания новой точки приема платежей необходимо предварительно получить логин и пароль у главного администратора дилера или менеджера, которые имеют доступ в Кабинет дилера.

Администратор из пункта меню Операции/ Конфигурация/ Точки запускает процесс создания новой точки нажатием кнопки «Мастер точки». На следующем рисунке представлено окно запуска создания новой точки.

15


Для продолжения процесса создания точки каждый раз нажимайте кнопку «Далее», для возврата к предыдущему шагу – кнопку «Назад».

Кнопка «Отмена» служит для прекращения процесса создания точки.

В следующем диалоговом окне администратор точки вводит полученные логин и пароль.

В случае ошибки ввода логина и/или пароля на экран будет выведено следующее диагностическое сообщение:

16


В случае корректного ввода полученных в кабинете дилера логина и пароля администратор получит параметры точки, представленные на следующем рисунке.

Здесь применены следующие обозначения:

• SD – код дилера,

• AP – код точки приема,

• OP – код оператора.

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

17


В следующем окне представлена информация о пути к папке созданных ключей.

3.6.2 Создание новой точки операторомМодуль платежей позволяет оператору самостоятельно зарегистрировать новую точку приема платежей.Для создания в Модуле платежей новой точки приема платежей и регистрации нового пользователя оператор должен выполнить следующие действия.

1. Оператор получает логин и пароль у главного администратора дилера или менеджера, который имеет доступ в Кабинет дилера.

2. Оператор запускает Модуль платежей и в окне авторизации пользователя нажимает кнопку «Регистрация», если оператор является новым пользователем. Если оператор зарегистрирован в модуле платежей, для создания новой точки он активизирует пункт меню Операции/ Новая точка.

3. Программа Модуль платежей предлагает оператору выполнить Создание новойточки (порядок создания новой точки описан в предыдущем разделе).

4. Далее оператору необходимо заполнить данные пользователя новой точки. Для этого он использует следующее окно. Оператор не может назначить новому пользователю, в том числе себе, права администратора.

18


i.

В этом окне вводятся следующие данные оператора:

• полное имя,

• логин,

• пароль,

• PIN для доступа к ККМ.

Код точки приема и Код оператора изменены быть не могут.

После нажатия кнопки «Завершить» процесс создания новой точки и ввода данных нового пользователя точки завершается.

3.7 Создание ключей с помощью программы Genkey

3.7.1 Хранение ключей на диске компьютераАдминистратор Модуля платежей имеет альтернативную возможность создания ключей точки - с помощью программы создания ключей Genkey. Этот способ подробно

19


описан в документе «Кабинет дилера. Руководство пользователя. Версия 2.0» в Разделе 2.4.1. «Создание ключей API- и WEB-точек с помощью программы Genkey и их регистрация».

Программа генерации ключей Genkey и инструкция по ее применению находятся на сайте КиберПлат по адресу http://www.cyberplat.ru/tech/genkey/.

Внимание! Перед генерацией ключей необходимо создать папку для хранения «боевых» ключей. Рекомендуется ограничить доступ к папке «боевых» ключей для остальных пользователей компьютера.

Рекомендуются следующие параметры доступа:• доступ к папке ключей (чтение и запись) должен быть открыт только для

администратора и операторов Вашей точки приёма платежей;

• всем посторонним пользователям, не имеющим непосредственного отношения к работе с программой «Модуль платежей», любой доступ к папке ключей должен быть запрещён.

3.7.2 Хранение ключей в электронном ключе eTokenПрограмма создания ключей GenKey может создавать ключи как на диске компьютера, так и в защищённой памяти электронного ключа eToken.При выборе администратором пункта меню Операции/ Точки/ Свойства точки в окне «Свойства точки» в поле Источник ключей администратор выбирает значения из списка: (Ключ в файле, Ключ eToken), как это показано на следующем рисунке.

3.8 Добавление, редактирование и удаление точки приема платежей

Действия с точками приема платежа производятся при активации пункта меню «Операции/ Конфигурация» на закладке «Точки».

3.8.1 Регистрация новой точки приема платежейЕсли ключи точки были созданы с помощью программы GenKey, точку необходимо зарегистрировать в Модуле платежей.

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

20

http://www.cyberplat.ru/tech/genkey/


• в меню «Операции» выбрать пункт «Операции/ Конфигурация»;

• в открывшемся окне настроек выбрать закладку «Точки»;

• в открывшемся окне нажать на кнопку «Добавить точку».

На следующем рисунке представлен вид закладки «Точки», в списке точек содержатся зарегистрированные точки приема платежей

Внимание! В данном случае мы не создаем новую точку, а заполняем данные уже созданной точки, используя следующее диалоговое окно.

21


В данном окне необходимо вести следующие данные.

1. Характеристики точки приема платежей:• «Код дилера» – код дилера (необходимо получить у администратора дилера);

• «Код точки приема» – код точки приема (необходимо получить у администратора дилера).

2. Параметры ключей:

• «Источник ключей» - при использовании электронного ключа eToken выбрать из списка «Ключ eToken», иначе выбрать «Ключ из файла» и в следующем поле прописать путь к папке ключей.

• «Путь к ключам» – указывается путь к папке ключей точки приема платежей;

• Поля «Серийный номер закр. ключа точки» и «Серийный номер откр. ключа банка» заполняются автоматически.

• «Кодовая фраза для ключа» – ввести кодовую фразу;

• «Повторите кодовую фразу» - повторить ввод кодовой фразы.

22


• Флажок «Использовать тестовый сервер» устанавливается для работы с тестовыми данными в режимах отладки и демонстрации работы Модуля платежей.

3. Реквизиты точки приема платежей:• «Название» – название точки приема платежей;

• «Адрес организации» – Адрес организации-дилера;

• «Телефон» – Телефон точки приема платежей;

• «Наименование» – Наименование организации-дилера;

• «Адрес точки» - Адрес точки приема платежей;

• «ИНН» – Идентификационный номер налогоплательщика организации-дилера.

Кнопка «Загрузить реквизиты с сервера» обеспечивает отображение в списке провайдеров только тех провайдеров, в пользу которых может принимать платежи данный дилер. Загрузка данных производится из Кабинета дилера, разрешенные для данного дилера провайдеры становятся в списке активными.

После ввода (редактирования) свойств точки приема платежей нажать кнопку «ОК» для сохранения изменений.

3.8.2 Редактирование свойств точки приема платежейДля редактирования свойств точки приема платежа необходимо выполнить следующие действия:

• выбрать нужную точку в списке точек;

• нажать кнопку «Свойства точки»;

• в появившемся окне «Свойства точки» внести необходимые изменения в параметры точки приема платежей;

• нажать кнопку «ОК» для сохранения внесенных изменений.

3.8.3 Удаление точки приема платежаДля удаления точки приема платежа необходимо выполнить следующие действия:

• выделить нужную точку в списке точек;

• нажать кнопку «Удалить точку»;

• на вопрос о подтверждении удаления ответить утвердительно.

3.9 Добавление, редактирование, удаление пользователей

3.9.1 Добавление нового пользователяДля перехода в режим управления пользователями выберите пункт меню «Операции/ Конфигурация», закладка «Пользователи».Экран имеет вид, представленный на следующем рисунке.

23


В левой части данного окна представлен список пользователей Модуля платежей, в правой части окна – кнопки, реализующие функции управления пользователями. Для регистрации нового пользователя нажмите кнопку «Новый пользователь» и заполните значения полей ввода в следующем окне.

В следующей таблице представлено описание полей, куда вводятся параметры пользователя. Пароль пользователя вводится и подтверждается в отдельном окне, которое открывается при нажатии кнопки «Задать пароль».

Название поля Описание поля Комментарий

Полное имя Фамилия, имя, отчество пользователя

Логин Имя пользователя в системе

Пароль Пароль пользователя, для ввода нажать кнопку «Задать пароль»

24


Код точки приема Код точки приема платежей

Код оператора Код оператора точки приема платежей.

Можно назначить одному оператору несколько точек приема платежей.

PIN для доступа к ККМ

Код доступа к контрольно-кассовой машине.

Администратор Флажок устанавливается, если пользователю присваиваются права администратора.

Внимание! Параметр PIN для доступа к ККМ задается обязательно для различения кассовых операций, проводимых различными операторами.

При нажатии кнопки «Задать пароль» в окне, представленном на данном рисунке, вы увидите следующий экран.

Введите пароль в поле Пароль, повторите его ввод в следующем поле, затем нажмите кнопку ОК.

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

• в окне «Настройки» на закладке «Пользователи» выбрать нужного пользователя;

• нажать на кнопку «Свойства пользователя»;

• внести необходимые изменения в параметры пользователя;

• нажать кнопку «ОК» для подтверждения внесенных изменений.

3.9.3 Удаление пользователяДля удаления пользователя необходимо выполнить следующие действия:

• в окне работы с пользователями выбрать нужного пользователя;

• нажать кнопку «Удаление пользователя».

25


3.10Настройка соединенияНастройка соединения необходима, если для соединения с Интернет используется прокси–сервер (proxy-server). Выберите в меню пункт Операции/Конфигурация и перейдите на закладку Соединение.

Установите флажок «Прокси-сервер».Укажите параметры подключения к прокси-серверу:

• тип прокси-сервера выберите из списка: (HTTP, SOCKS5);

• узел – IP-адрес прокси-сервера,

• порт – номер порта, используемый прокси-сервером;

• логин (при необходимости);

• пароль (при необходимости);

Значение поля Период обновления RSS (период обновления новостных каналов Киберплат) выбирается из списка:

• только ручное обновление – обновление по желанию администратора точки;

• раз в день (при первом запуске программы) – обновление при первом запуске программы ежедневно;

26


• периодически обновлять – обновление в соответствии с периодом, установленным в платежной системе, (переменная «ttl» в заголовке новостных каналов).

3.11 Настройка списка провайдеровДля перехода в режим настройки списка и свойств провайдеров выберите пункт меню Операции/ Конфигурация, закладка Провайдеры.На следующем рисунке представлена структура списка провайдеров.

Список провайдеров сгруппирован по видам услуг, оказываемых провайдерами.

В списке провайдеров наименования групп провайдеров и наименования провайдеров внутри группы отсортированы по алфавиту.

В верхней части списка может присутствовать группа «Часто используемые», настройка количества провайдеров в этом списке выполняется на закладке Разное, пункт меню Операции/ Конфигурация (раздел «Дополнительные настройки»).Для настройки свойств конкретного провайдера необходимо выбрать группу услуг, раскрыть группу и выбрать наименование нужного провайдера.

При выборе провайдера в правой части экрана отображаются свойства провайдера, как это представлено на следующем рисунке.

27


Поля ввода в окне Свойства провайдера имеют следующее назначение.Имя – в поле отображается наименование выбранного провайдера.Включен - установка флажка обеспечивает включение провайдера в список провайдеров, в пользу которых принимаются платежи в данной точке приема платежей.

Для оператора в списке провайдеров отображаются только включенные в список провайдеры, администратор точки видит полный список провайдеров, чтобы иметь возможность добавлять их в список.

Не печатать чек - установка флажка означает запрет печати чека.

Комиссия – окно задания комиссии для выбранного провайдера. Определение параметров данного окна приведено в разделе Настройки комиссий. Для одного провайдера ступенчатую комиссию задать нельзя, для этого надо воспользоваться закладкой Комиссии.

Профиль комиссии – выбор для данного провайдера одного из профилей, определяемых на закладке Комиссии. Способ расчета комиссии для выбранного дилера либо определяется на закладке окне Комиссия, либо определяется выбранным типовым профилем.

28


3.12Настройки комиссийДля перехода в режим настройки типовых профилей комиссий выберите пункт меню Операции/ Конфигурация, закладка Комиссии.На следующем рисунке представлен пример формирования профиля дополнительной комиссии дилера в зависимости от времени платежа.

В левой верхней части экрана находится список типовых профилей комиссий, для добавления профиля нажмите кнопку со знаком «плюс» рядом с заголовком окна. Для удаления некоторого профиля следует выделить его в списке и нажать кнопку со знаком «минус» рядом с заголовком окна.

В левой нижней части экрана находится окно Проверка профиля, в котором представлен пример расчета суммы, отправляемой провайдеру, в соответствии с выбранным профилем расчета комиссии и суммой, взимаемой с клиента. По умолчанию в окне проверки профиля сумма, взимаемая с клиента, равна 100. Вы можете изменить эту сумму.

Внимание! Проверка профиля – это расчет суммы, отправляемой провайдеру, на основе суммы, взимаемой с клиента. Обратный расчет в данном случае не рассматривается. Модуль платежей обеспечивает возможность формирования ступенчатых профилей расчета комиссии, когда значение комиссии изменяется в зависимости от времени и/или суммы платежа.

Пример. На предыдущем рисунке представлен пример определения трехступенчатого профиля, в котором способ расчета комиссии изменяется в зависимости от времени и суммы платежа. В окне Проверка профиля задано время платежа, соответствующее первой ступени профиля (в интервале времени от 00:00 до 7:00), поэтому комиссия равна 4% от суммы, взимаемой с клиента, а сумма, отправляемая провайдеру, рассчитывается по формуле:

Сумма провайдеру = Сумма клиента * (1 – 4/100) =100 * (1- 0,04) = 96.

29


Количество профилей комиссии и количество ступеней профиля практически не ограничено.По умолчанию в правой части выводится окно для заполнения одной ступени профиля, следующая ступень добавляется при нажатии кнопки со знаком «плюс» ниже и правее данного окна ввода.

Рассмотрим правила заполнения полей ввода (в правой половине экрана ввода) при определении профиля комиссии.

Имя – поле содержит наименование профиля. По умолчанию при добавлении профиля ему присваивается наименование «профиль n», где n – порядковый номер профиля. В поле Имя вы можете присвоить профилю другое имя, это имя будет отображаться в Списке профилей комиссий в левой части экрана.Условие по времени от: (до:) – нижняя (верхняя) граница временного интервала, в течение которого действует данный профиль (ступень профиля).

Условие по сумме от: (до:) – нижняя (верхняя) граница суммового интервала, в котором действует данный профиль (ступень профиля).

Значение – значение комиссии. Если в поле Формула расчета выбрана формула №1 или №2, то значение комиссии – это значение в процентах. Если в поле Формула расчета выбрана формула №3, то значение комиссии – это сумма в валюте расчетов.

Формула расчета – поле, в котором задается метод расчета комиссии путем выбора из списка:

1. сумма [/*](1- комиссия/100) – прямой метод,

2. сумма [/*](1+ комиссия/100) – обратный метод,

3. сумма [-+] комиссия – метод расчета с фиксированной суммой комиссии.

Знак арифметической операции в приведенных формулах зависит от того, какой параметр является базой расчета: сумма, взимаемая с клиента или сумма, отправляемая провайдеру. Варианты расчетов будут рассмотрены в примере ниже.

Ограничение комиссии: мин: (макс.:) – минимальная (максимальная) сумма комиссии.

Если для провайдера не определен способ расчета дополнительной комиссии, при вводе данных платежа Модуль платежей отображает одно поле для ввода суммы платежа - Сумма, взимаемая с клиента.Когда для провайдера определен способ расчета дополнительной комиссии (пункт меню Операции / Конфигурация, закладка Провайдеры), Модуль платежей отображает два поля для ввода суммы платежа: Сумма, взимаемая с клиента и Сумма, отправляемая провайдеру.Если базой для расчета комиссии является сумма, взимаемая с клиента, оператор вводит сумму, полученную от плательщика, в поле Сумма, взимаемая с клиента.

Если базой для расчета комиссии является сумма, отправляемая провайдеру, оператор рассчитывает сумму комиссии и сумму, взимаемую с клиента, на основе суммы, отправляемой провайдеру.Рассмотрим на примере расчет сумм комиссии с помощью перечисленных выше методов расчета комиссии.

Пример. Методы расчета комиссии.

30


Пусть Scl - сумма, взимаемая с клиента,Spr - сумма, отправляемая провайдеру,С% - значение дополнительной комиссии в процентах,Csum – сумма дополнительной комиссии в валюте расчетов.

В следующей таблице приведены примеры расчета по трем методам расчета комиссии в зависимости от базы расчета.

В графе № метода расчета указан номер из списка методов расчета комиссии, используемого в поле Формула расчета.

Обычным шрифтом в каждой строке напечатаны данные, которые являются исходными для расчета в данной строке.

Жирным подчеркнутым шрифтом в каждой строке выделены значения, полученные в результате расчета.

Методы расчета комиссии

№ метода расчета

База расче-та

Формула расчета Scl Spr С% Csum

1 Scl Spr = Scl * (1 - С% / 100) 200 188 6 12

1 Spr Scl = Spr / (1 - С% / 100) 200 188 6 12

2 Scl Spr = Scl / (1 + С% / 100) 200 188,68 6 11,32

2 Spr Scl = Spr * (1 + С% / 100) 199,28 188 6 11,28

3 Scl Spr = Scl - Csum 200 190 -- 10

3 Spr Scl = Spr + Csum 200 190 -- 10

3.13 Настройка печатиДля настройки параметров печати используется пункт меню Операции/ Конфигурация, закладка Печать.На следующем рисунке представлен экран настроек печати чеков при работе с Модулем платежей.

31


В начале работы с Модулем платежей в настройках печати, задайте параметры печати чека и предварительного чека (предчека). Затем проведите пробный платёж, подписанный тестовыми ключами, и убедитесь в правильности выбранных Вами настроек печати чеков.

Кассовый чек является фискальным документом, подтверждающим факт совершения платежа. Кассовый чек формируется в одном экземпляре и вручается плательщику при получении от него средств.

Выбор и настройка принтера – выбор устройства, которое будет печатать кассовые чеки, выполняется из списка, как это представлено на следующем рисунке.

В представленном списке:

• Atol KKM – контрольно-кассовая машина (ККМ) фирмы «АТОЛ»,

• Shtrih KKM – ККМ фирмы «Штрих-М». Модулем платежей поддерживается печать чеков на ККМ, изготавливаемых фирмами «АТОЛ» и «Штрих-М»;

32


• UNS –SP1, GPILOT GP 58 mm - модели термопринтеров, печать чеков на которых поддерживается Модулем платежей. Работа с этими принтерами не предполагает фискального режима;

• Принтер – печать чеков выполняется на одном из принтеров, на которых возможна печать с компьютера оператора.

При нажатии на кнопку Настройка принтера вы увидите следующее окно печати.

С помощью средств, представленных в данном окне, выполняется подготовка к печати. При нажатии кнопки Настройка вы попадете в окно настройки печати операционной системы MS Windows. Если в списке принтеров нет нужного вам принтера, воспользуйтесь кнопкой Найти принтер и добавьте необходимый принтер.

Номер секции – номер секции магазина, при отсутствии секций значение номера секции равно 1.

Логический номер устройства – при установке на компьютере драйвера ККМ номер устройства определяется настройками драйвера.

Рассмотрим настройки окна Опции, которые определяют возможности печати чеков при работе с Модулем платежей.

Печатать чек – флажок устанавливается, если чек нужно печатать.

Если на закладке Провайдеры для конкретного провайдера установлен флажок Не печатать чек, то для этого провайдера чек не будет печататься, даже если на закладке Печать флажок Печатать чек установлен. Печатать предварительный чек - флажок устанавливается, если нужно печатать предварительный чек.

Предчек после проверки – предчек распечатывается после проверки номера

33


Разрешить повторную печать - флажок устанавливается, если разрешена повторная печать чека.

Печатать только PIN-чеки - флажок устанавливается, когда с помощью Модуля платежей выполняется только продажа PIN-кодов и печатаются только PIN-чеки.

В поле В начале чека вводится текст, который необходимо печатать в начале чека.

В поле В конце чека вводится текст, который необходимо печатать в конце чека.

Для печати чека установите флажок Печатать чек.

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

Для печати предчека установите флажок Печатать чек, а затем – флажок Печатать предварительный чек. При выборе таких опций предчек распечатывается стразу после отправки запроса на проверку номера, (т.е. до получения от Провайдера разрешения на платёж).

Если дополнительно установить флажок Предчек после проверки, предчек будет распечатываться только после получения от Провайдера разрешения на платёж.

3.14Настройка проверокДля настройки параметров проверки используется пункт меню Операции/ Конфигурация, закладка Проверки. Оператору точки предоставляются дополнительные возможности проверки правильности вводимых данных.

Вид экрана настройки проверок представлен на следующем рисунке.

Проверять время работы точки приема – флажок устанавливается, если точка приема платежей не работает круглосуточно и выполняется проверка времени, когда разрешено проведение платежей.

34


В полях ввода «С» «по» вводятся значения времени начала и конца проверяемого временного интервала.

Включение кнопки Разрешить работу означает, что временной интервал определяет начало и конец работы точки.

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

Включение одной из кнопок вызывает отключение другой кнопки.

В приведенном на предыдущем рисунке примере работа точки запрещена с 22:00 до 7:00.Все платежи, принимаемые в нерабочее время, автоматически регистрируются как отложенные, такие платежи можно провести в следующую смену или заблокировать. При приёме платежа в нерабочее время оператору точки выдаётся предупреждение о невозможности приёма платежа.

Суточный лимит – сумма, ограничивающая общую сумму платежей в данной точке приема за сутки. Все платежи, принимаемые сверх заданной суммы в течение суток, автоматически регистрируются как отложенные. При этом оператору точки выдаётся уведомление о превышении предельной суммы платежей за сутки.

Предупреждение о превышении размера платежа – флажок устанавливается для проверки максимальной суммы единичного платежа. При регистрации крупных платежей программа выдаст предупреждение оператору точки с тем, чтобы тот обратил особое внимание на сумму платежа и удостоверился в правильности введённой суммы.

Жесткий лимит - флажок устанавливается, если запрещается проводить платежи с суммой, превышающей максимальный размер платежа.

Проверять повторные номера - флажок устанавливается, если проверяется номер телефона/счета на повторение в течение периода, указанного в поле ввода ниже заголовка.

Длительность периода, за который производится проверка повторных номеров, вводится в сутках. Предупреждение о возможном вводе дублирующего платежа в течение указанного периода выдаётся оператору для исключения возможности повторного ввода данных уже отправленного платежа. Повторные платежи не блокируются.

3.15 Дополнительные настройкиДля задания дополнительных настроек необходимо перейти на вкладку Разное меню Операции/ Конфигурация. Используемый в данном случае экран представлен на следующем рисунке.

35


На закладке «Разное» представлены следующие дополнительные настройки Модуля платежей. Информировать об успешной проверке номера - если установлен этот флажок, программа будет выдавать Оператору сообщение с подтверждением успешной проверки номера.

Автоматически отображать остаток суммы на счете – при установке данного флажка при проведении платежей в правом нижнем углу экрана отображается остаток суммы на счете дилера.

Язык интерфейса - в данный момент возможен выбор из двух языков интерфейса: русский или английский. Для выбора необходимо выбрать из выпадающего меню нужный язык.

Длина списка «Часто используемые» - количество провайдеров, отображаемых в группе «Часто используемые» в верхней части списка дилеров. Частота использования наименований провайдеров определяется на основе анализа статистики всех платежей локальной базы данных, находящейся на компьютере оператора.

Для применения назначенной настройки нажмите клавишу «ОК». Значение параметра примет выбранное значение без перезагрузки Модуля платежей.

3.16Обновления программы «Модуль платежей»Для осуществления ежедневной проверки обновлений необходимо в меню программы «Операции/ Настройки» вкладка «Разное» поставить флажок «Проверять обновления раз в день», тогда при запуске программы ежедневно будет осуществляться проверка обновлений.

Также проверить наличие обновлений можно, выбрав в меню «Помощь -> Проверка обновлений».

Если обновление не требуется, то в нижнем правом углу программы появляется следующее сообщение:

Существует 2 вида обновления программы:

1.Инкрементальное - обычно обновляется только список провайдеров (operators.xml).

Если при запуске были обнаружены обновления файлов программы, то появится следующее сообщение:

При нажатии на кнопку «Подробнее» можно просмотреть перечень обновлений.

При нажатии на кнопку «Да» происходит скачивание обновлений с сайта компании.

36


2.Кумулятивное - обновляется целиком дистрибутив (exe-файл и все модули).

В случае если программой обнаружена на сервере новая версия ПО «Модуль платежей», то пользователю предлагается автоматически скачать и установить новую версию:

После нажатия кнопки «Да», программа скачивает дистрибутив и автоматически запускает инсталлятор в режиме обновления.

После установки, автоматически перезагружается Модуль платежей и пользователю предлагается ввести логин и пароль.

37


4 Структуры данных

4.1 Форматы файлов ключейРассмотрим структуру открытого и закрытого ключей, применяемых для доступа в Модуль платежей.

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

Во второй секции ключа между словами «BEGIN» и «END» приводится собственно PGP-совместимый ключ.

В третьей секции ключа между словами «BEGIN SIGNATURE» и «END SIGNATURE» содержится электронная цифровая подпись ключа. В закрытом ключе (файл «secret.key») точки приема платежей электронная цифровая подпись ключа может не проставляться.

Далее представлен формат ключей на примере файла pubkeys.key, в котором содержится две части: открытый ключ точки приема и открытый ключ КиберПлат.

Формат данных файла pubkeys.keyОткрытый ключ точки приема0000040801NS000001470000010000000125api17032 00017033api17032 00017033BEGINmQBRAwAAQok95z4+AAABAgDrzoyI24MItz/UdYrV7as4xrjhjpYqBG3Owb7dP1pEp6Dz4MLJkdWzm+ccjy3pTmjgvqfnaAnRyID4nrwQ9+p9AAURsAGHtAhhcGkxNzAzMrABAw===5jFdENDBEGIN SIGNATUREiQBRAwkQAABCiT3nPj4BaaxXAgDT6bfpnp513156n2O4H5nyp7LyH6jaR6NrOi1/x3Bm+/rzl0mfBFMC8LTVF2ukQ4gX6meCwK+ZaFFdT8UJXVVUsAHH=fOzHEND SIGNATUREОткрытый ключ КиберПлат0000040401NS0000014300000098000001250J0005 00064182api17032 00017033BEGINmQBRAwAA+rY8quyyAAABAgDb8iYDU760T8phaS1KFW4wj0cSROQ2dJzkJN5X64y0azNAmCCyM9KzGU3M400isSEU+LddQG+HE/hbRsntAURTAAURsAGHtAYwSjAwMDWwAQM=

38


=HcgRENDBEGIN SIGNATUREiQBRAwkQAABCiT3nPnEBAeYFAgCJWP1AnPJ46UrJny81UCv5EVMyaocqBRCbQW9S8bxvV/uixVcWwimyrGv8/aNc9bTeX9TacEELashrOTfXTUSIsAHH=S9Y8END SIGNATURE

Рассмотрим структуру данных открытого ключа.

Во второй строке открытого ключа точки задаётся номер точки и номер закрытого ключа точки. В представленном выше примере вторая строка открытого ключа точки:

api17032 00017033

В этой строке:

• api – тип точки приёма платежей, к этому типу относятся точки, использующие Модуль платежей;

• 17032 –номер точки приема;

• 00017033 - номер закрытого (секретного) ключа точки.

Номер открытого ключа КиберПлат (его также иногда называют «банковским ключом») указывается во второй строке открытого ключа КиберПлат. В представленном выше примере вторая строка открытого ключа КиберПлат

0J0005 00064182

Строка с номером открытого ключа КиберПлат всегда должна начинаться с 0J0005. В приведённом примере серийный номер открытого банковского ключа 00064182. Обычно все номера ключей указываются без первых нулей, если таковые есть.

4.2 База данных платежейМодуль платежей сохраняет информацию о принятых платежах в базе данных формата SQLite (Ознакомиться с эти продуктом можно на сайте http :// sqlite . org ).

Имя файла базы данных pmodule.db3. Исполняемый файл Модуля платежей имеет имя pmodule.exe.

Способ размещения файла базы данных указывается при установке Модуля платежей на компьютер. Способ размещения выбирается из списка:

1. для всех пользователей – установка в папку C:/Documents and Settings/ All Users/ Application Data/ cyberplat/ pmodule.

2. для конкретного пользователя - C:/Documents and Settings/<имя пользователя>/ Application Data/ cyberplat/ pmodule.

3. в папке с программой– этот вариант не рекомендуется использовать. Однако, это возможно сделать для версий операционной системы Windows для версий Windows ХР и ниже. Для операционных систем Windows 7 и Windows Vista такой вариант установки невозможен.

39

http://sqlite.org/


Указанные файлы по умолчанию устанавливаются в папку

C:\Documents and Settings\All Users\Application Data\cyberplat\pmodule.

База данных платежей закрыта паролем. Для того чтобы узнать пароль к Вашей базе данных, свяжитесь со службой технической поддержки КиберПлат.

4.3 Формат списка платежей для импорта в программуИмпорт платежей – вспомогательная функция, облегчающая проведение большого количества платежей в фоновом режиме. Для импорта списка платежей выберите пункт меню «Операции / Импортирование платежей».

При импорте платежей программа загружает список платежей из текстового файла формата (*.csv), такой файл обычно создается с помощью MS Excel. Всем импортированным платежам присваивает статус «отложенный». Далее, как обычно, отложенные платежи можно провести в фоновом режиме с помощью активации пункта меню «Операции / Провести все отложенные».

Рассмотрим структуру текстового файла, подготавливаемого для импорта платежей.

Первая строка импортируемого файла – заголовок списка. В нём задаются названия полей списка в порядке их следования. Названия полей в заголовке разделяются точкой с запятой; в конце строки заголовка точка с запятой не ставится.

Структура заголовка текстового файла:

• список имен импортируемых полей, разделенных точками с запятой;

• в конце строки точка с запятой не ставится.

Далее под строкой заголовка может располагаться любое количество строк списка платежей:

Структура списка платежей:• каждая строка списка содержит информацию об одном платеже;

• поля данных в строке платежа также разделяются точками с запятой;

• данные, имеющие тип «строка», (см. ниже таблицу «Структура импортируемого файла»), должны обязательно заключаться в одинарные кавычки, например: '8888888888' или 'This is a comment';

• вместо незаполненного поля ставится точка с запятой, «пропускать» можно только строковые поля;

• в конце строки данных точка с запятой не ставится.

Пример пакетного файла для импорта платежей:

op_num;phone;amount;dop_kom;account;comment;point_id;user_id

2;'8888888888';2.7;3.0;;;17032;17034

3;'7777777777';1;1.1;;'comment';17032;17034

15;'9066691328';30;30;;;17032;17034

Успешно импортированные платежи отображаются в списке текущих платежей со статусом «отложенный».

40


Если в импортируемом файле (.csv) отсутствуют поля Point_id и User_id, то используются номер точки и номер пользователя, импортирующего платежи.

ВНИМАНИЕ! При успешном импорте платежей программа выводит количество успешно импортированных платежей.

Если было импортировано 0 платежей, то программа не выдает никаких сообщений, что является признаком неуспешного импорта.

Структура импортируемого файла

Поле Тип Значение

op_num целое число Номер оператора

phone строка Номер телефона абонента (если есть), номер телефона вводится без пробелов, скобок и пр.

amount дробное число Сумма, зачисляемая на счет абонента с двумя знаками после запятой. Пример: 210.00

dop_kom дробное число Сумма, взимаемая с абонента (если комиссия 0%, то Dop_kom=Amount ) (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

account строка Номер счета абонента. (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

comment строка

Комментарий к платежу. Если поле содержит символы кириллицы, то они должны быть представлены в формате Windows 1251. НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ

Point_id целое число Код точки (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

User_id целое число Код оператора (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

41


Структура импортируемого файла

Поле Тип Значение

op_num целое число Номер оператора

phone строка Номер телефона абонента (если есть), номер телефона вводится без пробелов, скобок и пр.

amount число c фикс.точкой

Сумма, зачисляемая на счет абонента с двумя знаками после запятой. Пример: 210.00

dop_kom число c фикс.точкой

Сумма, взимаемая с абонента (если комиссия 0%, то Dop_kom=Amount ) (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

account строка Номер счета абонента. (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

comment строкаКомментарий к платежу. Если поле содержит кириллицу, то кириллица должна быть представлена в формате Windows 1251. (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

Point_id целое число Код точки (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

User_id целое число Код оператора (НЕОБЯЗАТЕЛЬНОЕ ПОЛЕ)

4.4 Структура запросов на платежДля разработчиков ПО, которое должно работать совместно с Модулем платежей, структура запроса на платёж разъясняется в сопроводительной документации к исходным текстам клиентских программных модулей, которые КиберПлат предоставляет всем разработчикам (смотрите на сайте Киберплат на странице «Технологии» «Материалы для разработчиков ПО», Протоколы взаимодействия.)

Дополнительно – смотрите перечень параметров и форматы данных по каждому из Провайдеров.

4.5 Форматы платежей провайдеровПри выборе пункта меню Помощь/ Форматы платежей пользователь попадает на сайт Киберплат по адресу https://service2.cyberplat.ru/cgi-bin/view_stat.utf/help.cgi, где можно получить информацию о провайдерах, в пользу которых осуществляются платежи в платежной системе Киберплат.

В списке провайдеров при нажатии символа «+» рядом с названием провайдера пользователь увидит следующий перечень параметров, относящихся к данному провайдеру.

<Наименование организации-провайдера>Описание запроса Передаются следующие поля:

1) Код дилера (SD)

2) Код точки приема (AP)

3) Код оператора (OP)

4) Номер сессии(SESSION): 20 цифр, не должен повторяться

42

https://service2.cyberplat.ru/cgi-bin/view_stat.utf/help.cgi

https://service.cyberplat.ru/cgi-bin/view_stat.utf/help.cgi

https://service.cyberplat.ru/cgi-bin/view_stat.utf/help.cgi


http://www.cyberplat.ru/tech/


5) Комментарий к платежу (COMMENT): не более 64 символов*

6) Номер телефона (NUMBER): 11 цифр

7) Сумма с клиента (AMOUNT_ALL) *

8) Сумма оператору (AMOUNT)

Пример запроса SD=17031AP=17032OP=17034SESSION=20040929155530125121NUMBER=37253190839AMOUNT=100AMOUNT_ALL=100COMMENT=

Обязательные параметры:

сумма, номер

Сумма от 100 до 12000

АдресаПроверка номера: https://service.cyberplat.ru/cgi-

bin/ge/ge_pay_check.cgi/325

Проведение платежа:

https://service.cyberplat.ru/cgi-bin/ge/ge_pay.cgi/325

Проверка статуса платежа:

https://service.cyberplat.ru/cgi-bin/ge/ge_pay_status.cgi

Служба поддержки клиентов:

88001001221

Название организации: <Наименование провайдера>. Номер договора: <№ договора> от

<Дата договора>Сайт: <Адрес сайта провайдера>Номер шлюза: 325ИНН: <ИНН провайдера>

Информация из разделов таблицы «Описание запроса», «Пример запроса», «Обязательные параметры» необходима для разработчиков собственного программного обеспечения дилеров.

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

43


5 Справочные материалы

5.1 Подключение ККМ к компьютеру и настройка драйвера ККМ

5.1.1 Общие рекомендации по настройке драйверов ККМПеред началом установки ККМ (или фискального регистратора) обязательно ознакомьтесь с руководством по установке. Методики настройки драйвера различаются в зависимости от типа ККМ и изготовителя драйвера.

Общие рекомендации по настройке.• Подключите ККМ к Вашему компьютеру, установите драйвер ККМ и проверьте

связь драйвера с ККМ.

• Запустите программу «Тест драйвера», устанавливаемую вместе с драйвером ККМ. Нажмите кнопку «Настройка свойств», а затем – «Проверка связи».

• Если устройство работает правильно – в поле результатов проверки (или «код ошибки») будут отображены данные Вашего устройства для печати чеков, например:

Код ошибки: ШТРИХ-ФР-К №25792• При ошибке соединения в поле «код ошибки» будет отображаться сообщение об

ошибке связи, например:

Код ошибки: -1: Нет связи• Закройте окно программы «Тест драйвера».

5.1.2 Настройка драйвера фискального регистратора «Штрих-ФР-К»Если Модуль платежей должен работать с фискальным регистратором (ККМ) «Штрих-ФР-К», необходимо установить драйвер ККМ на компьютер оператора. Драйвер и инструкция по его инсталляции поставляются производителем ККМ.

(ВНИМАНИЕ! Версия драйвера должна быть не ниже 4.6.2.250)

Для проверки работоспособности Штрих-ФР-К следует произвести следующие операции:

выбрать меню «Пуск / Программы / Штрих-М / Драйвер ФР-А4 / Тест драйвера».

44


В открывшемся окне программы «Тест драйвера ФР» нажмите кнопку «Настройка свойств», а затем – кнопку «Проверка связи» окна «Свойства».

При успешной проверке связи в поле «Код ошибки» будет отображён тип подключённого устройства и его номер, в нашем примере это «Штрих-ФР-К № 25792».

При настройке печати чеков на фискальном регистраторе «Штрих-ФР-К» в некоторых случаях необходимо правильно задавать согласованные значения параметров этого устройства. Поэтому при возникновении вопросов, связанных с печатью на «Штрих-ФР-К», рекомендуется до обращения в сервисную службу КиберПлат задать представленный далее в таблице вариант согласованных настроек драйвера, а затем – распечатать чек из Модуля платежей.

Откройте Таблицу настроек драйвера «Штрих-ФР-К» и выставьте указанные в таблице значения параметров. После этого проведите пробный платёж и распечатайте чек из Модуля платежей.

Согласованные параметры настроек драйвера «Штрих-ФР-К»

Поле Название Значение

1 Номер ККМ в магазине 1

2 Авт. обнуление денежной наличности 0

45


3 Печать текстовых строк 0

4 Печать рекламного текста 0

5 Печать остатков фп в отчете 0

6 Печать необнуляемой суммы 1

7 Работа с денежным ящиком 1

8 Отрезка чека после завершения печати 0

9 Печатать дробное в количестве 0

10 Лог. уровень датчика денежного ящика 0

11 Лог. уровень 5в денежного ящика 0

12 Длительность имп. откр. денежного ящика 10

13 Длительность паузы денежного ящика 1

14 Количество имп. денежного ящика 1

15 Использование весовых датчиков 0

16 Яркость печати 2

17 Начисление налогов 0

18 Автоматический перевод времени 0

19 Печать налогов 0

20 Печать заголовка чека 0

21 Печать единичного количества 0

22 Сохранять строки в буфере чека 0

23 Печать чека по закрытию 0

24 Печать инн и № ккм на ленте опер.журнала 0

25 Промотка ленты перед отрезкой 0

26 Отрезка при открытом чеке 0

27 Запрет нулевого чека 0

28 Скорость печати 1

29 Отступ в строке типов оплаты 1

30 Сохранение графических объектов в чеке 0

31 Сжатие шрифта на ленте опер. Журнала 0

32 Сжатие шрифта на чековой ленте 0

33 Использование форматирования в чеке 0

34 Обнуление счетчика чеков 0

35 Контроль часов 0

36 Печать только на чековой ленте 0

37 Отключение звука при ошибках 0

46


38 Автозагрузка 1

39 Игнорировать ошибки формата чека 0

40 Сокращенный отчет с гашением 0

41 Пороговое значение напряжения питания 192

42 Отладочная информация обмена с эклз 0

5.2 Виды ошибок Модуля платежейВ следующей таблице приведены виды ошибок, наиболее часто возникающие при работе с Модулем платежей. При возникновении ошибок с другими кодами (Код ошибки >50) обращайтесь в службу поддержки Киберплат.

Код Описание ошибки Действие пользователя

1 Сессия с таким номером уже существует

Заблокируйте или проведите заново.

2 Неверный код дилера Проверьте настройки. Заблокируйте или проведите заново.

3 Неверный код точки приема Проверьте настройки. Заблокируйте или проведите заново.

4 Неверный код оператора Проверьте настройки. Заблокируйте или проведите заново.

5 Неверный формат кода сессии Проверьте настройки. Заблокируйте или проведите заново.

6 Неверная ЭЦП Проверьте настройки. Заблокируйте или проведите заново.

7 Неверный формат суммы или значение суммы вне допустимого диапазона

Проверьте настройки. Заблокируйте или проведите заново.

8 Неверный формат номера телефона Проверьте настройки. Заблокируйте или проведите заново.

9 Неверный формат номера лицевого счета


10 Неверный формат запроса Проверьте настройки. Заблокируйте или проведите заново.

11 Сессия с таким номером не существует


12 Запрос сделан с незарегистрированного IP


15 Платежи данному оператору не поддерживаются системой


47



16 Не найдена точка приема. Точка приема не зарегистрирована в системе


17 Номер телефона не соответствует введенному ранее


18 Сумма платежа не соответствует введенной ранее


19 Номер счета (контракта) не соответствует введенному ранее


20 Платеж находится в состоянии завершения

Платеж в промежуточном состоянии. Проверьте состояние платежа через 1 минуту.

21 Не хватает средств на счете дилера для проведения платежа

Проверьте остаток средств на счете Вашей организации. Заблокируйте платёж или проведите платёж заново. Сообщите о недостатке средств на счёте администратору Вашей дилерской сети.

22 Платеж не принят. Ошибка при переводе средств


23 Неверный номер телефона/счета. Ответ от Провайдера: «Прием платежа невозможен»


24 Невозможно связаться с сервером провайдера или технологический перерыв КиберПлат


25 Работа шлюза приостановлена Свяжитесь с администратором Вашей дилерской сети.

26 Работа дилера приостановлена Свяжитесь с администратором Вашей дилерской сети.

27 Операции по счету приостановлены Свяжитесь с администратором Вашей дилерской сети.

30 Общая ошибка системы (CyberPlat) Свяжитесь с администратором Вашей дилерской сети.

31 Превышено кол-во одновременно обрабатываемых запросов (CyberPlat)

Проверьте состояние платежа. Проверьте наличие платежа в статистике на сайте service.cyberplat.ru

32 Платеж с этими данными уже был принят к обработке за последний час

Платеж с такими же параметрами уже был, проверьте в статистике на сайте service.cyberplat.ru

33 Превышен максимальный интервал между проверкой номера и платежом (24 часа)

Проверьте состояние платежа. Если платеж не прошел, проведите заново.

48



34 Платеж с таким номером не найден Заблокируйте или проведите заново на правильный номер.

35 Ошибка при изменении состояния платежа

Возможно, прошел. Проверьте в статистике на сайте service.cyberplat.ru

36 Неверный статус платежа Возможно, прошел. Проверьте в статистике на сайте service.cyberplat.ru

37 Попытка обращения в шлюз, отличный от шлюза на предыдущем шаге


38 Неверная дата. Возможно, срок действия платежа истек

Возможно, прошел. Проверьте в статистике на сайте service.cyberplat.ru

39 Неверный счет Свяжитесь с администратором Вашей дилерской сети.

40 Карта указанного номинала в системе не зарегистрирована

Уточните реквизиты платежа. Заблокируйте или проведите заново.

41 Ошибка добавления данных платежа в базу данных

Свяжитесь с администратором Вашей дилерской сети.

42 Ошибка при сохранении чека в базе данных


43 Сеанс Вашей работы в системе недействителен (возможно, истек срок действия сессии), попробуйте войти заново

Проверьте настройки. Проверить статус платежа в статистике на сайте service.cyberplat.ru

44 Клиент не может работать на этом Торговом Сервере.


45 Отсутствуют права доступа в данный раздел

Ваша организация не имеет права принимать платежи в пользу данного Провайдера. Платёж не прошёл. Свяжитесь с администратором Вашей дилерской сети.

46 Не удалось завершить ошибочный платеж

Проверьте статус платежа. Заблокируйте или проведите заново.

47 Сработало временное ограничение прав

Свяжитесь с администратором Вашей дилерской сети.

48 Ошибка при сохранении данных сессии в базе данных

Проверьте статус платежа. Если платёж ошибочный, заблокируйте или проведите заново.

50 Проведение платежей в системе временно невозможно


49