UK modulo - Scala

This is an implementation of the VocaLink UK Bank account number modulus checking version 6.90 (and previous versions), written in Scala.

Modulus checking is a procedure used to determine whether a bank account number can be valid. If the account number check is negative then the account cannot exist, but the opposite is not true (meaning that if the check succeeds that does not guarantee the existence of the account).

Modulus checking can be used to help detect some input errors, but unfortunately there can be user errors that remain undetected.

License: MIT

Notes on validating sort codes

The "Industry Sorting Code Directory" (ISCD) should be used to validate UK sort codes.

Getting started

Sbt:

libraryDependencies += "com.github.mpetruska" %% "uk-modulo-scala" % "6.80.0"

pom.xml:

<dependency>
  <groupId>com.github.mpetruska</groupId>
  <artifactId>uk-modulo-scala_2.13</artifactId>
  <version>6.80.0</version>
</dependency>

Usage

Scala:

import com.github.mpetruska.ukmodulo.ModulusCheck

// valid account number
ModulusCheck.check(sortCode = "089999", accountNumber = "66374958") === Right(true)

// invalid account number
ModulusCheck.check(sortCode = "089999", accountNumber = "66374959") === Right(false)

// invalid format
ModulusCheck.check(sortCode = "089999", accountNumber = "xxxx") === Left("Account number format is not valid")

Java:

import com.github.mpetruska.ukmodulo.java.ModulusCheck;
import com.github.mpetruska.ukmodulo.java.ModulusCheckResult;

// valid account number
new ModulusCheck().check("089999", "66374958").isValidAccountNumber() == true;

// invalid account number
ModulusCheckResult result = new ModulusCheck().check("089999", "66374959");
result.isValidAccountNumber() == false;
result.isError() == false;

// invalid format
ModulusCheckResult result2 = new ModulusCheck().check("089999", "xxxx");
result2.isError() == true;
result2.error() == "Account number format is not valid";

Issues

Please report issues and feature requests here.

Version history

• 6.90.0 - updates implementation according to version 6.90 of the spec (valid from 2022-02-14)
• 6.80.0 - updates implementation according to version 6.80 of the spec (valid from 2021-10-04)
• 6.60.0 - add Scala 2.13, remove Scala 2.10 and 2.11. Also updates implementation according to version 6.60 of the spec (valid from 2021-04-26)
• 6.12.0 - updates implementation according to version 6.12 of the spec (valid from 2020-07-14)
• 6.1.0 - updates implementation according to version 6.1 of the spec (valid from 2020-04-07)
• 6.00.1 - fixes implicit change in the meaning of exception code 6
• 6.00.0 - updates implementation according to version 6.00 of the spec (valid from 2020-04-06)
• 5.90.0 - updates implementation according to version 5.90 of the spec (valid from 2020-02-03)
• 5.80.0 - updates implementation according to version 5.80 of the spec (valid from 2019-09-30)
• 5.70.0 - updates implementation according to version 5.70 of the spec (valid from 2019-05-27)
• 5.50.0 - updates implementation according to version 5.50 of the spec (valid from 2019-03-18)
• 5.40.0 - updates implementation according to version 5.40 of the spec (valid from 2019-01-28)
• 5.30.0 - updates implementation according to version 5.30 of the spec (valid from 2018-11-26)
• 5.20.0 - updates implementation according to version 5.20 of the spec (valid from 2018-10-22)
• 5.10.0 - updates implementation according to version 5.10 of the spec (valid from 2018-09-17)
• 5.0.0 - updates implementation according to version 5.00 of the spec (valid from 2018-08-06)
• 1.9.0 - updates implementation according to version 4.90 of the spec (valid from 2018-07-02)
• 1.8.0 - updates implementation according to version 4.80 of the spec (valid from 2018-04-16)
• 1.7.0 - updates implementation according to version 4.70 of the spec (valid from 2018-03-26)
• 1.6.0 - updates implementation according to version 4.60 of the spec (valid from 2017-10-09)
• 1.5.0 - updates implementation according to version 4.40 of the spec (valid from 2017-08-21)
• 1.4.0 - updates implementation according to version 4.30 of the spec (valid from 2017-07-03)
• 1.3.0 - updates implementation according to version 4.20 of the spec (valid from 2017-06-12)
• 1.2.0 - updates implementation according to version 4.10 of the spec (valid from 2017-03-06)
• 1.1.0 - updates implementation according to version 4.00 of the spec (valid from 2017-01-09)
• 1.0.2 - adds Scala 2.12 to the released artifacts
• 1.0.1 - better support for plain Java
• 1.0.0 - initial release, spec version 3.90