Модуль PayOnline

Назначение модуля

Модуль PayOnline предназначен для проведения платежей через платежную систему PayOnline c использованием пластиковых карт. Для проведения платежей Вашими клиентами у Вас должен быть заключен договор с системой.

Модуль работает по защищенному протоколу https с использованием шифрования SSL, что исключает возможность перехвата информации и нарушения целостности данных третьими лицами.

Настройка модуля

Установите модуль на сервер, обновите клиент. Затем создайте экземпляр модуля. Создайте в редакторе конфигурации модуля новую конфигурацию, введите требуемые параметры. После этого сохраните конфигурацию и сделайте её активной.

Конфигурация
#Перечень кодов статусов, которые считаются активными для модуля
contract.active.status.codes=
 
#Код продавца (выдается после заключения договора с PayOnline)
merchant.id=
 
#ваш секретный ключ (выдается после заключения договора с PayOnline)
private.security.key=
 
#URL, на который осуществляетя перевод для оплаты ("/" в конце не нужен)
pay.online.url=https://secure.payonlinesystem.com/ru/payment
 
#Код типа платежа, которыми будут зачисляться платежи
payment.type.id=
#Код типа расхода, при отмене платежа
refund.charge.typeid=
#Комментарий при отмене платежа
refund.charge.comment
 
#Нужно ли сохранять данные о карте (4 последние цифры карты) и rebillAnchor в БД.
#Возможные значения: true - нужно сохранять, false - не нужно сохранять.
payonline.store.data=false
 
#URL возврата, на который будет возвращать клиента после платежа
redirect.url=
 
#Минимальная разрешенная сумма платежа
min.summa=100
 
#Максимальная разрешенная сумма платежа
max.summa=3000
 
#Количество потоков очереди отправки платежей
#thread.count=20
 
#Данные организации выводимые на чеке (название, ИНН, адрес, телефон)
check.org.header=Название организации
check.org.inn=ИНН организации
check.org.address=Адрес организации
check.org.phone=Телефон организации
 
#Заголовок чека(может быть несколько таких связок)
pdf.check.title.1.regex=^Pech+$
pdf.check.title.1.title=Good
 
#Автоплатеж
#Включает данный функционал в web-кабинете
rebill=true
#URL, на который отправляются запросы автоплатежа
rebill.url=https://secure.payonlinesystem.com/payment/transaction/rebill
 
#Замена комментария по умолчанию к платежам
#Простой платеж
usual.comment="Простой платеж"
#Автоплатеж
rebill.comment="Автоплатеж"
 
#Дополнительная уникальность платежей. Необязательный параметр.
rebillUnique=может принимать любое значение
#========Нстройка комиссии
#Комиссия. Возможные значения: 0 - нет комиссии; 1 - комиссия из суммы платежа; 2 - комиссия сверх суммы платежа
commission.type=0;
#Процент комиссии 0-100 %
commission.percent=2
#Коментарий к расходу по комиссии
commission.comment=Комиссия Payonline
#тип расхода для комиссии
commission.charge.type.id=
#тип платежа для возврата комиссии при отмене платежа
refund.payment.typeid=
#комментарий при возврате комиссии
refund.charge.comment=Возврат комиссии Payonline

Замечания:

  1. Прежде, чем задавать payment.type.id необходимо создать соответствующий платеж в Справочники->Другие->Типы платежей

  2. После заключения договора с системой PayOnline в их личном кабинете необходимо задать callback URL, который ждет результаты от платежной системы. URL будет выглядеть следующим образом: http://<адрес_машины_биллинга>/payonline/<mid>. Например, если у вас биллинг находится по адресу http://billing.example.com/bgbilling/ и модуль PayOnline имеет mid=16, то результирующий URL, который нужно дать компании PayOnline, выглядит следующим образом: http://billing.example.com/bgbilling/payonline/16.

  3. Чтобы использовать функционал автоплатежа необходимо заключить доп. соглашение с PayOnline. И в планировщик заданий добавить задачу Автоплатеж(Rebill). В параметрах запуска задачи нужно указать код модуля PayOnline и время запуска 1 раз в сутки.

Оплата из Личного кабинета

Для предоставления возможности клиенту платить банковской картой через платежный шлюз PayOnline необходимо подключить данный модуль к договору клиента. В Web-интерфейсе клиента появится новый пункт в меню - Оплата банковской картой (название по умолчанию).

images/download/attachments/43385640/payonline_web_interface.png

Простой платеж

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

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

В случае положительного результата биллинговая система начислит клиенту указанную им сумму на счет.

Автоплатеж

Данный функционал позволяет выполнять повторные транзакции без непосредственного участия плательщика ежемесячно. Как и остальные программные интерфейсы, Автоплатеж работает по защищенному протоколу https с использованием шифрования SSL, что исключает возможность перехвата информации и нарушения целостности данных третьими лицами.

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

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

images/download/attachments/43385640/payonline_web_rebill.png

Автоплатеж осуществляется периодической задачей планировщика Автоплатеж (Rebill). Для корректной работы задачи необходимо указать в конфигурации модуля параметр contract.status.active.codes=<перечень кодов через запятую>. Таким образом, не будут проводиться автоплатежи по закрытым договорам и договорам, имеющим неактивный статус.

Для того, чтобы удалить автоплатеж, необходимо нажать кнопку Отменить автоплатеж.

Монитор транзакций

В клиенте билинга есть возможность отслеживать историю платежей по каждому абоненту. Для этого необходимо выбрать модуль PayOnline в дереве параметров договора. Здесь присутствует фильтр по типу платежа (все/только автоплатежи/только обычные) с указанием периода, когда производилась оплата. Также отображается состояние автоплатежа, если он активирован. Оператор биллинга может только удалить автоплатеж с договора, если клиент по каким-либо причинам не может это сделать самостоятельно, сняв соответсвующее выделение автоплатеж.

images/download/attachments/43385640/payonline_contract_overview.png

Для просмотра ВСЕХ платежей, проведенных через систему PayOnline, существует глобальный монитор в параметрах модуля. В открывшейся вкладке Проведенные платежы модуля PayOnline у Вас есть возможность просмотреть платежи с учетом фильтра по типу платежа и указанному периоду, совершенные вашими абонентами. На вкладке модуля Ошибки автоплатежей выводятся ошибки, которые были получены от системы Payonline по автоплатежу для каждого договора.

images/download/attachments/43385640/payonline_admin.png

По двойному клику левой кнопкой мыши на строке в таблице открывается соответствующий договор.

Сверка транзакций

Существует возможность произвести сверку платежей, используя выгружаемые из системы Payonline csv-файлы, сформированные за определенный период. Сверка осуществляется через меню Модули->Payonline->Сверка платежей.

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

images/download/attachments/43385640/payonline_check_payments.png