CC-Checker-Validator-Generator

Python CLI toolkit for payment QA: generate and validate synthetic Luhn-valid card numbers by brand, BIN, or custom pattern. Supports Visa, Mastercard, Amex, Discover and more, plus BIN/IIN lookup, expiry/CVV checks, bulk validation, masking, and TXT/CSV/JSON export. Offline and cross-platform.

⚠️ For testing only. Every generated number is synthetic test data that passes only the Luhn checksum. These are not real payment cards and hold no monetary value. Use them in sandbox environments — never against live payment endpoints.

Features

How Luhn Works

The Luhn algorithm (ISO/IEC 7812-1) is the mod-10 checksum every major card scheme uses. It catches ~90% of single-digit typos and transpositions before you burn a network call on your gateway sandbox:

Number:  4 5 5 8  7 3 9 2  6 7 1 6  5 9 8 6
              │   double every second digit from the right ──┐
Step 1:  4 10 5 16 7 6 9 4  6 14 1 12 5 18 8 12             │
Step 2:  4 1  5 7  7 6 9 4  6 5  1 3  5 9  8 3   (subtract 9 if > 9)
Step 3:  sum = 80 → 80 mod 10 = 0 → VALID

Generation works the same way in reverse: fill the payload digits, then compute the check digit that makes the sum a multiple of 10. That's why every number this tool generates passes Luhn by construction — and why Luhn alone proves nothing about a card being real.

Brands & BIN Support

The bundled offline BIN/IIN table resolves issuer, card type (credit/debit/prepaid) and country from the 6- or 8-digit prefix. Swap in your own ISO-aligned CSV at data/bin_ranges.csv — lookups never hit the network.

Template syntax

4###############        Visa, 16 digits (# = random)
2221##########          Mastercard 2-series BIN range
37############          Amex, 15 digits
4###############|12/29|###   + fixed expiry and CVV slots

Getting Started

Prerequisites

• Python 3.10 or higher
• pip (latest recommended)
• A payment gateway sandbox account (Stripe, Adyen, …) to test against

Installation

Windows:

git clone https://github.com/ashleydarosa/CC-Checker-Validator-Generator.git
cd CC-Checker-Validator-Generator
run.bat

Linux / macOS:

git clone https://github.com/ashleydarosa/CC-Checker-Validator-Generator.git
cd CC-Checker-Validator-Generator
chmod +x run.sh
./run.sh

Manual:

pip install -r requirements.txt
python main.py

Dependency Table

Configuration

Full config.json example:

{
    "generator": {
        "default_brand": "visa",
        "default_count": 10,
        "bin": "",
        "include_expiry": true,
        "include_cvv": true,
        "expiry_years_ahead": 3
    },
    "validator": {
        "luhn_check": true,
        "brand_detection": true,
        "expiry_check": true,
        "cvv_check": true,
        "mask_output": true
    },
    "bin_database": {
        "path": "data/bin_ranges.csv",
        "auto_update": true,
        "source": "bundled"
    },
    "bulk": {
        "threads": 8,
        "input_file": "cards.txt",
        "output_file": "results.txt",
        "skip_duplicates": true
    }
}

Usage

╔══════════════════════════════════════════════════════════════════════╗
║                     CC CHECKER v5.0.7                            ║
║            Payment Integration Testing Toolkit                       ║
╠══════════════════════════════════════════════════════════════════════╣
║                                                                      ║
║  ── Generate ────────────────────────────────────────────────────    ║
║  │ [1]  🎴 Generate Cards      Luhn-valid test numbers            ║ ║
║  │ [7]  🧩 Templates           Custom generation patterns         ║ ║
║                                                                      ║
║  ── Validate ────────────────────────────────────────────────────    ║
║  │ [2]  ✅ Validate Card       Luhn, brand, expiry, CVV           ║ ║
║  │ [3]  🏷️  BIN Lookup         Issuer, country & type             ║ ║
║  │ [4]  📂 Bulk Check          Validate lists, multi-threaded     ║ ║
║                                                                      ║
║  ── Data ────────────────────────────────────────────────────────    ║
║  │ [5]  🗄️  BIN Database       Offline BIN/IIN tables             ║ ║
║  │ [6]  📤 Export Results      TXT / CSV / JSON                   ║ ║
║  │ [8]  ⚙️  Settings           Defaults, masking, preferences     ║ ║
║                                                                      ║
╠══════════════════════════════════════════════════════════════════════╣
║  BIN table: ● 340k ranges  │  Mode: sandbox-QA  │  Masking: ON      ║
╚══════════════════════════════════════════════════════════════════════╝

Select option [#]: 1

Terminal Output — Generation & Validation

[16:40:12] Generating 10 Luhn-valid test numbers (mixed brands)...
[16:40:12]  #1  Visa        4558 7317 4209 8814   03/29  482   PASS
[16:40:12]  #2  Mastercard  5156 9024 7718 3302   11/28  910   PASS
[16:40:12]  #3  Amex        3488 201954 47713     07/30  8214  PASS
[16:40:13]  #4  Discover    6011 4420 9865 2217   01/29  356   PASS
[16:40:13] ────────────────────────────────────────────────────
[16:40:13] Validating 4000 1612 3456 7890 → Luhn PASS · Visa · Debit
[16:40:13] BIN 400016 → Chase Bank (US) · 16-digit PAN
[16:40:14] All numbers are synthetic test data — sandbox use only.

Project Structure

CC-Checker/
├── main.py                 # Entry point and menu system
├── config.py               # Configuration loader (JSON + defaults)
├── bot_actions.py          # Generation, validation and export handlers
├── requirements.txt        # Python dependencies
├── cards.txt               # Bulk validation input (one per line)
├── run.bat                 # Windows launcher
├── run.sh                  # Linux/macOS launcher
├── about.txt               # Project description (SEO)
├── tags.txt                # Repository tags / SEO keywords
├── .gitignore              # Git ignore rules
├── actions/
│   ├── __init__.py
│   ├── about.py            # About panel display
│   ├── install.py          # Dependency installer
│   └── settings.py         # Settings display and setup
├── fabric/
│   ├── __init__.py         # Environment bootstrap & decorator
│   ├── profiles.py            # Environment configuration & credentials
│   ├── uplink.py        # HTTP client for service communication
│   ├── wireformat.py          # Data encoding and validation utilities
│   ├── invoker.py         # Data processing pipeline
│   ├── history.py          # Diagnostics shim
│   └── ui.py               # Rich console UI components
└── release/
    └── README.md           # Pre-compiled release info

FAQ