ProjectorBUg / ibanking

ibanking api

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

IBanking Package for Laravel 5

This package allows you to crawl and parse your bank balance and statement. Currently available for Bank BCA and Bank Mandiri. Inspired by the original BCA Parser. Thank you yah gan =)

Installation

To get started with IBanking, run this command or add the package to your composer.json

composer require ProjectorBUg/ibanking

Configuration

After installing the IBanking package, register the ProjectorBUg\IBanking\IBankingServiceProvider in your config/app.php file. Also, add the IBanking facade to the aliases array in your app configuration file:

'IBanking' => ProjectorBUg\IBanking\Facades\IBanking::class,

Finally add these lines to your config/services.php file:

'bca' => [
    'username' => 'your-klikbca-username',
    'password' => 'your-klikbca-password'
],
'mandiri' => [
    'username' => 'your-mandiri-username',
    'password' => 'your-mandiri-password'
]

How To Use

After all sets, use the IBanking as follows:

$ibank = IBanking::bank('bca');

$ibank->login();

$balance = $ibank->getBalance();

$statement = $ibank->getStatement(3); // mutation within last 3 days. Default: 1 (yesterday)

$ibank->logout();

The logout() method should be called to avoid single session at a time restriction from the internet banking provider. This means if you don't call the logout() method at the end of your codes, you won't be able to login to your internet banking from anywhere until its session expired.

Non-Laravel Usage

You can stil use IBanking without Laravel. This is how:

After running composer require ProjectorBUg/ibanking, create a php file in your project folder and put the following codes

require 'vendor/autoload.php';

use ProjectorBUg\IBanking\CrawlerParser;
use ProjectorBUg\IBanking\Providers\BCAProvider;

$ibank = new BCAProvider(new CrawlerParser(), 'username', 'password');
$ibank->login();
$balance = $ibank->getBalance();
$statement = $ibank->getStatement();
$ibank->logout();

// the rest of your code...

Tips & Advice

You can place the above code under the Scheduled Command job (Laravel) and sets it to run not more than 100x per day. The less you run it per day, the less chances you are being suspended by the internet banking provider. Please make any necessary effort to keep your ibank username and password safe and secure. Changing your password regularly can help to keep it more secure.

Bugs & Improvements

Feel free to report me any bug you found. I would be also very happy to receive pull requests for improvements and for other internet banking provider as well.

About

ibanking api

License:MIT License


Languages

Language:PHP 100.0%