v1.0.0 — MIT License

Valide bancos brasileiros
com simplicidade

Biblioteca Node.js que valida bancos brasileiros e gera ícones SVG usando CSV oficial do Banco Central.

Comece em segundos

$ npm install bank-check-br

Por que usar bank-check-br?

Fonte Oficial

Dados do CSV oficial do Banco Central do Brasil. Sempre atualizados e confiáveis.

Cache em Memória

Consultas rápidas após a primeira carga. Cache inteligente com timestamp.

40+ Ícones SVG

Ícones de bancos brasileiros via @edusites/bancos-brasil. Prontos para usar.

Zero Config

Funciona sem configuração. API intuitiva e simples de usar.

100% TypeScript

Tipos completos para melhor DX. Suporte a ESM e CJS.

Leve e Rápido

Bundle ~16KB. Zero dependências desnecessárias.

Bancos Suportados

Mais de 40 bancos brasileiros com ícones SVG

BB
itaú Itaú
nu Nubank
Santander
Inter Inter
C6 C6 Bank
BTG BTG
XP XP
InfinitePay
PicPay PicPay
Original Original
Caixa Caixa

Simples de usar

Valide bancos e gere SVGs em poucas linhas

exemplo.ts
// Importar funções
import { validarBanco, buscarBanco, gerarSVG } from 'bank-check-br';

// Validar banco por código
const banco = await validarBanco('001');
console.log(banco?.nomeExtenso); // "Banco do Brasil"

// Buscar com SVG incluído
const comSvg = await buscarBanco('341', { includeSvg: true });
console.log(comSvg?.svg); // "<svg>...</svg>"

// Gerar SVG diretamente
const svg = gerarSVG('Nubank');

API Completa

validarBanco(codigo) async

Valida e retorna banco por código

buscarBanco(codigo) async

Busca banco por código de agência

buscarBancoPorISPB(ispb) async

Busca banco por ISPB

buscarBancosPorNome(nome) async

Busca bancos por nome

listarBancos() async

Lista todos os bancos

listarBancosComIcone() async

Lista bancos com ícone SVG

gerarSVG(nome) sync

Gera SVG do banco

recarregarDados() async

Recarrega dados do BCB

Comece agora

Instale via npm e comece a validar bancos em segundos

npm install bank-check-br Ver no GitHub