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

NAME

Finance::Bank::AllianceAndLeicester - Check your Alliance & Leicester bank accounts from Perl

SYNOPSIS

  use Finance::Bank::AllianceAndLeicester;
  my @accounts = Finance::Bank::AllianceAndLeicester->check_balance(
      customerid  => '01234567',
      pin         => '12345',
      memorable   => 'mybirthplace',
      phrase      => 'my unique phrase'
  );

  foreach (@accounts) {
      printf("%8s(%20s):  GBP %8.2f " .
             "(Overdraft: GBP %8.2f Available: GBP %8.2f)\n",
             $_->{account}, $_->{name},
             $_->{balance}, $_->{overdraft}, $_->{available_balance});
  }

DESCRIPTION

This module provides a rudimentary interface to the Alliance & Leicester online banking system at https://www.mybank.alliance-leicester.co.uk/.

DEPENDENCIES

You will need either Crypt::SSLeay or IO::Socket::SSL installed for HTTPS support to work with LWP. This module also depends on WWW::Mechanize and HTML::TokeParser for screen-scraping.

CLASS METHODS

check_balance
  check_balance ( customerid => $c,
                  pin        => $p,
                  memorable  => $m,
                  phrase     => $s )

Return an array of account hashes, one for each of your bank accounts.

customerid

The Customer ID is the 8-digit number supplied with your account.

pin

Your 5-digit PIN number.

memorable

This is your memorable information, such as your birth place. This is asked for when you first login to your bank account.

phrase

Your unique phrase. This is used to make sure we are connecting to the Alliance & Leicester website and that the connection has not been hijacked.

This is created when you first sign up for online access to your account, and can be changed on the Alliance & Leicester internet banking website.

ACCOUNT HASH KEYS

  $ac->account
  $ac->name
  $ac->balance
  $ac->overdraft
  $ac->available_balance

Return the account number, account name (e.g. 'PlusSaver'), account balance, account overdraft limit and available balance as a signed floating point value.

WARNING

This warning is from Simon Cozens' Finance::Bank::LloydsTSB, and seems just as apt here.

This is code for online banking, and that means your money, and that means BE CAREFUL. You are encouraged, nay, expected, to audit the source of this module yourself to reassure yourself that I am not doing anything untoward with your banking data. This software is useful to me, but is provided under NO GUARANTEE, explicit or implied.

THANKS

Simon Cozens for Finance::Bank::LloydsTSB and Chris Ball for Finance::Bank::HSBC, upon which most of this code is based. Andy Lester (and Skud, by continuation) for WWW::Mechanize, Gisle Aas for HTML::TokeParser.

CHANGELOG

Version 1.03 - 08/06/2009 - Simon Dawson tehsi@cpan.org

* Rewrote to work with most-recent Alliance & Leicester website.

Version 1.02 - 10/10/2006 - Ian Bissett ian@tekuiti.co.uk

* Reduced PERL version in Makefile.PL to 5.006001 which should solve some installation issues.

Version 1.01 - 04/10/2006 - Ian Bissett ian@tekuiti.co.uk

* Strip commas (',') from balances.

AUTHOR

Originally written by Ian Bissett ian.bissett@tekuiti.co.uk; currently maintained by Simon Dawson tehsi@cpan.org.