Konto API Ruby Library
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
spec
.gitignore
Gemfile
Gemfile.lock
LICENSE
README.markdown
Rakefile
VERSION
kontoapi-ruby.gemspec

README.markdown

Konto API Ruby Library

This library provides an easy way to access the Konto API, a webservice that performs validity checks and other services regarding german and international bank accounts.

INSTALLATION

$ [sudo] gem install kontoapi-ruby

USAGE

require 'kontoapi-ruby'

# mendatory settings
KontoAPI::api_key = "abc123"

# optional settings
KontoAPI::timeout = 10   # 10 seconds is the default

# Check account validity: KontoAPI::valid?(options)
KontoAPI::valid?( :ktn => '1234567', :blz => '12312312' )
#=> false
KontoAPI::valid?( :ktn => '49379110', :blz => '10010010' )
#=> true

# Check IBAN only
KontoAPI::valid?( :iban => 'DE71100100100068118106' )
#=> true

# Check BIC only
KontoAPI::valid?( :bic => 'PBNKDEFF100' )
#=> true

# Check both IBAN and BIC
KontoAPI::valid?( :iban => 'DE71100100100068118106', :bic => 'PBNKDEFF100' )
#=> true

# Get the name of a bank by its code: KontoAPI::bank_name(bank_code)
KontoAPI::bank_name('10010010')
#=> 'Postbank'

# Get IBAN + BIC from account data: KontoAPI::iban_and_bic(ktn, blz)
KontoAPI::iban_and_bic('68118106', '10010010')
#=> { 'iban' => 'DE71100100100068118106', 'bic' => 'PBNKDEFF100' }

Copyright

Copyright (c) 2011-2015 General Scripting UG (haftungsbeschränkt). See LICENSE for details.