Ukrainian Payment Qr Invoices

IbanEx

用于处理 IBAN 号码（解析、验证、校验和格式化）的 Elixir 库

什么是 IBAN？

IBAN（International Bank Account Number，国际银行账号）是一种国际通用代码，由最多 34 个字母和数字组成，可帮助银行确保国际转账得到正确处理。

IBAN 仅用少量字母和数字，就包含了国际汇款或收款所需的国家、银行和账号信息。这一系统在整个欧洲使用，也得到中东、北非和加勒比地区部分区域的认可。查找所有使用 IBAN 的国家所对应的示例。

如何使用

解析 IBAN 的成功示例

    iex>  "FI2112345600000785" |> IbanEx.Parser.parse()
    {:ok, %IbanEx.Iban{
      iban: "FI2112345600000785",
      country_code: "FI",
      check_digits: "21",
      bank_code: "123456",
      branch_code: nil,
      national_check: "5",
      account_number: "0000078"
    }}

解析 IBAN 时的错误示例

检查 IBAN 所属国家是否受支持

    iex> {:error, unsupported_country_code} = IbanEx.Parser.parse("ZU21NABZ00000000137010001944")
    {:error, :unsupported_country_code}
    iex> IbanEx.Error.message(unsupported_country_code)
    "Unsupported country code"

验证并检查 IBAN 长度

    iex> {:error, invalid_length} = IbanEx.Parser.parse("AT6119043002345732012")
    {:error, :invalid_length}
    iex> IbanEx.Error.message(invalid_length)
    "IBAN violates the required length"

    iex> {:error, length_to_long} = IbanEx.Validator.check_iban_length("AT6119043002345732012")
    {:error, :length_to_long}
    iex> IbanEx.Error.message(length_to_long)
    "IBAN longer then required length"
    iex> {:error, length_to_short} = IbanEx.Validator.check_iban_length("AT61190430023457320")
    {:error, :length_to_short}
    iex> IbanEx.Error.message(length_to_short)
    "IBAN shorter then required length"

验证 IBAN 校验和

    iex> {:error, invalid_checksum} = IbanEx.Parser.parse("AT621904300234573201")
    {:error, :invalid_checksum}
    iex> IbanEx.Error.message(invalid_checksum)
    "IBAN's checksum is invalid"

安装

将 iban_ex 添加到 mix.exs 的依赖项列表中即可安装此软件包：

def deps do
  [
    {:iban_ex, "~> 0.1.8"}
  ]
end

可以使用 ExDoc 生成文档， 并将其发布到 HexDocs。发布后，可在 https://hexdocs.pm/iban_ex 查看文档。