Skip to main content

ibans

A simple yet powerfull package for validating parsing ibans

FEATURES

  • Validating IBAN
    • Checks if the country suports iban

    • Validate the IBAN string size for the specific country

    • Validate the check code for countries with fix checkcode

    • Validate the structure of BBAN for the specific country

    • Validate the entire IBAN using MOD 97 operaationas decribed by ISO-7064

  • Parsing IBAN will get the following info
    • Country name

    • Country Alpha2 code

    • Check Code

    • Basic Bank Acount Number

    • (If Available) Bank Code

    • (If Available) Account number

    • (If Available) SWIFT

    • (If Available) Sigla

    • (If Available) Bank Name

    • (If Available) Branch code

    • (If Available) Account Type

    • (If Available) Account Holder

    • (If Available) Balance Account Number

    • (If Available) Currency Code

Instalation

Install using pip with:

pip install ibans

Usage

Using the package is as simple as shown below

Parse IBAN

to parse an iban just call

>>> import ibans
>>> iban =  ibans.parse("AO06005500009209313310152")

>>> iban.country
'Angola'

>>> iban.country_code
'AO'
>>> iban.check_digit
'06'

>>> iban.basic_bank_account_number
005500009209313310152

>>> iban.bank_code
'0055'

>>> iban.account_number
'00009209313310152'

>>> iban.bank_name
'Banco Privado Atlântico, S.A.'

>>> iban.sigla
'BPA'

>>> iban.swift_bic
'PRTLAOLU'

Format IBAN

Formating example

>>> from ibans import Iban, IbanFormat
>>> iban =  ibans.parse("AO06 0055 0000 9209 3133 1015 2")
>>> iban.format(IbanFormat.PRINT)
'AO06 0055 0000 9209 3133 1015 2'
>>> iban.format(IbanFormat.PRINT_HIDDEN)
'AO06 **** **** **** **** *015 2'
>>> iban.format(IbanFormat.ELECTRONIC)
'AO06005500009209313310152'

Formating example for (Belgium)

>>> from ibans import Iban, IbanFormat
>>> iban =  ibans.parse("BE71096123456769")
>>> iban.format(IbanFormat.PRINT)
'BE71 096 1 2345 67 69'

Formating example for (Cyprus)

>>> from ibans import Iban, IbanFormat
>>> iban =  ibans.parse("CY17002001280000001200527600")
>>> iban.format(IbanFormat.PRINT)
'CY17 002 0 0128 0000 0012 0052 7600'

Contributing

Contribuitions are welcome, please open an issue or send a PR. Please read our Contributing and code of conduct

License

This project is available under MIT License

Metadata

Release files for ibans 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ibans 1.0.0
File Size Uploaded
ibans-1.0.0.tar.gz 2.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ibans 1.0.0
File Interpreter ABI Platform
ibans-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 6.1 kB

Release files / ibans-1.0.0.tar.gz

Download URL ibans-1.0.0.tar.gz
Size 2.9 kB
Tags Source
SHA-256 checksum
How to use checksums
43dbc12a8a3a4c7b6291a71406e1de15fbcfd961c853d1741a0ac91a19af6ed2
BLAKE2b-256 checksum
How to use checksums
eadc11ee0383435f8438e94f025c52d7a64a1fb7932c97adf6efc4dc8088dbb1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1

Release files / ibans-1.0.0-py3-none-any.whl

Download URL ibans-1.0.0-py3-none-any.whl
Size 3.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa7798d3d6027d5e424dea676862cf03535442eea07a5747885c0ea676e9f859
BLAKE2b-256 checksum
How to use checksums
5bf79925c81dc81cc6bfc072c21bcde62830fe0eeca108ddef24de6ec5adbfc3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page