BankVal::International::GetABA
use Finance::BankVal::International::GetABA qw(&getABA); $ans = getABA('format','ABA','userId','PIN'); ==================== or for OO ======================== use Finance::BankVal::International::GetABA; $abaObj = Finance::BankVal::International::GetABA->new(); $ans = $abaObj->getABA('format','ABA','userId','PIN');
This module handles all of the restful web service calls to Unified Software's BankValInternational ABA service. It also handles fail over to the back up services transparently to the calling script. It can be called in a procedural or OO fashion (see synopsis)
The exportable method &getABA(); takes a number of parameters including;
1: Format - the response format (either xml, json or csv)
2: ABA - the ABA code to be validated
3: UserID - available from www.unifiedsoftware.co.uk
4: PIN - available from www.unifiedsoftware.co.uk
(UserID and PIN are available from http://www.unifiedsoftware.co.uk/freetrial/free-trial-home.html)
The order of the parameters must be as above. The UserID and PIN can be stored in the InternationalLoginConfig.txt file bundled with this module, the use of this file saves passing the PIN and user ID data with each call to getABA. For example, a call to validate an ABA routing code passing the user ID and PIN as parameters and printing the reply to console should follow this form:
=====================================================================
#!/usr/bin/perl use Finance::BankVal::International::GetABA qw(&getABA); my $ans = getABA('XML','ABAcode','xmpl123','12345'); print $ans;
=============================OR for OO===============================
use Finance::BankVal::International::GetABA; $abaObj = Finance::BankVal::International::GetABA->new(); my $ans = $abaObj->getABA('format','ABA','xmpl123','12345'); print $ans;
valid parameter lists are:-
getABA('$format','$aba','$userID','$PIN');
getABA('$format','$aba');
n.b. the last parameter list requires that the user ID and PIN are stored in the InternationalLoginConfig.txt file bundled with this module.
None by default. &getABA is exported on request i.e. "use Finance::BankVal::International::GetABA qw(&getABA);" or to use OO just "use Finance::BankVal::International::GetABA;"
LWP::UserAgent => 5.835 XML::Simple => 2.18 JSON => 2.21
Crypt::SSLeay => 0.57
Crypt::SSLeay is required by LWP::UserAgent to make use of SSL you may need to install this manually try: sudo aptitude install libssl-dev (might not be neccessary and can be removed after install) sudo cpan -i Crypt::SSLeay
Please see http://www.unifiedsoftware.co.uk for full details on Unified Software's web services.
A. Evans - Unified Software, <support@unifiedsoftware.co.uk>
Copyright (C) 2010 by Unified Software Limited
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.08.0 or, at your option, any later version of Perl 5 you may have available.
To install Finance::BankVal::International::GetABA, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Finance::BankVal::International::GetABA
CPAN shell
perl -MCPAN -e shell install Finance::BankVal::International::GetABA
For more information on module installation, please visit the detailed CPAN module installation guide.