IbanTools

Iban validation and helpers Refer https://en.wikipedia.org/wiki/International_Bank_Account_Number for more details

Installation

1. Add iban_tools to your list of dependencies in mix.exs:

```elixir
def deps do
  [{:iban_tools, "~> 0.1.0"}]
end
```

Usage

1. Get Iban related info in map

   iex(2)> IbanTools.iban_values("ES12345")
   %{actual_code: "ES12345", bban: "345", check_digits: "12", code: "ES12345", country_code: "ES", len: 7}

2. Validate Iban and get error info as per violation

   iex(10)>  IbanTools.valid("ES8901820507910202155087")
   {:ok, :valid, "Iban code is valid"}

3. Get numerified Iban value as needed for check digit validation (modulo 97)

   iex(4)> "GB82 WEST 1234 5698 7654 32" |> IbanTools.iban_values |> IbanTools.Numerify.numerify
   3214282912345698765432161182

4. Validate Modulo 97 check passes or not

   iex(1)> "RO7999991B31007593840000" |> IbanTools.iban_values |> IbanTools.Numerify.check_valid_check_digits
   :ok

5. Get sanitised IBAN code

   iex(7)> " ro7999991ı31007593840001 " |> IbanTools.canonicalize_code
   "RO7999991I31007593840001"

6. Pretty print IBAN code for better human readability

   iex(1)> "RO7999991B31007593840001" |> IbanTools.pretty_print
   "RO79 9999 1B31 0075 9384 0001"

Supported Error/Message codes

iex(3)>  IbanTools.valid("ES")
{:error, :min_length, "Code should have atleast 5 characters"}

iex(4)>  IbanTools.valid("ESA")
{:error, :min_length, "Code should have atleast 5 characters"}

iex(5)>  IbanTools.valid("ESAB")
{:error, :min_length, "Code should have atleast 5 characters"}

iex(5)> IbanTools.valid("gb99 %BC")
{:error, :bad_chars, "Only alphanumeric characters allowed"}

iex(6)> IbanTools.valid("IN9386011117947")
{:error, :unknown_country_code, "Not a valid SEPA compatible country"}

iex(7)> IbanTools.valid("ES890182050791020215508")
{:error, :invalid_code_length, "Violation of Country Code length"}

iex(8)> IbanTools.valid("ES89AB820507910202155087")
{:error, :invalid_bban_format, "Violation of Country bban format"}

iex(2)> "RO7999991B31007593840001" |> IbanTools.iban_values |> IbanTools.Numerify.check_valid_check_digits
{:error, :bad_check_digits}