1.2.0 • Published 4 years ago

ccc-util v1.2.0

Weekly downloads
3
License
MIT
Repository
github
Last release
4 years ago

Build Status Coverage Status

CCC Util

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

OptionTypeRequiredDescription
cccStringtrue
optionsObject falseOption 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 CodeBank Name
ES0049Banco Santander, S.A.
ES2038Bankia, S.A.
ES8832Bankinter Consumer Finance, E.F.C., S.A.
ES0128Bankinter, S.A.
ES2100CaixaBank, S.A.
ES1465ING Bank, N.V. S.E
ES2095Kutxabank, S.A.
ES2048Liberbank, S.A.
ES0073Open Bank, S.A.

Available validators

  • Spain account validator.
  • NZ account validator

Reference