0.0
No commit activity in last 3 years
No release in over 3 years
A ruby library to access the Konto API (https://www.kontoapi.de/), a webservice that performs validity checks and other services regarding german bank accounts.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.3.0, ~> 1.3
>= 2.0.1, ~> 2.0
>= 2.3.0, ~> 2.3

Runtime

>= 2.3.7, ~> 2.3
>= 1.2.1, ~> 1.2
 Project Readme

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.