IBAN Validator

Validates an IBAN that is in the IBAN register at 3.1 below, as such any experimental IBAN's do not validate since we do not have those in the ibanRegisterInfo list which is used to verify the length of the IBAN.

The console/docker will return "validated" or "not validated" depending on if the IBAN has been validated

The service will return the IBAN requested and the "validated" set to 0 or 1

{
  "iban": "BE71096123456769",
  "validated": 1
}

How to use

First make sure everything is ok by running tests

This command will download and use the goLang 1.17 image

make test

If everything passes, you are good to go.

Validate an IBAN number

Validate using your console

go run console/console.go GB82WEST12345698765432

Validate using docker

Build the docker image and then Run it

make build
docker run ibanvalidator GB82WEST12345698765432

As service

Start service (defaults to port 5000)

go run ibanService/ibanService.go

or

docker-compose up -d

Send a POST request to the local service

By default the service is listeningen on port 5000

Example how to access the endpoint via curl:

curl --location --request POST 'localhost:5000/validate' --header 'Content-Type: application/json' --data-raw '{    "Iban": "GB82 WEST 1234 5698 7654 32"}'

Information on IBAN etc:

1. https://en.wikipedia.org/wiki/International_Bank_Account_Number

Excerpt from Wiki

Algorithms

Validating the IBAN

An IBAN is validated by converting it into an integer and performing a basic mod-97 operation (as described in ISO 7064) on it. If the IBAN is valid, the remainder equals 1.[Note 1] The algorithm of IBAN validation is as follows:[8]

Check that the total IBAN length is correct as per the country. If not, the IBAN is invalid Move the four initial characters to the end of the string Replace each letter in the string with two digits, thereby expanding the string, where A = 10, B = 11, ..., Z = 35 Interpret the string as a decimal integer and compute the remainder of that number on division by 97 If the remainder is 1, the check digit test is passed and the IBAN might be valid.

Example (fictitious United Kingdom bank, sort code 12-34-56, account number 98765432):

• IBAN: GB82 WEST 1234 5698 7654 32
• Rearrange: W E S T12345698765432 G B82
• Convert to integer: 3214282912345698765432161182
• Compute remainder: 3214282912345698765432161182 mod 97 = 1

[8] https://www.ecbs.org/Download/EBS204_V3.2.pdf

2. https://www.swift.com/search?keywords=IBAN+list&search-origin=result_search

Found a txt and pdf file on the swift webpage that contained IBAN registers.

Did a quick macro in notepad++ and created the ibanRegisterInfo array, it should be downloaded and automated.

3.1. TODO:

Automatic update the IBAN register

• https://www.swift.com/swift-resource/9606/download
• Move ibanRegisterInfo to database or create on start

NOTICE

• This is my first go, you should probably not look at this

PONDERINGS

• What is some of the best microservice structures in go
• How to log best practice
• As above for errors, or we take it its the same sort of since go dont have exception handling like I am used ot.