config.ini - общие настройки

Статья содержит не все параметры, но регулярно пополняется!

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

Файл config.ini является стандартным ini-файлом, поэтому к нему применимы общепризнанные требования для данного формата.

Ниже в главах будут описаны секции config.ini.

Секции заключены в квадратные скобки (например, [common]). Параметры секции могут быть указаны в любом месте, после названия секции и до объявления другой секции (хоть в начале, хоть в конце, хоть в середине). Регистр названия секции и названия параметров значение не имеет ([common] и [CoMMoN] развнозначны).

Если параметра или секции не существует в ini-файле, то ПО использует стандартное значение по умолчанию.

[сommon]

Содержит преимущественно общие параметры работы ПО.

Название параметра Тип Стандартно Описание
CanSecond8 Бит 0 Разрешить вводить 2 «восьмерки». Необходимо для ввода кодов городов начинающихся с 8 (например, код Санкт-Петербурга 812).
Defproviderfull Бит 0 Автоопределение провайдера только по полному номеру.
OnlyOwnProviders Бит 0 Разрешить работать без ключей к платежным системам, только с собственными провайдерами.
InputSummaFromKeyboard Бит 0 Разрешить ввод суммы с клавиатуры.
BlockIsNoMoney Бит 0 Блокировать терминал если во всех ПС сумма меньше минимальной.
Show_SummToPay Бит 1 Показывать на экране сумму к зачислению при оплате.
MaxRestartPay Число 1000 Проведение незавершённого платежа в случае экстренной (аппаратной) перезагрузки терминала (например, сбой питания). Параметр задает максимальную сумму платежа (руб). Значение 0 отключает функцию.
Show_PayTimer Бит 1 Показывать таймер возврата ПО в основное меню (таймер начинает отображаться через 60 секунд бездействия пользователя).
ViewType Бит 0 Режим внешнего вида ПО. Какая форма отображается при старте ПО и после оплаты.
0. Главной формой считается ввод номера с автоматическим определением операторов. Другие услуги отображаются по нажатию кнопки «Оплата других услуг».
1. Главной формой считается форма с кнопками провайдеров и групп провайдеров.
2 .Главной формой считается форма предустановленного провайдера, определенного параметром [Common]ViewType
PinPadUsed Бит 0 Режим работе с PinPad клавиатурой. Виртуальные клавиши реагируют на нажатие физических клавиш. Ввод денежных сумм с клавиатуры запрещен. Подробнее настраиваем_для_работы_с_pinpad.
ConfigClose Число 0 Значение 1 устанавливается, когда в Конфигураторе была нажата кнопка «Сохранить» и он был закрыт. Является признаком того, что какие-либо параметры могли быть изменены в Конфигураторе. Сейчас не используется в ПО.
RestartAfterSec Целое 2700 интервал перезагрузки в секундах в случае отсутсвия связи с PayPRO
RestartHardware Бит 0 1 - Перезагрузать терминал полностью при отсвутсии связи, 0 - только ПО. При 2 - терминал блокируется до тех пор пока связь не восстановится, разблокируется автоматически
CancelVisibleTimerInterval Целое 35 Время в секундах по истечению которого появится кнопка «ОТМЕНА».
ProvidersFormPath Строка img\keyboards\SelectForm_{SKIN_NAME}.ini Файл настроек отображения формы выбора провайдеров.
{SKIN_NAME} - заменяется на имя скина.
Если файл не найден то проверяется наличие файлов: img\keyboards\SelectForm_pinpad.ini (если мини-скин), img\keyboards\SelectForm.ini, img\keyboards\ProvidersForm.ini
OddFormPath Строка img\keyboards\SelectForm_odd_{SKIN_NAME}.ini
img\keyboards\FormInput_odd.ini (если задан ProvidersFormPath)
Форма сдачи.
{SKIN_NAME} - заменяется на имя скина.
Если файл не найден то проверяется наличие файлов: img\keyboards\SelectForm_odd_pinpad.ini (если ширина скина < 1280) , img\keyboards\SelectForm_odd.ini, img\keyboards\ProvidersForm_odd.ini
ShowFormOdd Бит 1 Показывать форму сдачи
HandUpIntervalMin Целое 0 Интервал разрыва модемного интернет соединения в минутах
RunAfterPayFromReg строка Запустить приложение из реестра после платежа. Например, параметр HKEY_LOCAL_MACHINE\SOFTWARE\PayPRO\Start
AntiBounceЦелое 50 Интервал в миллисекундах срабатывания функции «Антидребезг» при наборе номера. Значение 0 отключает функцию.
ReturnsIntervalЦелое60Время в секундах перехода на главную форму при бездействии
ShowReturnsIntervalЦелое30Время в секундах показа таймера перехода на главную форму при бездействии
MainProviderЦелое0Номер предустановленного провайдера (0 - выкл.), параметр необходим для [Common]ViewType=2
IntervalToCancelOfRemainingBalanceЦелое60Таймер бездействия на форме сдачи
AutoPayIdleЦелое1 При введенном полном номере: по AutoPayIdle=1 переход к форме оплаты по таймеру бездействия, при равном нулю переходит к главной форме

[Processes]

Управление и слежение за процессами

Название параметра Тип Стандартно Описание Версия
SendToMonitoring Бит 1 передавать ли информацию о процессах
SaveToLog Бит 1 записывать ли в лог информацию о процессах
SaveToLogInterval Целое 6 * 60 Время в секундах между записью информации о процессах
SpyNew Бит 1 включить поток, следящий за появлением новых потоков
WatchDog Целое 1 включить процесс следящий за появлением или исчезновением процесса основной программы

[платёжная система]

В данном разделе под [платежная система] подразумевается именная секция каждой платежной системы, например, [EPort], [CyberPlat], [OSMP], [PinPay], [QIWI], [DeltaPay], [RegulPay], [Rapida] и т.д.

Название параметра Тип Стандартно Описание Версия
BalanceRefreshSec Целое 1200 Время в секундах между опросами баланса при успешном ответе
BalanceRefreshOnErrorSec Целое 2700 Время в секундах между опросами баланса после ошибки
BalanceRefreshOnNotConnectSec Целое 120 Время в секундах между опросами баланса если нет связи
SendAllSum Бит 0 0. В качестве общей суммы для ПС отправлять сумму за вычетом комиссии. {SUMMA_PROC}={SUMMA_}
1. В качестве принятой суммы для ПС отправлять честно всю сумму, вносимую плательщиком. {SUMMA_PROC}={SUMMA}
Mode Строка пусто Режим ПС, заменяет текст {MODE_PS} в шаблонах пакетов.
В OSMP для точки XML по умолчанию равен Dealer v2,
для точки типа «Автомат самообслуживания» нужно установить этот параметр в другое значение (support@paypro.ru).

Удаленно значение можно установить с помощью спец.команды:
INIQuery=[OSMP]Mode=ваше_значение
и команды не перезагрузку ПО:
ExitWindows=3
3.2.18.9
Enabled Бит 0 Включение/Отключение процессинга
TryCountMax Целое 0 Количество перепроведений отклонённых платежей
LimitBreak Целое 0 Cумма, после которой терминал показывает задержку платежа
RestartAfterSec Целое 2700 интервал перезагрузки в секундах в случае отсутсвия связи с ПС
Profile Целое 0 Номер профиля, Профили платёжных систем
NameLocal Строка название ПС на кирилице
BankName Строка Наименоавние банка ПС
BankBik Строка Бик Банка ПС
ProcessTel Строка Телефон ПС
Server Строка IP-Адрес или имя сервера например 62.231.13.160 или service.cyberplat.ru
Manual Бит 0 Ручной режим работы ПС
Monitoring Бит 0 Присылать все платежи 1 раз (только для PayPRO c версии 4.3)
PayIfLittleMoney Бит 0 Отправлять платеж если недостаточно средств на балансе

—-

Пример 1:

Для КиберПлат опрос баланса раз в сутки:

[CyberPlat]
BalanceRefreshSec=86400
BalanceRefreshOnErrorSec=86400

спецкоманды:

INIQuery=[CyberPlat]BalanceRefreshSec=86400
INIQuery=[CyberPlat]BalanceRefreshOnErrorSec=86400

Пример 2:

Для ПС РегулПэй опрос баланса через 15 минут, а в случае ошибки опросить через 5 минут:

[RegulPay]
BalanceRefreshSec=900
BalanceRefreshOnErrorSec=300

спецкоманды:

INIQuery=[RegulPay]BalanceRefreshSec=900
INIQuery=[RegulPay]BalanceRefreshOnErrorSec=300

[Action1] и [Action2]

Бонусы, акции

Название параметра Тип Стандартно Описание
EnabledБит0 0 - выключить акцию.
1 - включить акцию.
TodayReceiptsЧисло10000Расчетный объем выручки в руб.
NPresents1-8Число0Количество бонусов (не более), штук.
(NPresents1 соответствует 5 руб; NPresents8 соответствует 1000 руб.)
ConfirmTimeЧисло10Время подтверждения, сек.
BeginTimeЧисло0Время начала акции.
EndTimeЧисло86400Время окончания акции.
MethodЧисло11 - Метод 1 (адаптивный).
2 - Метод 2 (равномерный)
MinPayЧисло0Минимальное значение диапазона суммы платежа.
MaxPayЧисло15000Максимальное значение диапазона суммы платежа.
ProfitLowЧисло0Условие прибыльности:
0 - отключено.
1 - Выдать бонус, только если он больше комиссии.
2 - Выдать бонус, только если он меньше комиссии.

Пример:

Включить акцию 1 на время с 8:00 до 20:00.

[Action1]
Enabled=1
...
BeginTime=28800
EndTime=72000

спецкоманды:

INIQuery=[Action1]Enabled=1
INIQuery=[Action1]BeginTime=28800
INIQuery=[Action1]EndTime=72000

Время используется в секундах: 8ч.=8*60*60сек=28800сек.

[printer]

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

Тип «dndyny»

0 = defno - нет (по умолчанию)
1 = defyes - да (по умолчанию)
2 = no - нет (всегда)
3 = yes - да (всегда)
Название параметра Тип Стандартно Описание
PrintReceipt dndyny 1 печать чек
PrintReceiptAsk dndyny 0 Показать диалог «печать чек?»
PrintReceiptAskWait Целое 10 время ожидания в диалоге «печатать чек?», если выбор не сделан то печать чека зависит от параметра PrintReceipt
PrinterType - - -
COM - - -
Speed - - -
PrintTime целое 1 Пауза после печати чека в секундах, отображается обратный отсчет
PrinterRollSizeOut - - -
PrinterRollSizeIn - - -
PrinterCheckLength - - -
PrintCheckSpacers - - -
NomSpacer - - -
PrintBonusCheck - - -
NeedAnToAs - - -
StringsBeforeCut - - -
MinStringsCount - - -
PrintCheckPause - - -
PrintBonusCheckPause - - -
Password_KKM - - -
Fiscal - - -
BlockIfError - - -
DivideToSections - - -
FontSize - - -
SubType - - -
IfNeedZ - - -
FullName - - -
Name - - -
Version - - -
Password_PayMaster - - -
Password_SysManager - - -

Настройки печати чека (PrintReceipt, PrintReceiptAsk, PrintReceiptWait)

Параметр PrintReceipt дает возможность настраивать печать чека при проведении всех платежей (всегда печатать или всегда не печатать). Параметр PrintReceiptAsk=1 включает функцию, позволяющую пользователю при оплате самому выбирать распечатывать чек для конкретного платежа или нет. Причем если пользователь не совершает никаких действий, то по завершению X времени чек автоматически распечатывается или не распечатывается (зависит от значения параметра PrintReceipt). Время печати X зависит от параметра PrintReceiptWait (по умолчанию 10сек).

Для каждого провайдера можно индивидуально настроить параметры PrintReceipt и PrintReceiptAsk. Для этого в Providers_user.ini нужно добавить:

Печать=N
Диалог печати=N

где N = 0 или 1

Например, подобная настройка может выглядеть так:

<Провайдер>
Номер=2
Наименование=МТС
Печать=1
Диалог печати=0

Таким образом какие бы не были параметры в config.ini, настройки для конкретного провайдера будут использоваться из Providers_user.ini

[config]

Параметры работы Конфигуратора.

Название параметра Тип Стандартно Описание
AutoScan Бит 1 0. Выключено автосканирование.
1. Включено автосканирование.

Функция автоматического сканирования устройств на COM-портах компьютера. По определенному алгоритму Конфигуратор определяет какое устройство находится на каждом из 256 COM-портов. Если сканирование COM-портов приводит к сбою Конфигуратора или всего компьютера в целом, то можно отключить сканирование портов (или запретить сканирование определенных портов в параметре 'DisableComPort'). Также функцию сканирования портов можно отключить для ускорения загрузки Конфигуратора, после того, как он уже определил все устройства или вы сделали это вручную.
DisableComPort строка пусто Исключить выбранные COM-порты из автосканирования устройств
Например, COM-порты устройств приводящих к сбою при сканировании, bluetooth-устройств и других нежелательных для сканирования устройств. Порты указываются через запятую, например DisableComPort=3,5,7
ConfigLogEx Бит 0 0. Выключить расширенный режим.
1. Включить расширенный режим.

Расширенный режим записи в лог поведения Конфигуратора. Помогает выявить проблемы Конфигуратора, а также проанализировать автоматическое сканирование устройств.
LastPage Число 1 Номер последней открытой вкладки в Конфигураторе. При запуске Конфигуратор переходит на последнюю перед закрытием вкладку.

[time1]

Ежедневный таймер

Название параметра Тип Стандартно Описание
Time Целое 0 Время срабатывания таймера (количество секунд от 0:0)
Func Целое 0 Функция таймера (0-Отключить, 1-Перезагрузить ОС, 2-Выключить ПК, 3-Перезапустить ПО)

[Dispenser]

Настройка параметров работы с диспенсером

Название параметра Тип Стандартно Описание
Path Строка Путь до файла с описание кодов завершения и ошибок диспенсера. Например Codes\Puloon2000.ini
COM Число 2 Номер COM-порта диспенсера
Type Число 0 Тип (модель) диспенсера. Например Puloon LCDM-1000/LCDM-2000 (Тип 1).
Enable Бит 0 Включение/отключение диспенсера
Speed Число 9600 Скорость COM-порта диспенсера
CountCassetes Число 0 Количество кассет(лотков) в диспенсере
NominalCassete_N Число 0 Номинал купюры в кассете (лотке) N
NumberBillsInCassete_N Число 0 Количество купюр в кассете (лотке) N

[BillAcceptor]

Настройка параметров работы с купюроприемником

Название параметра Тип Стандартно Описание
Enable Бит 0 Включение/отключение
Type Число 1 Модель. 1 - CashCode; 2 - ICT; 3 - MATRIX
PrintIncas Бит 0 Инкассация при снятии стекера
BillRejectCount Число 10 количество подряд возвращенных купюр, при которых выдается сообщение на сервер
BlockTimeSec Число 0 время блокировки при ошибке, 0 - бессрочно
SetBillFirstCount Число 2 количество пропусков при опросе купюроприемника
RejectCount_ToShowScreen Число 5 количество возвращенных подряд купюр, после которых следует показать сообщение на экране с предложением вставить другую купюру

[SpecButtons]

Горячие клавиши

Название параметра Тип Стандартно Описание
Collection Строка * инкассация
TrayVisible Строка x|X|ч|Ч свернуть ПО
CancelBlock Строка #27 отмена

[infoserver]

Настройка отправки на сервер мониторинга

Название параметра Тип Стандартно Описание
firstInterval Число 5 Время (в секундах) отсрочки отправки первого пакета на сервер мониторинга
PayListener Бит 1 Отсылка измененных платежей в диспетчерскую


Пример файла config.ini: config.zip