/ 
Finance-Bank-IE-0.22
River stage zero No dependents
/ Finance::Bank::IE::BankOfIreland

NAME

Finance::Bank::IE::BankOfIreland - Interface to Bank of Ireland online banking

SYNOPSIS

use Finance::Bank::IE::BankOfIreland;

# config
my $conf = { user => '', pin => '', contact => '', dob => '' };

# get balance from all accounts
my @accounts = Finance::Bank::IE::BankOfIreland->check_balance( $conf );

# get account transaction details
my @details = Finance::Bank::IE::BankOfIreland->account_details( $acct );

# list beneficiaries for an account
my $bene = Finance::Bank::IE::BankOfIreland->list_beneficiaries( $acct );

# transfer money to a beneficiary
my $tx = Finance::Bank::IE::BankOfIreland->funds_transfer( $from, $to, $amt );

DESCRIPTION

Module to interact with BoI's 365 Online service.

FUNCTIONS

Note that all functions are set up to act as methods (i.e. they all need to be invoked using F:B:I:B->method()). All functions also take an optional configuration hash as a final parameter.

login_dance( $config );

Logs in or refreshes the current session. The config parameter is a hash reference which is cached the first time it is used, so can be omitted thereafter. The contents of the hash are the login details for your 365 Online account:

  • user: your six-digit BoI user ID

  • pin: your six-digit PIN

  • contact: the last four digits of your contact number

  • dob: your date of birth in DD/MM/YYYY format

No validation is currently done on the format of the config items. The function returns true or false. Error reporting is currently via croak or carp. There are some extra config options controlling debug output. Note that this function should rarely need to be directly used as it's invoked by the other functions as a first step.

check_balance()

Fetch all account balances from the account summary page. Returns an array of Finance::Bank::IE::BankOfIreland::Account objects.

activate_beneficiary( $acct, $bene, $code )

Activate the specified beneficiary using the provided activation code.