Page History

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

Возможности

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

С чего начать?

1. Надо подписать договор с платежной системой.

2. Получить протокол (опционально) взаимодействия API.

3. Получить ключи от процессинга (например, логин, пароль, номер мерчанта в платежной системе).

4. Купить и настроить модуль платежной системы в ABillS.

5. Посмотреть как настроить платежную систему

6. Принимать платежи.

Типы внешних платежей

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

1) После входа в личный кабинет пользователь переходит в меню Денежные операции>Пополнение счёта, вводит сумму пополнения, выбирает систему оплаты и нажимает кнопку дальше

Image Added

2) Система переносит пользователя на страницу подготовленной оплаты с данными платежа

Image Added

3) Если все данные верны пользователь нажимает кнопку оплатить и переносится на странице проведение платежа системы оплаты которую он выбрал

4) После успешного совершения платежа пользователя возвращает назад на страницу личного кабинета с информацией что платёж был зачислен успешно

5) Если во время платежа произошла ошибка пользователя также возвращает на страницу личного кабинета и предупреждает повторно об ошибке пополнения

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

1) Пользователь подходит к терминалу и выбирает провайдера

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

3) Пользователь пополняет счет. На протяжении 1-2 минут деньги появляются на счету и биллинг активизирует услуги.

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

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

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

• Идентификатор платежа

• Сумма платежа

• Дата и время платежа

• Платёжная системы

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

• Идентификатор платежа

• Сумма платежа

• Дата и время платежа

• Платёжная системы

• IP адрес откуда пришёл платёж

• Тело самого запроса

• Статус транзакции

Типы пополнений

Image Modified

После версии 0.78.

30 используется новая схема подключения платежных систем, также скоро перестанет поддерживатся PAYSYS_V2

Подключение модуля

@MODULES = (
          'Paysys'
          );
# Включение меню финансовых операций.
$conf{user_finance_menu}=1;


#Включение новой схемы модуля Paysys.
$conf{PAYSYS_NEW_SCHEME}=1;

$conf{PAYSYS_NEW_SETTINGS} = 1;

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

mysql --default-character-set=utf8 -D abills < /usr/abills/db/Paysys.sql -p
cp Paysys.pm  /usr/abills/Abills/mysql

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

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

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

Отслеживание ошибок

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

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

Дать права для paysys_check.log

chown -R www-data:www-data /usr/abills/var/log/paysys_check.log
chmod 755 /usr/abills/var/log/paysys_check.log

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

Чтобы быть полностью уверенным что платёжная система не отправляет подтверждение посмотрите в файл логов веб сервера на наличие обращений от платёжной системы к вашему биллингу /var/log/httpd/abills-access_log

Если обращения были, а платеж не провелся, то необходимо посмотреть лог ошибок :  /var/log/httpd/abills-error.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

Настройки конфигурационного файла

Пул оплат

$conf{PAYMENT_POOL}=1;

Параметр пула платежей. При включенной опции платежи будут проходить дополнительную проверку.

Используется с  billd payments_pool (проходиться по оплатам из пула оплат и выполняет cross_modules_pre cross_modules_make для каждой оплаты)

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

*/10       *      *       *       *       root    /usr/abills/libexec/billd payments_pool

Интерактивный режим

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

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

Вид формы: 

Image Added

Параметры

За дизайн интерактивной формы отвечает шаблон paysys_gateway.tpl

F.A.Q

 FAQ документация