Skip to main content

A validated IBAN field for Django models

Project description

https://secure.travis-ci.org/benkonrath/django-iban.png?branch=master https://coveralls.io/repos/benkonrath/django-iban/badge.png?branch=master https://pypip.in/v/django-iban/badge.png https://pypip.in/d/django-iban/badge.png

Validated Django model fields for International Bank Account Numbers (IBAN - ISO 13616-1:2007) and SWIFT-BIC (ISO 9362:2009).

Author: Ben Konrath

License: 3-clause BSD

Features:

  • Support for all currently active and planned to be active IBAN countries / numbers.
  • Optional validation for IBANs included the Nordea IBAN extensions.
  • Validates IBAN using the official validation algorithm.
  • Basic validation for SWIFT-BIC.
  • Python 3.2 and 3.3 support for Django >= 1.5.

Usage:

Use the model fields IBANField and/or SWIFTBICField in your models:

from django.db import models
from django_iban.fields import IBANField, SWIFTBICField


class CustomerModel(models.Model):
    iban = IBANField()
    swift_bic = SWIFTBICField()

Use the form fields IBANFormField and/or SWIFTBICFormField in your forms:

from django import forms
from django_iban.forms import IBANFormField, SWIFTBICFormField


class CustomerForm(forms.Form):
    iban = IBANFormField()
    swift_bic = SWIFTBICFormField()

If you want to validate the Nordea IBAN extensions, the model and form fields can be setup like this:

class CustomerModel(models.Model):
    iban = IBANField(use_nordea_extensions=True)


class CustomerForm(forms.Form):
    iban = IBANFormField(use_nordea_extensions=True)

Development:

Coding style: PEP8 with 120 character lines.

Ideas for new features include:

  • SWIFT-BIC validation using referenced IBANField (SEPA requires both IBAN and SWIFT-BIC to be correct).
  • Translation of validation error messages using Transifex.

Pull requests happily accepted.

Project details


Release history Release notifications

History Node

0.3.1

History Node

0.3.0

History Node

0.2.8

History Node

0.2.7

This version
History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-iban-0.2.6.tar.gz (11.8 kB) Copy SHA256 hash SHA256 Source None Mar 9, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page