Модуль bl_card

Материал из Felix2
Перейти к: навигация, поиск


Модуль реализует функционал для работы с картами экспресс-оплаты (загрузка/активация/поиск/учет).

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

Существует множество компаний, изготавливающих данные карты на заказ.
После выполнения заказа с самими картами предоставляется файл в формате CSV или Excel (который несложно сохранить в формате CSV) содержащий список пар : номер карты - PIN код.
Вот этот файл нужно загрузить в АСР Felix2 чтобы пользователи могли активировать карты оплаты через Личный кабинет абонента.
Далее по порядку.



Пример конфигурации

Модуль не требует дополнительных настроек.

    ...
<module name="bl_card" file="modules/bl_card.so" />
    ...

Загрузка модуля bl_card.


Создание типов карт экспресс-оплаты

Перед загрузкой карт экспресс-оплаты в базу данных биллинга, необходимо добавить типы карт оплаты.

Добавление типов карт оплаты


Загрузка карт экспресс-оплаты в базу

Добавление карт экспресс-оплаты, используемых абонентами для оплаты услуг связи производятся в разделе Биллинг -> Карты оплаты -> Добавить. Для добавления карт экспресс-оплаты выберите тип (номинал) добавляемых карт. Укажите формат файла со списком карт оплаты. Поддерживаются форматы CSV и XML. Если файл в формате Excel, сохраните его в формате CSV.


Сохранение списка карт экспресс-оплаты в формате CSV


Исходный CSV файл карт экспресс-оплаты представляет собой набор строк вида:

<номер карты>;<PIN-код>

В нашем примере содержимое CSV файла Книга1.csv будет:

001000001;873980935705
001000002;023850238535
001000003;234234234556
001000004;398547220355
001000005;203975399351
001000006;110938538236
001000007;832353895232
001000008;233204954634
001000009;123487239343
001000010;345435342830


Загружаем список карт экспресс-оплаты в базу данных биллинга:


Заливка карт экспресс-оплаты в базу данных биллинга


Список добавленных карт экспресс-оплаты


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

При попытке добавления карт оплаты обнаружены дубликаты

Активация карты экспресс-оплаты из Личного кабинета абонента

После того как карты загружены в базу, пользователи могут их активировать из Личного кабинета абонента

Активация карты оплаты из Личного кабинета абонента


Активация карты экспресс-оплаты с сайта

Для упрощения процесса активации карт экспресс-оплаты имеется специальная страница: https://lk.example.net/perl/activate_card.pl
Здесь lk.example.net нужно заменить на ваше доменное имя.
Ссылку на данную страницу можно сделать с официального сайта сети. Удобство заключается в том, что пользователь может активировать карту оплаты даже если он не помнит пароль от своего личного кабинета.


Активация карты оплаты со страницы активации


Активация карты экспресс-оплаты со стертым PIN-кодом

Довольно часто бывают ситуации, когда абоненты вместе с защитным слоем стирают часть цифр PIN-кода. Активировать такую карту может оператор в разделе Биллинг -> Карты оплаты -> Активация карты.

Активация карты экспресс-оплаты со стертым PIN-кодом


Поиск карты экспресс-оплаты по номеру

В разделе Биллинг -> Карты оплаты -> Поиск карты можно проверить, существует ли карта экспресс-оплаты с заданным номером. И если существует, то была ли он активирована (и какому пользователю) или нет.

Поиск карты экспресс-оплаты по номеру