Credit Card BIN Data - Data File Project

This is a data file project similar to tzdata, providing credit card BIN (Bank Identification Number) patterns as a source of truth for other libraries.

This repository contains authoritative data about credit card BIN patterns for validation and brand identification, along with reference implementations in multiple programming languages.

Repository for this gist

📁 Project Structure

bin-cc/
├── data/                    # Credit card BIN data
│   ├── sources/            # Source data files (editable)
│   │   ├── visa.json
│   │   ├── mastercard.json
│   │   └── ...
│   ├── compiled/           # Compiled enhanced format
│   │   └── brands.json
│   ├── brands.json         # Legacy format (auto-generated)
│   ├── SCHEMA.md           # Data schema documentation
│   └── README.md           # Data usage guide
│
├── scripts/                # Build and validation tools
│   └── build.js            # Compiles source → compiled data
│
├── libs/                   # Reference implementations
│   └── javascript/         # JavaScript/Node.js implementation
│
├── examples/               # Usage examples in different languages
│   ├── javascript-example.js
│   ├── python/
│   ├── elixir/
│   ├── ruby/
│   └── dotnet/
│
├── CONTRIBUTING.md         # Contribution guidelines
└── package.json            # Build scripts

🎯 Data Source

The authoritative data follows a build system similar to browserslist:

• Source files data/sources/*.json - Human-editable card scheme definitions
• Build script scripts/build.js - Compiles and validates data
• Compiled data data/compiled/brands.json - Enhanced format with full details
• Legacy data data/brands.json - Backward-compatible format (auto-generated)
• Schema docs data/SCHEMA.md - Complete schema documentation

Data Releases

Data is released separately from library code:

• Location: GitHub Releases
• Tagging: data-vX.Y.Z (e.g., data-v2.0.1)
• Automatic: Releases are created automatically when data/sources/ changes
• Files included: brands.json, compiled/brands.json, sources/*.json

Building the Data

npm run build

This compiles source files into both enhanced and legacy formats with validation.

📚 Library Implementations

All libraries provide the same core functionality for credit card BIN validation and brand identification.

JavaScript/Node.js

Complete implementation in libs/javascript/

Installation:

npm install creditcard-identifier

Usage:

const cc = require('creditcard-identifier');
console.log(cc.findBrand('4012001037141112')); // 'visa'

See JavaScript documentation for details.

Python

Complete implementation in libs/python/

Installation:

pip install creditcard-identifier

Usage:

from creditcard_identifier import find_brand
print(find_brand('4012001037141112'))  # 'visa'

See Python documentation for details.

Ruby

Complete implementation in libs/ruby/

Installation:

gem install creditcard-identifier

Usage:

require 'creditcard_identifier'
puts CreditcardIdentifier.find_brand('4012001037141112')  # 'visa'

See Ruby documentation for details.

Elixir

Complete implementation in libs/elixir/

Installation: Add to your mix.exs:

{:creditcard_identifier, "~> 1.0"}

Usage:

CreditcardIdentifier.find_brand("4012001037141112")  # "visa"

See Elixir documentation for details.

.NET/C#

Complete implementation in libs/dotnet/

Installation:

dotnet add package CreditCardIdentifier

Usage:

using CreditCardIdentifier;
CreditCard.FindBrand("4012001037141112");  // "visa"

See .NET documentation for details.

🎴 Supported Card Brands

Brand	Starts with	Max length	CVV length
Visa	4, 6367	13, 16	3
Mastercard	5, 222100 to 272099	16	3
Diners	301, 305, 36, 38	14, 16	3
Elo	4011, 401178, 401179, 431274, 438935, etc.	16	3
Amex	34, 37	15	4
Discover	6011, 622, 64, 65	16	4
Aura	50	16	3
Hipercard	38, 60	13, 16, 19	3

Note: Some Brazilian brands (Elo, Hipercard, Aura) do not have official public documentation. Patterns collected from real-world usage.

🤝 Contributing

Contributions are welcome! This project follows a source → build → compiled workflow:

1. Data updates: Edit source files in data/sources/
2. Build: Run npm run build to compile and validate
3. Test: Ensure npm test passes
4. Document: Cite sources in your PR description

See CONTRIBUTING.md for detailed guidelines.

Quick Start for Contributors

# Edit a source file
vim data/sources/visa.json

# Build and validate
npm run build

# Test
npm test

# Commit changes (both source and generated files)
git add data/sources/visa.json data/brands.json data/compiled/brands.json
git commit -m "Update Visa BIN patterns"

📝 License

MIT License

👥 Contributors

• @jotafelipe
• @ahonorato
• @renatoelias

Bandeira	Começa com	Máximo de número	Máximo de número cvc
Visa	4, 6367	13,16	3
Mastercard	5, 222100 à 272099	16	3
Diners	301, 305, 36, 38 link	14,16	3
Elo	4011, 401178, 401179, 431274, 438935, 451416, 457393, 4576, 457631, 457632, 504175, 504175, 506699 à 506778, 509000 à 509999, 627780, 636297, 636368, 636369, 650031 à 650033, 650035 à 650051, 650405 à 650439, 650485 à 650538, 650541 à 650598, 650700 à 650718, 650720 à 650727, 650901 à 650920, 651652 à 651679, 655000 à 655019, 655021 à 655058	16	3
Amex	34,37	15	4
Discover	6011, 622, 64, 65	16	4
Aura	50	16	3
jcb	35	16	3
Hipercard	38,60	13,16,19	3

Contribuidores

• @jotafelipe
• @ahonorato
• @renatoelias