| Table of Contents |
|---|
Описание создания модуля AbillsBank.pm
Нужно создать файл AbillsBank.pm в папке /usr/abills/Abills/modules/Paysys/
Заголовки модуля
| Code Block | ||||
|---|---|---|---|---|
| ||||
package Paysys::systems::AbillsBank; =head1 AbillsBank New module for AbillsBank Documentaion: abills.net.ua Date: 20192022.01.01 Version: 78.00 =cut use strict; use warnings; use Abills::Base qw(_bp ); use Abills::Misc qw(); FATAL => 'all'; require Paysys::Paysys_Base; package Paysys::systems::AbillsBank; use Paysys; our $PAYSYSTEM_NAME = our $PAYSYSTEM_NAME = 'AbillsBank'; our $PAYSYSTEM_SHORT_NAME = 'AB'; our $PAYSYSTEM_ID = 1; our $PAYSYSTEM_VERSION = '78.00'; # Этот хеш используется для настройки системы в меню настроек our %PAYSYSTEM_CONF = ( PAYSYS_ABILLS_BANK_LOGIN => '', ); |
Обязательные функции модуля
Конструктор модуля.
| Code Block | ||||
|---|---|---|---|---|
| ||||
#**********************************************************
=head2 new($db, $admin, $CONF)
Arguments:
$db - ссылка на обьект базы данных (required)
$admin - ссылка на обьект администратора (required)
$CONF - ссылка на хеш %conf (required)
$attr - {
в атрибутах передаем дополнительные параметры
}
Returns:
$self - обьект класса платежной системы
=cut
#**********************************************************
sub new {
my $class = shift;
my ($db, $admin, $CONF, $attr) = @_;
my $self = {
db => $db,
admin => $admin,
conf => $CONF,
DEBUG => $CONF->{PAYSYS_DEBUG} || 0,
};
bless($self, $class);
return $self;
} |
| Code Block | ||||
|---|---|---|---|---|
| ||||
#**********************************************************
=head2 get_settings() - return hash of settings
Arguments:
Returns:
HASH
=cut
#**********************************************************
sub get_settings {
my %SETTINGS = ();
$SETTINGS{VERSION} = $PAYSYSTEM_VERSION; # объявляется в шапке модуля
$SETTINGS{ID} = $PAYSYSTEM_ID; # объявляется в шапке модуля
$SETTINGS{NAME} = $PAYSYSTEM_NAME; # объявляется в шапке модуля
# хеш с нужными ключами настсройки системы, например: логин, пароль, поле идентификации абонента и тд.
$SETTINGS{CONF} = \%PAYSYSTEM_CONF;
return %SETTINGS;
} |
Функция proccess() запускается при запросе от платежной системы на скрипт paysys_check.cgi.
Когда приходит запрос, система проверяет наличие IP адреса с которого идет запрос( $ENV{REMOTE_ADDR} ) в списке адресов которые вы прописали при настройках модуля.
| Code Block | ||||
|---|---|---|---|---|
| ||||
#**********************************************************
=head2 proccess(\%FORM) - function that proccessing payment
on paysys_check.cgi
Arguments:
$FORM - HASH REF to %FORM
Returns:
=cut
#**********************************************************
sub proccess {
my $self = shift;
my ($FORM) = @_;
} |
Функция user_portal() должна быть для оплаты из клиентского кабинета.
Функция запускается после введения суммы и нажатия Дальше.
| Code Block | ||||
|---|---|---|---|---|
| ||||
#**********************************************************
=head2 user_portal () -
Arguments:
Returns:
=cut
#**********************************************************
sub user_portal {
my $self = shift;
my ($user, $attr) = @_;
} |
Создание функции тестирования
| Info |
|---|
Сейчас работает только для терминальных систем |
| Code Block | ||||
|---|---|---|---|---|
| ||||
#**********************************************************
=head2 has_test()
Arguments:
-
Returns:
=cut
#**********************************************************
sub has_test {
my $self = shift;
my %params_hash = (
'1CHECK' => {
account => {
name => 'account',
val => '',
tooltip => "Идентификатор абонента в зависимости от настроек системы.(По умолчанию вводить UID абонента)",
},
command => {
name => 'command',
val => 'check',
ex_params => 'readonly="readonly"',
},
sum => {
name => 'sum',
val => '1.00',
tooltip => 'Сумма платежа',
type => 'number',
},
txn_id => {
name => 'txn_id',
val => $random,
tooltip => 'Transaction ID(случайный номер)',
type => 'number',
},
result => [ '<result>0</result>' ],
},
'2PAY' => {
result => [ '<result>0</result>' ],
command => {
name => 'command',
val => 'pay',
ex_params => 'readonly="readonly"',
},
account => {
name => 'account',
val => '',
tooltip => "Идентификатор абонента в зависимости от настроек системы.(По умолчанию вводить UID абонента)",
},
sum => {
name => 'sum',
val => '1.00',
tooltip => 'Сумма платежа',
type => 'number',
},
txn_id => {
name => 'txn_id',
val => $random,
tooltip => 'Transaction ID(случайный номер)',
type => 'number',
},
},
'3CANCEL' => {
result => [ '<result>0</result>' ],
command => {
name => 'command',
val => 'cancel',
ex_params => 'readonly="readonly"',
},
prv_txn => {
name => 'prv_txn',
val => 'Скопировать из ответа на проведение платежа',
tooltip => 'Id платежа',
type => 'number',
},
},
);
return \%params_hash;
} |
Описание функции и структуры данных
Тест платежной системы обращается в данную функцию для получения параметров по каким проводить тест.
%params_hash должен иметь следующую структуру.
| Параметр | Описание | Пример | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1CHECK, 2PAY, 3CANCEL | Параметры обозначают функции которые будут тестироваться. Если в вашем модуле нет какой то из них, то параметра не нужно. Цифра в названии обозначает порядок функции тестирования, после нее может быть любое название. |
| ||||||||||||||
| Данные параметры заполняются для создания формы тестирования по каждой функции.
После добавления необходимых параметров ОБЯЗАТЕЛЬНО добавить параметр result - массив результатов, можно передавать несколько(название не изменять) Отдельный элемент массива будет подставляться в регулярное выражение и осуществляться его поиск в xml-ответе функции. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|