README for the Perl module Business::OCV
Copyright (c) 1999/2000 University of New South Wales
Benjamin Low <
[email protected]>. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
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 the
Artistic License for more details.
DESCRIPTION
-----------
This module provides an interface to the Ingenico Online Credit Verification
Server (OCV) (see
http://www.ingenico.com.au). The OCV server provides an
interface into the bank network and allows credit card transactions to be
processed in real-time.
Usage:
# create a connection to the OCV server
$ocv = new OCV
(
Server => '192.1.2.3:53005',
ClientID => 'MyClient',
Account => '1',
);
# process a purchase transaction (amount is in cents)
if ($m = $ocv->purchase(CardNum=>'4...3' CardExpiry=>'0202', Amount=>'1000'))
{
warn "Warning: $@" if $@;
print "Purchase result: " . $m->Result . "\n";
}
else
{
warn "Error: $@";
}
The interface is complete, including
- full logging
- internal totals support
- polled mode support
- all transaction types (purchase, refund, pre-auth, completion, status)
- statistics
- VPP configuration and status
- account list
- server totals
The only thing missing is complete support for 'logons', as Ingenico state
this is deprecated as a client request.
TODO
----
- update and convert documentation to pod form
FUTURE WORK
-----------
- Add support for shared server connections
- Implement a Business::OnlinePayment interface
- Add support for logging to a DBI backend
INSTALLATION
------------
To install, unpack the archive and in the newly created directory type:
perl Makefile.PL
make
make install
Use
perl Makefile.PL PREFIX=<location>
to install somewhere other than the default.
