The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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