Карточная платформа.
Система может генерировать 2 типа карт.

• Карты платежей.
• Универсальные карты с сервисами.

Карта платежей используется для пополнения счета клиента. После успешного пополнения, карте присваивается состояние USE (Использовано).
Карта с прикреплёнными сервисами (универсальные карты) кроме сумы пополнения содержит логин и пароль для использования сервиса, например Internet. После покупки карты клиент может воспользоваться сервисом карты для входа в систему или просто пополнить имеющийся счёт. После успешного пополнения счёта сервисный акаунт анулируется и эти изменения фиксируются в сервисном журнале / System configuration/ History/. Если пользователь уже начал использовать сервис карты, то дальнейшее пополнение используя карту невозможно.

• Генерация универсальных карт с логином и паролем. Данной картой можно как пополнять интернет так пользоваться как независемым аккаунтом.
• Генерация карт платежей.
• Генерация аккаунтов пользователей.
• Генерация аккаунтов пользователей из файла с данными о них.
• Контроль перебора карт и ошибочных вводов.
• Учёт дилеров и отчёты о продажах.
• Начисление процента дилеру от продаж.
• Печать карт в формате PDF. Для данной функции нужно установить модуль PDF::API2 (http://search.cpan.org/~areibens/PDF-API2-0.71.001/)
• Експорт карт в XML, CSV
• Выполнение внешних программ после авторизации карточки

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

Форма оплаты

Генерация аккаунтов для Dv модуля

Создать таблицы в базе.

# mysql -D abills < db/Cards.sql
# cp Cards.pm /usr/abills/Abills/mysql

Подключение модуля. abills/libexec/config.pl

@MODULES = (
          'Cards'
          );

Параметры конфигурации модуля: abills/libexec/config.pl

Добавление дилера. Любой пользовательский акаунт может получить расширение дилер. Для этого нужно включить в акаунте эту функцию. / Customers/ Logins/ Information/

Список дилеров
/ Customers/ Dealers/

/ System configuration/ Card System/ Internet carts/ Add/ При генерации карт с сервисами обязательно используете тарифные планы с параметром AGE (Время жизни) больше 0.

После генерации 10 карт с серией AW и суммой 10.00, получааем список сгенерированных карт.

AW00000000000	64898159	10.00	0000-00-00
AW00000000001	34955747	10.00	0000-00-00
AW00000000002	24781747	10.00	0000-00-00
AW00000000003	63768698	10.00	0000-00-00
AW00000000004	49942143	10.00	0000-00-00
AW00000000005	91657427	10.00	0000-00-00
AW00000000006	58180403	10.00	0000-00-00
AW00000000007	75051326	10.00	0000-00-00
AW00000000008	52589145	10.00	0000-00-00
AW00000000009	42878392	10.00	0000-00-00

Описание колонок

1. Серия для ввода в пользовательской форме. Оставляйте его незакрытым для учёта проданных карт. Серия состоит из 2 частей префикса и 11 цифр номера.
2. Пин код (защетите его от постороних глаз)
3. Сума пополнения.
4. Дата, после которой карта считается недействительной.

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

Влияющие параметры из libexec/config.pl

# Длина пароля не менее
$conf{PASSWD_LENGTH}=6;

# Максимальная длина логина
# По умолчанию 16 но не более 20
$conf{MAX_USERNAME_LENGTH}=15;

# В логине возможно использовать только
# По умолчанию маленькие латинские буквы, цифры и символ подчёркивания(только не первым символом)
$conf{USERNAMEREGEXP}="^[a-z0-9_][a-z0-9_-]*\$";

После подключения модуля Cards появляется меню / Customers/ Users/ Internet / Internet cards/

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

Обратите внимание, что если указана дата активации (не «0000-00-00»), то, в зависимости от тарифного плана, будут сделаны все необходимые расчёты с соответствующим изменением депозитов.

[LOGIN][tab][PASSWORD][tab][EXPRESION…]

Разделитель для данных символ табуляции.

После подключения модуля Cards появляется меню / Customers/ Users/ Internet/ Internet carts/

Информация о акаунте

Персональная информация

Для добавления дополнительных информационных полей указывается номер 3 и название поля в базе.
Пример:
3._second_address

Internet

Оплата

E-mail (Если подключён модуль Email к системе)

Msgs (Если подключён модуль Msgs к системе)

Bonus (Если подключён модуль Bonus к системе)

Дополнительные параметры

Пример файла логинов. Переносятся логин, пароля, сума и ФИО:

petrov   pasrddsword   5.SUM="10"  3.FIO="Petrov A V"
test     testpassword  5.SUM="2.5" 3.FIO="THis Is test"
test2    test2pasrdds  5.SUM="6.0" 3.FIO="THis Is test2 user"

/ System configuration/ Card System/ Internet carts/
Состояние карт

Дата продажи карты

После изменения состояния карты или передачи её дилеру в поле Administrator вносятся данные об администраторе, сделавшем последние действия, и заносятся данные в системный журнал (/System configuration/ History/).

Список Серий

Список Карт

В системе предусмотрена функция печати карточек оплаты и формирование шаблонов в формате PDF. Для работы с PDF форматом нужно установить Perl модуль .
Печать осуществляется на лист размером А4. Куда можно разместить 10 карточек.
За печать карточек отвечают следующие шаюлоны:

• cards_print.tpl - печать в HTML формате
• cards_print.pdf - PDF шаблон
• cards_print.dsc - файл разметки для PDF шаблона

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

Номер в конце переменно указывает место размещение данных по карточке на листе.

Также можно экспортировать уже созданные карточки в формат CSV. В файл экспорта заносятся следующие поля разделённые табуляцией: SERIAL LOGIN, PASSWORD/PIN, TARIF_PLAN, SUM, EXPIRE, AGE, TIME_LIMIT

(Поставляется как дополнение к карточному модулю)

Возможности

1. Генерация карт платежей произвольного номинала
2. Дилер имеет возможность генерировать карты на суму своего депозита (депозит + кредит).
3. Фомирования чеков для чековых принтеров (Например: D-Link DSA-3100P)
4. Вывод отчётов для дилера

Установка

# cp dillers.cgi /usr/abills/cgi-bin/

После успешной установки интерфейс доступен за адресом

https://your.host:9443/dillers.cgi

Работа с системой
Для создания дилера нужно зайти в меню / Customers/ Logins/ Information/ Dillers/ и активизировать дилерский аккаунт.

Также в интерфейс дилера встроен терминальный сервер который разрешает подключать к системе внешние программы для генерации карточек.

• Проверка активности сервера:

/dillers.cgi?cmd=ping

ответ

pong

• Пополнение счета:

/dillers.cgi?cmd=pay&term=1234567&pswd=password&date=29.09.2010&time=10:55&sum=15

переменные

ответ

err=no&series=14351431&pin=76543

Переменные настройки

—

/ Reports/ Cards/

Формирование отчётов по работе карточной системы

В системе ведётся контроль перебора пин кодов если количество неправильный вводов больше значения переменной $conf{CARDS_BRUTE_LIMIT} (По умолчанию 5) система блокирует ввод данных по карточкам. Блокировка длится акпиод указанный в переменной $conf{CARDS_BRUTE_CLEAN_PERIOD} (по умолчанию 2 дня).
Журнал блокировок можно посмотреть в меню

/ System configuration/ Internet cards/ Brute Attack/