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

NAME

Finance::Bank::HDFC - Interface to the HDFC netbanking service

VERSION

This documentation refers to version 0.14

SYNOPSIS

    use Finance::Bank::HDFC;

    my $bank = Finance::Bank::HDFC->new;
    $bank->login({
        cust_id   => 'xxx',
        password  => 'xxx',
    });
    print $bank->get_balance . "\n";

    # mini statement
    my @statements = $bank->get_mini_statement();
    for (@statements) {
        print "Date: " . $_->{date_transaction} . "\n";
        print "Amount: " . $_->{amount} . "\n";
        print "Balance: " . $_->{balance} . "\n";
    }

  $bank->logout;
 

DESCRIPTION

This module provides an interface to the HDFC netbanking service at https://netbanking.hdfcbank.com/netbanking/

METHODS

new()

Constructor for this class. Currently requires no arguments.

login()

Login to the netbanking service. Requires hashref of named parameters.

  • cust_id - Your HDFC customer ID

  • password - Your netbanking password (IPIN)

Dies on error.

get_balance()

Returns account balance. Dies on error.

get_mini_statement()

Returns account mini statement.

It returns an array of hashrefs. Each hashref has the following keys:

  • date_transaction

  • description

  • ref_chq_num

  • date_value

  • amount

  • balance

  • type

logout()

Logout from the netbanking service. Remember to always call this method at the end of your program or you may face difficulties logging in the next time.

Dies on error.

set_timeout()

Sets the HTTP timeout. Parameters:

  • timeout => HTTP timeout in seconds

Returns the timeout just set.

REQUIRES

LWP::UserAgent, Crypt::SSLeay, version, Readonly

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.

AUTHOR

Rohan Almeida <rohan@almeida.in>

COPYRIGHT AND LICENSE

Copyright (C) 2005-2008 by Rohan Almeida <rohan@almeida.in>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.