Page tree
Skip to end of metadata
Go to start of metadata

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

Модуль 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-интерфейсе клиента появится новый пункт в меню - Оплата банковской картой (название по умолчанию).

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

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

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

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

Автоплатеж

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

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

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

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

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

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

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

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

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

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

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

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

 

  • No labels