NAME

Finance::Bank::US::INGDirect - Check balances and transactions for US INGDirect accounts

VERSION

Version 0.08

SYNOPSIS

use Finance::Bank::US::INGDirect;
use Finance::OFX::Parse::Simple;

my $ing = Finance::Bank::US::INGDirect->new(
    saver_id => '...',
    customer => '########',
    questions => {
        # Your questions may differ; examine the form to find them
        'AnswerQ1.4' => '...', # In what year was your mother born?
        'AnswerQ1.5' => '...', # In what year was your father born?
        'AnswerQ1.8' => '...', # What is the name of your hometown newspaper?
    },
    pin => '########',
);

my $parser = Finance::OFX::Parse::Simple->new;
my @txs = @{$parser->parse_scalar($ing->recent_transactions)};
my %accounts = $ing->accounts;

for (@txs) {
    print "Account: $_->{account_id}\n";
    printf "%s %-50s %8.2f\n", $_->{date}, $_->{name}, $_->{amount} for @{$_->{transactions}};
    print "\n";
}

DESCRIPTION

This module provides methods to access data from US INGdirect accounts, including account balances and recent transactions in OFX format (see Finance::OFX and related modules). It also provides a method to transfer money from one account to another on a given date.

METHODS

new( saver_id => '...', customer => '...', questions => {...}, pin => '...' )

Return an object that can be used to retrieve account balances and statements. See SYNOPSIS for examples of challenge questions.

accounts( )

Retrieve a list of accounts:

( '####' => [ number => '####', type => 'Orange Savings', nickname => '...',
              available => ###.##, balance => ###.## ],
  ...
)

recent_transactions( $account, $days )

Retrieve a list of transactions in OFX format for the given account (default: all accounts) for the past number of days (default: 30).

transactions( $account, $from, $to )

Retrieve a list of transactions in OFX format for the given account (default: all accounts) in the given time frame (default: pretty far in the past to pretty far in the future).

transfer( $from, $to, $amount, $when )

Transfer money from one account number to another on the given date (default: immediately). Returns the confirmation number. Use at your own risk.

AUTHOR

This version by Steven N. Severinghaus <sns-perl@severinghaus.org> with contributions by Robert Spier.

COPYRIGHT

Copyright (c) 2011 Steven N. Severinghaus. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Finance::Bank::INGDirect, Finance::OFX::Parse::Simple