НАСТРОЙКА СКРИПТА
 
Настройка скрипта заключается в установке требуемых параметров в файле конфигурации ps.conf.php, расположенном в корневой директории скрипта.
 

Файл ps.conf.php имеет следующий вид:

 
define ("SYSTEM_ACTIVE", PS_SERV_ON);
define ("SYSTEM_P1_ACTIVE", PS_SERV_ON);
define ("SYSTEM_P2_ACTIVE", PS_SERV_OFF);
//--------------------------------------------------------------------------
define ("ACCOUNT_TYPE_TRIP", 11); define ("ACCOUNT_TYPE_ABON", 12); define ("ACCOUNT_LEN", 10);
//--------------------------------------------------------------------------
// Параметры подключения
//--------------------------------------------------------------------------
define ("CONN_SQL_TRIP_HOST", "localhost");
define ("CONN_SQL_TRIP_PORT", "3199");
define ("CONN_SQL_TRIP_SERVER", "SQLEXPRESSMAGICS");
define ("CONN_SQL_TRIP_DB", "KeyManager");
define ("CONN_SQL_TRIP_USER", "sa");
define ("CONN_SQL_TRIP_PASS", "123456");
//--------------------------------------------------------------------------
define ("CONN_SQL_ABON_HOST", "localhost");
define ("CONN_SQL_ABON_PORT", "3199");
define ("CONN_SQL_ABON_SERVER", "SQLEXPRESSMAGICS");
define ("CONN_SQL_ABON_DB", "KeyManager");
define ("CONN_SQL_ABON_USER", "sa");
define ("CONN_SQL_ABON_PASS", "123456");
//--------------------------------------------------------------------------
define ("CONN_P20_TRIP_HOST", "192.168.1.107");
define ("CONN_P20_TRIP_PORT", "48500");
define ("CONN_P20_TRIP_DB", "");
define ("CONN_P20_TRIP_USER", "payserv");
define ("CONN_P20_TRIP_PASS", "qwerty");
define ("CONN_P20_TRIP_TIME", 5);
//--------------------------------------------------------------------------
define ("CONN_P20_ABON_HOST", "192.168.1.107");
define ("CONN_P20_ABON_PORT", "48500");
define ("CONN_P20_ABON_DB", "");
define ("CONN_P20_ABON_USER", "payserv");
define ("CONN_P20_ABON_PASS", "qwerty");
define ("CONN_P20_ABON_TIME", 5);
//--------------------------------------------------------------------------
define ("SUM_MIN_TRIP", 8);
define ("SUM_MAX_TRIP", 2000);
define ("SUM_MIN_ABON", 200);
define ("SUM_MAX_ABON", 10000);
define ("ABON_PAY_DAY", 10);
define ("ABON_PAY_HOUR", 10);
//--------------------------------------------------------------------------
define ("FORGIVE_DEBT", PS_SERV_ON);
define ("VALUTA", PS_VALUTE_KZ);
define ("DATE_TIME", SYS_DATE_TIME_RU);
define ("ABONENT_SECURE", ABONENT_SECURE_L3);
 
Описание параметров и возможных значений
 
SYSTEM_ACTIVE — [PS_SERV_ON/ PS_SERV_OFF]
Активация/Деактивация системы. Для работы системы должно быть установлено значение PS_SERV_ON. Выключение системы достигается установкой значения PS_SERV_OFF. (Деактивация системы может потребоваться при различных видах обслуживания. В этом режиме прекращается прием платежей, однако скрипт продолжает взаимодействие с платежной системой.)
 
SYSTEM_P1_ACTIVE — [PS_SERV_ON/ PS_SERV_OFF]
Активация/Деактивация взаимодействия системы с СКД «Портал». Для работы с СКД «Портал» должно быть установлено значение PS_SERV_ON. Значение PS_SERV_OFF отключает возможность работы с СКД «Портал».
 
SYSTEM_P2_ACTIVE — [PS_SERV_ON/ PS_SERV_OFF]
Активация/Деактивация взаимодействия системы с СКД «Портал 2.0». Для работы с СКД «Портал 2.0» должно быть установлено значение PS_SERV_ON. Значение PS_SERV_OFF отключает возможность работы с СКД «Портал 2.0».
 
Примечание
Хотя бы один из параметров (SYSTEM_P1_ACTIVE, SYSTEM_P2_ACTIVE) активации работы с системами Портал и Портал 2.0 должен быть установлен. Результат отключения обоих параметров аналогичен отключению системы в целом. Если активировано взаимодействие с обеими системами, то скрипт выполняет анализ, исходя из внутренних данных СКД «Портал», и автоматически выбирает систему для дальнейшего взаимодействия.
 
ACCOUNT_TYPE_TRIP — [ЛЮБОЕ ДВУЗНАЧНОЕ ЧИСЛО]
Данное поле является частью лицевого счета абонента в системе и представляет 2ведущих символа, служащих для определения типа платежа. Например, если указано число 11, то лицевой счет абонента будет иметь следующий вид — 11ХХХХХХХХ. Данный лицевой счет будет действителен для идентификаторов (ключей), работающих в режиме ограничения по количеству использований (поездок).
Значение данного поля должно отличаться от следующего поля (ACCOUNT_TYPE_ABON).
 
ACCOUNT_TYPE_ABON — [ЛЮБОЕ ДВУЗНАЧНОЕ ЧИСЛО]
Данное поле является частью лицевого счета абонента в системе и представляет 2 ведущих символа, служащих для определения типа платежа. Например, если указано число 12, то лицевой счет абонента будет иметь следующий вид — 12ХХХХХХХХ. Данный лицевой счет будет действителен для абонентов, оплачивающих услугу за определенный период — месяц.
Значение данного поля должно отличаться от следующего поля (ACCOUNT_TYPE_TRIP).
 
ACCOUNT_LEN — [ДЕСЯТИЧНОЕ ЦЕЛОЕ ЧИСЛО]
Длина лицевого счета в символах (цифрах). В это количество входит и селектор типа платежа — ACCOUNT_TYPE_TRIP/ ACCOUNT_TYPE_ABON. Если указано значение 10, то уникальных лицевых счетов в системе будет (максимум) 99 999 999 (почти сто миллионов) на один тип платежей.
 

Группа параметров CONN_SQL_TRIP

Параметры данной группы предназначены для настройки канала подключения к серверу базы данных СКД «Портал». Данная группа предназначена для работы с ключами, работающими в режиме ограничения по количеству использований (поездок).
 
CONN_SQL_TRIP_HOST — [IP-АДРЕС/ИМЯ_МАШИНЫ/ПСЕВДОНИМ]
Сетевой адрес или псевдоним компьютера в сети, на котором установлен сервер базы данных СКД «Портал» — MS SQL Server.
 
CONN_SQL_TRIP_PORT — [ДЕСЯТИЧНОЕ ЧИСЛО В ДИАПАЗОНЕ 1..65535]
Сетевой порт MS SQL Server’а для подключения к базе данных по сети TCP/IP. Должен быть указан в настройках MS SQL Server’а.
По умолчанию равен 1433, но может быть изменен на любой другой свободный порт.
 
CONN_SQL_TRIP_SERVER — [ИМЯ СЕРВЕРА БАЗЫ ДАННЫХ]
Имя сервера на платформе MS SQL Server, на котором работает база данных СКД «Портал».
 
CONN_SQL_TRIP_DB — [ИМЯ БАЗЫ ДАННЫХ]
Имя базы данных СКД «Портал».
 
CONN_SQL_TRIP_USER — [ИМЯ ПОЛЬЗОВАТЕЛЯ]
Имя пользователя базы данных, от имени которого будет выполняться подключение. Например, для сервера на базе MS SQL Express, имя пользователя — sa.
 
CONN_SQL_TRIP_PASS — [ПАРОЛЬ]
Пароль пользователя базы данных, от имени которого выполняется подключение.
 

Группа параметров CONN_SQL_ABON.

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

Группа параметров CONN_P20_TRIP

Параметры данной группы предназначены для настройки канала подключения к серверу СКД «Портал 2.0». Данная группа предназначена для работы с ключами, работающими в режиме ограничения по количеству использований (поездок).
 
CONN_P20_TRIP_HOST — [IP-АДРЕС/ИМЯ_МАШИНЫ/ПСЕВДОНИМ]
Сетевой адрес или псевдоним компьютера в сети, на котором установлен сервер СКД «Портал 2.0».
 
CONN_P20_TRIP_PORT — [ДЕСЯТИЧНОЕ ЧИСЛО В ДИАПАЗОНЕ 1..65535]
Сетевой порт сервера СКД «Портал 2.0» для подключения по сети TCP/IP. Должен быть указан в настройках сервера СКД «Портал 2.0».
 
 
CONN_P20_TRIP_DB — [ ]
В настоящее время параметр не используется. Не требует каких-либо значений.
 
CONN_P20_TRIP_USER — [ИМЯ ПОЛЬЗОВАТЕЛЯ]
Пользователь системы СКД «Портал 2.0». Настраивается в системе СКД «Портал 2.0» в разделе «Аккаунты –> Удаленный сервис».
 
CONN_P20_TRIP_PASS — [ПАРОЛЬ ПОЛЬЗОВАТЕЛЯ]
Пароль пользователя для подключения к системе СКД «Портал 2.0».
Настраивается в системе СКД «Портал 2.0» в разделе «Аккаунты –> Удаленный сервис».
 
CONN_P20_TRIP_TIME — [ДЕСЯТИЧНОЕ ЧИСЛО В ДИАПАЗОНЕ 1..99]
Время ожидания скриптом ответа от сервера СКД «Портал 2.0» в секундах.
Рекомендуемое значение 5. Зависит от канала связи между web-сервером (местом исполнения скрипта) и сервером СКД «Портал 2.0», от быстродействия и загруженности компьютеров.
 

Группа параметров CONN_P20_ABON

Параметры данной группы предназначены для настройки канала подключения к серверу СКД «Портал 2.0». Данная группа предназначена для работы с абонентами в режиме периодической (помесячной) оплаты. Параметры данной группы аналогичны параметрам группы CONN_P20_TRIP. Вероятнее всего они будут полностью совпадать, если оба вида оплаты реализованы в одной системе СКД «Портал 2.0». Если реализация выполнена на разных системах СКД «Портал 2.0», то в соответствующих параметрах группы нужно указать действующие настройки для данной системы.
 
SUM_MIN_TRIP — [ДЕСЯТИЧНОЕ ЧИСЛО]
Минимальная сумма платежа для лицевых счетов при оплате использований (поездок). Сумма платежа, менее значения данного параметра, не будет принята, о чем будет сообщено платежной системе.
 
SUM_MAX_TRIP — [ДЕСЯТИЧНОЕ ЧИСЛО]
Максимальная сумма платежа для лицевых счетов при оплате использований (поездок). Сумма платежа, более значения данного параметра, не будет принята, о чем будет сообщено платежной системе.
 
SUM_MIN_ABON — [ДЕСЯТИЧНОЕ ЧИСЛО]
Минимальная сумма платежа для лицевых счетов при оплате периода использования (абонентская плата). Сумма платежа, менее значения данного параметра, не будет принята, о чем будет сообщено платежной системе.
 
SUM_MAX_ABON — [ДЕСЯТИЧНОЕ ЧИСЛО]
Максимальная сумма платежа для лицевых счетов при оплате периода использования (абонентская плата). Сумма платежа, более значения данного параметра, не будет принята, о чем будет сообщено платежной системе.
 
ABON_PAY_DAY — [ДЕСЯТИЧНОЕ ЦЕЛОЕ ЧИСЛО]
Число (в месяце) платежа. Данное число интерпретируется системой как дата окончания действия периода использования.
Например, вы установили в качестве дня платежа 10. Это означает, что при оплате за месяц вам продлится срок использования ключей до 10-го числа следующего месяца.
 
ABON_PAY_HOUR — [ДЕСЯТИЧНОЕ ЦЕЛОЕ ЧИСЛО]
Час платежа. Данное число интерпретируется системой как час (в дате окончания использования) окончания действия периода использования.
Например, вы установили в качестве дня платежа 12. Это означает, что при оплате за месяц вам продлится срок использования ключей до 10-го числа (см. предыдущий параметр) следующего месяца до 12-ти часов.
 
FORGIVE_DEBT — [PS_SERV_ON/PS_SERV_OFF]
Данный параметр применяется только при виде оплаты «Абонентская оплата» (оплата за период — месяц).
Если параметр активен (PS_SERV_ON), то человек, не плативший несколько месяцев освобождается от оплаты «просроченного» периода (в это время он и лифтом не мог пользоваться). Очередной платеж разблокирует его ключи до следующей даты платежа.
Если данный параметр неактивен (PS_SERV_OFF), то абонент должен оплатить весь просроченный период для разблокировки его ключей.
 
VALUTA — [PS_VALUTE_RU/PS_VALUTE_KZ/PS_VALUTE_KG]
Валюта страны, где используется сервис. Выводится в ответ на запросы платежной системы.
 
DATE_TIME — [SYS_DATE_TIME_RU/SYS_DATE_TIME_KZ/SYS_DATE_TIME_EN]
Формат даты/времени в зависимости от установленной операционной системы и ее локализации.
 
ABONENT_SECURE — [ABONENT_SECURE_L0/ABONENT_SECURE_L1/ABONENT_SECURE_L2/ABONENT_SECURE_ L3]
 

Режим вывода персональных данных абонента при ответе платежной системе. Форматы вывода:

ABONENT_SECURE_L0 — Фамилия Имя Отчество
ABONENT_SECURE_L1 — Фамилия И. О.
ABONENT_SECURE_L2 — Имя Отчество Ф.
ABONENT_SECURE_L3 — Ф. И. О.