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

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