ccc-util

Util to validate CCC code. It also can be used to generate a valid CCC for testing purposes

Usage no npm install needed!

<script type="module">
  import cccUtil from 'https://cdn.skypack.dev/ccc-util';
</script>

README

Build Status Coverage Status

CCC Util

This module provides a validate method to check if a given CCC is valid or not.

Option Type Required Description
ccc String true
options Object  false Option available: institution

Note

Due the different logic to validate a bank account depending on the Country. This validator is only valid for Spain bank accounts. If you are interested in this validator and you want to add a new country, you can:

  • Open an issue like this:

Title: Add support for new Country

  • Country: New country
  • Validation: Link to info about how to validade the account
  • List with entinty codes for banks: Link or file which contains a list with all the banks and entity codes
  • Open a Pull request adding your own validation.

Install

npm i ccc-util --save-dev

Usage

Passing only a CCC

Use this if you are interested in validate only the account number.

const { validate } = require('ccc-util');

validate('0144 9181 1115 8790 3375'); //=> true
validate('0144-9181-1115-8790-3375'); //=> true
validate('  0144 -9181-1115-8790-3375'); //=> true

validate('0137081073'); //=> false

validate('0049-1500-05-1234567890'); //=> false

Passing CCC and institution name

Optionally you can pass a second argument to validate method, the institution. If passed ccc-util will validate the account number with the institution name. If both are valid the result will be true, false otherwise.

const { validate } = require('ccc-util');

validate('0144 9181 1115 8790 3375', { institution: 'BNP Paribas Securities Services, S.E.') //=> true
validate('0144 9181 1115 8790 3375', { institution: 'BNP Paribas Securities Services') //=> false

Codes of banking entities in Spain

Passing institution: 'Name of Institution' to ccc-util will validate the bank account number and the entity number (first four numbers of CCC).

In the list below you will find some of the codes of monetary financial institutions of Spain. You can find all of them in Banco de España official's page

Entity Code Bank Name
ES0049 Banco Santander, S.A.
ES2038 Bankia, S.A.
ES8832 Bankinter Consumer Finance, E.F.C., S.A.
ES0128 Bankinter, S.A.
ES2100 CaixaBank, S.A.
ES1465 ING Bank, N.V. S.E
ES2095 Kutxabank, S.A.
ES2048 Liberbank, S.A.
ES0073 Open Bank, S.A.

Available validators

  • Spain account validator.
  • NZ account validator

Reference