NAME
Business::BancaSella - A wrapper for Banca Sella online payment system (ver 0.11)
SYNOPSIS
These are only some examples. For more examples, see later...
During encoding...
use Business::BancaSella;
use Business::BancaSella::Ric;
use CGI qw/:standard/;
my $ric = new Business::BancaSella::Ric::Mysql(
dbh => $DBI_handle,
tableName => $table_name,
fieldName => $field_name
);
my $otp = $ric->extract;
my $bs = new Business::BancaSella::Encode(
type => 'gestpay',
id => $internal_id,
shopping => $shopping,
otp => $otp,
amount => $amount,
language => 'english',
currency => 'eur',
);
my $bsUri = $bs->uri;
redirect($bsUri);During decoding...
use Business::BancaSella::Decode;
use Business::BancaSella::Ris;
use CGI;
my $cgi = new CGI();
my $qs = $cgi->query_string;
my $bs = new Business::BancaSella::Decode(
type => 'gestpay',
'query_string' => $qs
);
my $ric = new Business::BancaSella::Ris::Mysql(
dbh => $DBI_handle,
tableName => $table_name,
fieldName => $field_name
);
if (!$ric->check($bs->otp)) {
&error_page;
} else {
$ric->remove($bs->otp);
if ($bs->result) {
&payment_ok;
} else {
&payment_ko;
}
} DESCRIPTION
Banca Sella is an italian bank which offer an integrated and secure online payment system using secure web geteway over SSL.
This module is a wrapper that built web request and receive web response from this payment system encoding and decoding it in an object orientated environment.
Usually this module can be used in an e-commerce environment web site to support online payment via credit cards.
This documentation doesn't explain what the Banca Sella online payment system is and how it works . For more information you can point your browser to Banca Sella's home page (http://www.sellanet.it) or directly to GestPay documentation (http://www.sellanet.it/download/SecificheTecnicheOTP1.0.1.pdf).
OBJECTS STRUCTURE
Business::BancaSella
Wrapper for Banca Sella online payment system
Business::BancaSella::Gestpay
Abstract class for Gestpay parameter info
Business::BancaSella::Gateway
Abstract class for Gateway compatibility parameter info
Business::BancaSella::Decode
Parent class for decoding systems
Business::BancaSella::Decode::Gestpay
Uri decoding for return transaction info results from GestPay online system payment.
Business::BancaSella::Decode::Gateway
Uri decoding for return transaction info results from Gateway online system payment.
Business::BancaSella::Encode
Parent class for encoding systems
Business::BancaSella::Encode::Gateway
Uri creator for Gateway online system payment.
Business::BancaSella::Encode::Gestpay
Uri creator for GestPay online system payment.
Business::BancaSella::Ric
Parent class for extracting One-Time-Password from different storage place
Business::BancaSella::Ric::File
Extract One-Time-Password from a standard Banca Sella ASCII file
Business::BancaSella::Ric::FileFast
Extract One-Time-Password from an improved ASCII file
Business::BancaSella::Ric::Mysql
Extract One-Time-Password from a mysql database
Business::BancaSella::Ris
Parent class for checking One-Time-Password from different storage place
Business::BancaSella::Ris::File
Check the existance of One-Time-Password in a standard Banca Sella ASCII file.
Business::BancaSella::Ris::FileFast
Check the existance of One-Time-Password in an improved ASCII file.
Business::BancaSella::Ris::Mysql
Check the existance of One-Time-Password from a mysql database
Prerequisites:
Perl version 5.6.0 or more recent.
CPAN URI module.
CPAN HTML::Entities module.
CPAN URI::Escape module.
BUGS
I am aware of no bugs - if you find one, send me an e-mail at info@ebruni.it with bugs.
When submitting bug reports, be sure to include full details, including the VERSION of the module, and a test script demonstrating the problem!
AUTHOR
Bruni Emiliano, info@ebruni.it
LICENSE
Business::BancaSella - A wrapper for Banca Sella online payment system with Perl Copyright (C) 2001-2002 Bruni Emiliano <info@ebruni.it>
Business::BancaSella::Ric::FileFast and Business::BancaSella::Ris::FileFast are written by Marco Gazerro and Mauro Fedele.
This module is free software; you can redistribute it and/or modify it under the terms of either:
a) the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version, or
b) the "Artistic License" which comes with this module.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See either the GNU General Public License or the Artistic License for more details.
You should have received a copy of the Artistic License with this module, in the file ARTISTIC. If not, I'll be glad to provide one.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
SEE ALSO
Business::BancaSella::Gestpay
Business::BancaSella::Gateway
Business::BancaSella::Decode
Business::BancaSella::Decode::Gateway
Business::BancaSella::Decode::Gestpay
Business::BancaSella::Encode
Business::BancaSella::Encode::Gateway
Business::BancaSella::Encode::Gestpay
Business::BancaSella::Ric
Business::BancaSella::Ric::File
Business::BancaSella::Ric::FileFast
Business::BancaSella::Ric::Mysql
Business::BancaSella::Ris
Business::BancaSella::Ris::File
Business::BancaSella::Ris::FileFast
Business::BancaSella::Ris::Mysql