Модуль платежей. Разрешает автоматически зачислять деньги с разных платёжных систем.

• Автоматически зачислять деньги на счёт пользователя без участия оператора
• Уведомление администратора о поступлениях платежей.
• Уведомление пользователя о получении платежа.
• Ведение журнала платежей с детальной информацией о платежах.
• Создание отчёта платежей.
• Блокирования/разрешения уведомлений о платеже для определенных только IP адресов. Уведомление администратора о не санкционируемых операциях.
• Зачисление с Visa/Master карт
• Зачисления через терминалы оплаты
• Загрузка платежей с файла (банковских выписок)
• Курс валют
• Настройки платежного модуля
• Настройки платежных систем по группам
• Внешние команды для оплаты

1. Надо подписать договор с платежной системой.
2. Получить протокол (опционально) взаимодействия API.
3. Получить ключи от процессинга (например, логин, пароль, номер мерчанта в платежной системе).
4. Купить и настроить модуль платежной системы в ABillS.
5. Принимать платежи.

Тип 1 - Портал абонента Пользователь оплачивает за услуги непосредственно со своего веб-кабинета используя виртуальные платёжные системы (Webmoney, Yandex деньги) или пластиковые карты Visa/Master Cards

Пользователь совершает следующие действия:

1. После входа в личный кабинет пользователь переходит в меню / Денежные операции / Пополнение счёта
   
   
2. Вводит суму пополнения, выбирает систему оплаты и нажимает кнопку дальше
   
   
3. Система переносит пользователя на страницу подготовленной оплаты с данными платежа
   
   
4. Если все данные верны пользователь нажимает кнопку оплатить и переносится на странице проведение платежа системы оплаты которую он выбрал
5. После успешного совершения платежа пользователя возвращает назад на страницу личного кабинета с информацией что платёж был зачислен успешно
6. Если во время платежа произошла ошибка пользователя также возвращает на страницу личного кабинета и предупреждает повторно об ошибке пополнения

Тип 2 - терминалы оплаты
Пользователь оплачивает за услуги с терминала платежей. Терминал платежей через обработчик paysys_check.cgi передает данные в биллинг

Пользователь совершает следующие действия:

1. пользователь подходит к терминалу выбирает провайдера
2. вводит свой логин или UID (или любой другой параметр указанный в настройке платёжной системы в биллинге). Терминал идентифицирует абонента, показывает его ФИО и остаток на счету.
3. пользователь пополняет счет. На протяжении 1-2 минут деньги появляются на счету и биллинг активизирует услуги

Тип 3 - Через мобильный телефон

Пользователь оплачивает за услуги с помощью мобильного телефона. Средства передаются в билинг с помощью обработчика paysys_check.cgi

Тип 4 - банковские выписки

Пользователь оплачивает за услуги в банке. Средства вносятся администратором или автоматически через консоль (FTP, POP3, file)

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

Журнал платежей

• Идентификатор платежа
• Сума платежа
• Дата и время платежа
• Платёжная системы

Журнал внешних платежей

• Идентификатор платежа
• Сума платежа
• Дата и время платежа
• Платёжная системы
• IP адрес откуда пришёл платёж
• Тело самого запроса
• Статус транзакции

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

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

Вид формы

abills/libexec/config.pl

@MODULES = (
          'Paysys'
          );
# Включение меню финансовых операций
$conf{user_finance_menu}=1;
 
# mysql --default-character-set=utf8 -D abills < db/Paysys.sql -p
# cp Paysys.pm  /usr/abills/Abills/mysql

Дополнительные модули платёжных систем копируются в папку /usr/abills/Abills/modules/Paysys/

Установка агента получения (чекера) платежей. Платёжные системы отправляют на чекер данные об оплате, чекер идентифицирует систему и заносит средства на счет. Если чекер не может идентифицировать системы он пишет Error: Unknown payment system.

cd /usr/abills/cgi-bin/
ln -s ../Abills/modules/Paysys/paysys_check.cgi paysys_check.cgi

Для работы с некоторыми системами может понадобиться установить XML-Parser и XML-Simple :

После включения модуля в интерфейсе администратора появляется меню
/ Reports/ Paysys/ - отчёт работы системы
/ Payments/ Import/ - массовый импорт платежей из файла
/ Fees/ Import/ - массовый импорт снятий денег из файла
в интерфейсе пользователя меню
/ Finances/ Balance recharge - Пополнение счета используя разные платёжные системы

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

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

Они используется для получения данных об оплатах от разных систем
config.pl

$conf{PAYSYS_TEST_SYSTEM}='192.168.0.88:Paynet';

|192.168.0.88| IP адреса с которого будут отправляться запросы на тестирование |

В платёжном модуле должна присутствовать функция [paysys_name]_check_payment, она вызывается по умолчанию

список систем и их номеров

41 => "Webmoney",
42 => "Rbkmoney",
43 => "SMSProxy",
44 => "OSMP",
45 => "Portmone",
46 => "Ukrpays",
47 => "USMP",
48 => "Privat Bank (Visa/Master Cards)",
49 => "Pegas",
50 => "Comepay",
51 => "24_non_STOP",
52 => "24_non_STOP_SELF",
53 => "Express_Oplata",
54 => "Privat Bank - Privat 24",
55 => "Pay4",
56 => "АИС ЕРИП",
57 => "EasySoft",
58 => "Liberty Reserve",
59 => "QIWI",
60 => "Ibox",
61 => "OSMPv4",
62 => 'LiqPAY',
63 => 'UkrNET',
64 => 'Regulpay',
65 => 'Privat - Terminal',
66 => 'Paypal',
67 => 'Sberbank',
68 => 'Gigs',
69 => 'Autopay',
70 => 'CyberPlat',
71 => 'Telcell',
72 => 'Ipay',
73 => 'Yandex',
74 => 'Alpha-pay',
75 => 'Zaplati',
76 => 'Paynet',
77 => 'CyberPlat Visa/Master cards',
78 => 'Epay',
79 => 'Private bank terminal (json)',
80 => 'Pegas Self Terminals',
81 => 'Payonline - QIWI',
82 => 'Payonline - WebMoney',
83 => 'Payonline - Yandex money',
84 => 'Payonline - Bank card',
85 => "Термінали України",
86 => 'Perfectmoney',
87 => 'OKPay',
88 => 'Bitcoin',
89 => 'Smsonline',
90 => 'Cashcom',
91 => 'PayU',
92 => 'CoPayCo',
93 => 'Minbank',
94 => 'Redsys',
95 => 'Gateway Technologies',
96 => 'Webmoney UA',
97 => 'PayMaster',
98 => 'Ecommerce Connect (UPC)',
99 => 'TYME',
100=> 'E-manat', # Modenis
101=> 'Evostok',
102=> 'Stripe',
103=> 'Oschadbank',
104=> 'Kaznachey',
106=> 'Paykeeper',
105=> 'Robokassa',
107=> 'Chelyabinvestbank',
108=> 'Platon',
109=> 'Fondy',
110=> 'Walletone',
111=> 'Mobilnik',
112=> 'Idram',
114=> 'Oschadbank',
115=> 'Goldenpay',
116=> 'Mixplat',
117=> 'Яндекс Касса',
118=> 'Deltapay',
119=> 'Unipay',
120=> 'Tinkoff',
121=> 'Cloudpayments',
122=> 'Paymaster Ru',
123=> 'РНКБ',
124=> 'Выписки от ПриватБанка',
125=> 'Electrum',
126=> 'Plategka',
127=> 'City24',
128=> 'Concord Bank',

Часто возникает ситуация когда поставщики платёжных услуг пользуются одинаковыми протоколами но как то нужно их разделить для ведения отчетности. Для этих целей была создана функция наследование. Она разрешает использовать уже реализованный в системе протокол взаимодействия для нескольких поставщиков услуг, разделяя поступления от них. Включается данная опция опция параметром конфигурационного файла $conf{PAYSYS_SUCCESSIONS}

Пример наследования системы Gigs

$conf{PAYSYS_SUCCESSIONS}="192.168.1.102:90:New Pament system:nps:Gigs.pm";

Пример наследования системы OSMP (система не имеет собственного модуля встроена в модуль paysys_check.cgi)

$conf{PAYSYS_SUCCESSIONS}="192.168.1.102:90:New Pament system:new_osmp:osmp_payments";

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

Для того чтоб добавить несколько наследований, их нужно разделять через ';', например:

$conf{PAYSYS_SUCCESSIONS}="192.168.1.102:90:New Pament system:nps:Gigs.pm;192.168.1.103:91:New Pament system:new_osmp:osmp_payments;";''

Для включение режима отладки нужно в конфигурационном файле включить опцию $conf{PAYSYS_DEBUG}=1; (Включить лог отладки для Paysys модуля)

Лог ведётся в файле /usr/abills/var/log/paysys_check.log.

По данному файлу можно отследить были ли подтверждения оплаты со стороны платёжной системы. Если не можете найти в данном файле подтверждения о платеже. Скорее всего система не отправила Вам его. Чтобы быть полностью уверенным что платёжная система не отправляет подтверждение посмотрите в файл логов веб сервера на наличие обращений от платёжной системы к вашему билингу

 
# grep paysys_check.cgi /var/log/httpd/abills-access_log

если обращения были вы видите следующие строки

192.168.1.4 - !- [04/Jun/2014:07:33:38 +0000] "GET /paysys_check.cgi HTTP/1.1" 200 1678

Консольная утилита для работы с банковскими выписками для получения более детальной информации

# paysys_cons help

TYPE=[PAYMENTS|CANCEL_PAYMENT|FEES|ERIPT] - Тип операции
  PAYMENTS       - массовые пополнения
  CANCEL_PAYMENT - Отмена операций пополнения, система ориентируется по параметру ext_id
  FEES           - Массовые снятия 
  AUTO           - Автоматическое разнесение оплат и снятий. С положительным депозитом оплаты с отрицательным снятия.
  ERIPT          - Аплоад базы данных Eript  на сервер
IMPORT_RULE=         - Номер правила импорта
    0 -   - Eript
METHOD               - Тип операции для оплаты или снятий денег    
EMAIL_CHECK=...      - Получения файлов для импорта с E-mail ящиков. Используется протокол POP3
FTP_CHECK=...        - Получение данных для импорта с FTP
BACKUP_FILES=[DIR]   - Сохранение обработанных файлов (использовать в режиме отладки)
FILE=                - Импортировать данные с файла
DATE=                - Дата импорта
DEBUG=1,2..5         - Режим отладки. При режиме отладки выше 5 средства на счет абонента не зачисляются
DECODE=              - Перекодировать исходный текст
  win2koi 
  koi2win
  win2iso
  iso2win
  win2dos
  dos2win
PLUGIN=...           - Запустить плагины расширения
TYME=1               - Считывает файлы отчетов для модуля тайм за вчерашний день. Если добавить параметр DATE, то сделает считывание за эту дату.
help                 - Помощь

Возможность автоматической проверки банковских выписок пришедших на E-mail. Система забирает письма с почтового ящика по протоколу POP3 и вносит их в систему. Если не может определить формат письма система отправляет сообщение администратору.

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

Пример:

# /usr/abills/Abills/modules/Paysys/paysys_cons TYPE=PAYMENTS EMAIL_CHECK=1 IMPORT_RULE=2

Возможность автоматической проверки банковских выписок пришедших на FTP. Система забирает фалы с FTP и вносит их в систему.

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

Пример:

# /usr/abills/Abills/modules/Paysys/paysys_cons TYPE=PAYMENTS FTP_CHECK=1 IMPORT_RULE=2

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

Параметры

Пример работы

1. Переходим в биллинг /Fees / Import (Снятие денег / Импорт)
2. Выбираете сохраненный файл. Устанавливаем дату документа и его тип
3. Система просматривает файл и показывает результат. Все поля

имеющие возможность правки можно поправить и после этого нажать кнопку импорт для просмотра результата. Когда все данные приведены к правильному виду поставить галочку Fees (Снятие денег) и они зачислятса в базу.

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

• Oplata

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

Так же, абонент может узнать адрес терминалов, кликнув на нужный, или проложить путь до него, нажав кнопку «Go To».

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

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

$conf{PAYSYS_TERMINALS_ADD}='1';

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

Сначала добавим тип. Заходим в пункт меню Настройка/Paysys/Терминалы/Добавить тип.

Затем зайдем в пункт меню Настройка/Paysys/Терминалы/Терминалы

Для просмотра курса валют нужно зайти в пункт меню : Отчет/Paysys/Курс Валют.

Система показывает свежие курсы валют Национального Банка Украины, Приват Банка, Национального Банка Кыргызской Республики.

К тому же, можно включить таблицы курса валют на стартовой странице.

В меню Отчет/Отчет нужно выбрать галочками нужный вам отчет.

На стартовой странице будет следующее:

• Paysys API