README
1
2README for the Perl module Business::OCV
3
4 Copyright (c) 1999/2000 University of New South Wales
5 Benjamin Low <b.d.low@unsw.edu.au>. All rights reserved.
6
7 This program is free software; you can redistribute it and/or
8 modify it under the same terms as Perl itself.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 Artistic License for more details.
14
15
16DESCRIPTION
17-----------
18
19This module provides an interface to the Ingenico Online Credit Verification
20Server (OCV) (see http://www.ingenico.com.au). The OCV server provides an
21interface into the bank network and allows credit card transactions to be
22processed in real-time.
23
24Usage:
25
26# create a connection to the OCV server
27$ocv = new OCV
28(
29 Server => '192.1.2.3:53005',
30 ClientID => 'MyClient',
31 Account => '1',
32);
33
34# process a purchase transaction (amount is in cents)
35if ($m = $ocv->purchase(CardNum=>'4...3' CardExpiry=>'0202', Amount=>'1000'))
36{
37 warn "Warning: $@" if $@;
38 print "Purchase result: " . $m->Result . "\n";
39}
40else
41{
42 warn "Error: $@";
43}
44
45The interface is complete, including
46 - full logging
47 - internal totals support
48 - polled mode support
49 - all transaction types (purchase, refund, pre-auth, completion, status)
50 - statistics
51 - VPP configuration and status
52 - account list
53 - server totals
54
55The only thing missing is complete support for 'logons', as Ingenico state
56this is deprecated as a client request.
57
58TODO
59----
60
61- update and convert documentation to pod form
62
63FUTURE WORK
64-----------
65
66- Add support for shared server connections
67- Implement a Business::OnlinePayment interface
68- Add support for logging to a DBI backend
69
70
71INSTALLATION
72------------
73
74To install, unpack the archive and in the newly created directory type:
75
76 perl Makefile.PL
77 make
78 make install
79
80Use
81 perl Makefile.PL PREFIX=<location>
82
83to install somewhere other than the default.
84
85
86