Project

iban-tools

0.14
Low commit activity in last 3 years
A long-lived project that still receives updates
Validates IBAN account numbers
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.7
~> 3.1
 Project Readme

iban-tools

iban-tools is a Ruby library for manipulating and validating IBAN account numbers. You can read more about IBAN on Wikipedia

CI

INSTALLATION

gem install iban-tools

The gem should be compatible with most Ruby versions.

USAGE

require 'iban-tools'

IBANTools::IBAN.valid?("GB82 WEST 1234 5698 7654 32") #=> true

Advanced usage, gives more detailed error messages

IBANTools::IBAN.new("XQ75 BADCODE 666").validation_errors
# => [:unknown_country_code, :bad_check_digits]

Pretty print, canonicalize, and extract fields from an IBAN code

iban = IBANTools::IBAN.new(" ro49  aaaa 1B31007593840000")

iban.code # => "RO49AAAA1B31007593840000"
iban.country_code # => "RO"
iban.prettify # => "RO49 AAAA 1B31 0075 9384 0000"

Convert local account numbers to IBAN and back to local.

iban = IBANTools::IBAN.from_local('NO', bank_code: '9710', account_number: '1112222', check_digit: '7')

iban.code # => "NO6197101112227"
iban.to_local # => {:bank_code=>"9710", :account_number=>"111222", :check_digit=>"7"}

Credit

Iulianu originally wrote iban-tools. The team at AlphaSights is currently maintaining the gem.