Language / 语言选择: English | 中文文档

A comprehensive toolkit for generating test credit card numbers and related information, designed specifically for payment system development and testing environments.

• Features
• System Requirements
• Project Architecture
• Quick Start
• API Documentation
• Userscripts
• FAQ

• Generate valid test card numbers compliant with Luhn algorithm
• Support multiple card types: Visa, MasterCard, Discover, JCB
• Auto-generate expiration dates (MM/YYYY) and CVV codes
• Support both batch and single card generation
• Database persistence storage

• Auto-fetch geolocation based on real IP
• Reverse geocoding using OpenStreetMap
• Generate complete address information (house number, street, city, state, postal code)
• Auto-match country codes

• Generate random test user names
• Generate phone numbers in country-specific formats
• Generate SSN/ID numbers
• Support multi-country user information (based on IP geolocation)

• StripeHelper - Auto-fill Stripe payment forms
• GenCreditNum - Credit card number generation and management interface
• GeoUserInfo - Geolocation and user information retrieval
• Intelligent form field recognition
• One-click copy functionality
• Draggable floating window

• API Key authentication mechanism
• Configurable authentication toggle
• Request header validation (x-api-key)

• Node.js >= 18.0.0
• pnpm >= 10.0.0
• PostgreSQL >= 14
• Browser Extension: Tampermonkey (Chrome/Firefox/Edge)

creditcardcrack/
├── packages/
│   ├── api-server/              # Backend API service
│   │   ├── src/
│   │   │   ├── server.js        # Fastify server entry
│   │   │   ├── controllers/     # Business logic controllers
│   │   │   │   └── cardController.js
│   │   │   ├── routes/          # API route definitions
│   │   │   │   └── cardRoutes.js
│   │   │   ├── hooks/           # Request hooks (authentication)
│   │   │   │   └── apiKeyAuth.js
│   │   │   └── db/              # Database client
│   │   │       └── prismaClient.js
│   │   ├── prisma/
│   │   │   ├── schema.prisma    # Data model definitions
│   │   │   └── migrations/      # Database migrations
│   │   └── package.json
│   │
│   └── userscripts/             # Browser userscripts
│       ├── StripeHelper.user.js      # Stripe form helper
│       ├── GenCreditNum.user.js      # Card number generator
│       ├── GeoUserInfo.user.js       # Geo info retrieval
│       └── GeoUserInfo.lib.js        # Shared library
│
├── package.json                 # Root project config
├── CLAUDE.md                    # AI assistant guide
└── README.md                    # Project documentation

Backend:

• Fastify - High-performance web framework
• Prisma - Modern ORM
• PostgreSQL - Relational database
• Swagger/OpenAPI - API documentation

Frontend/Scripts:

• Tampermonkey - Userscript manager
• GM API - Cross-origin requests and storage

git clone https://github.com/yourusername/creditcardcrack.git
cd creditcardcrack

pnpm install

Create packages/api-server/.env file:

# Database connection
DATABASE_URL="postgresql://user:password@localhost:5432/creditcards?schema=public"

# Server configuration
HOST="0.0.0.0"
PORT="3227"

# API authentication (optional)
REQUIRE_API_KEY=true
API_KEY=your_secret_api_key_here

Authentication Notes:

• REQUIRE_API_KEY=false - Disable authentication (local development only)
• REQUIRE_API_KEY=true - Enable authentication (recommended for production)

# Run database migrations
pnpm db:migrate

# (Optional) Open database management interface
pnpm db:studio

# Production mode
pnpm start:api

# Development mode (with hot reload)
pnpm dev:api

Server will run at http://localhost:3227

1. Install Tampermonkey browser extension
2. Open Tampermonkey Dashboard
3. Click "Utilities" → "Import"
4. Select files from packages/userscripts/ directory:
   • GeoUserInfo.lib.js (must install first)
   • StripeHelper.user.js
   • GenCreditNum.user.js
   • GeoUserInfo.user.js

Visit the following URLs and click install:

• http://localhost:3227/scripts/StripeHelper.user.js
• http://localhost:3227/scripts/GenCreditNum.user.js
• http://localhost:3227/scripts/GeoUserInfo.user.js

First-time Use: When API Key authentication is enabled, userscripts will prompt for API Key on first API call. The key will be saved automatically.

Access Swagger documentation after starting the server:

http://localhost:3227/documentation

All requests require x-api-key header (if authentication is enabled).

GET /random-card?type=visa

Query Parameters:

• type (optional): Card type - visa, mastercard, discover, jcb

Response Example:

{
  "success": true,
  "card": {
    "card_type": "VISA",
    "card_number": "4532123456789012",
    "expire_month": "12",
    "expire_year": "2028",
    "cvv": "123",
    "formatted_info": "4532 1234 5678 9012 | 12/2028 | 123"
  }
}

POST /save-cards
Content-Type: application/json

{
  "cards": [
    {
      "card_type": "VISA",
      "card_number": "4532123456789012",
      "expire_month": "12",
      "expire_year": "2028",
      "cvv": "123",
      "formatted_info": "4532 1234 5678 9012 | 12/2028 | 123"
    }
  ]
}

DELETE /card/4532123456789012

PUT /card/4532123456789012
Content-Type: application/json

{
  "expire_month": "06",
  "expire_year": "2029"
}

GET /stats

Response Example:

{
  "success": true,
  "stats": {
    "total": 150,
    "by_type": [
      { "card_type": "VISA", "count": 80 },
      { "card_type": "MASTERCARD", "count": 70 }
    ]
  }
}

Applicable Pages:

• https://checkout.stripe.com/c/pay*
• https://billing.stripe.com/p*

Features:

• Auto-fill credit card information
• Auto-fill billing address
• One-click copy card number/CVV/postal code
• Delete used card numbers

Usage:

1. Visit Stripe payment page
2. Click "Generate Credit Card" button in floating window
3. Select card type (Visa/MasterCard/Discover/JCB)
4. Click "Get Address Info" to auto-fill address
5. Form will be auto-filled

Applicable Pages:

• https://uncoder.eu.org/cc-checker/*

Features:

• Generate single or batch credit card numbers
• Real-time Luhn algorithm validation
• One-click copy functionality
• Save to database

Applicable Pages:

• https://uncoder.eu.org/cc-checker/*

Features:

• Fetch geolocation based on IP
• Generate complete address information
• Generate random user information
• Auto-match country codes

Issue: Error: Can't reach database server

Solutions:

• Confirm PostgreSQL service is running
• Verify DATABASE_URL in .env is correct
• Check database user permissions
• Confirm database is created: CREATE DATABASE creditcards;

Issue: No floating window after script installation

Solutions:

• Confirm Tampermonkey is enabled
• Check if script runs on correct website (check @match rules)
• Open browser console for error messages
• Confirm GeoUserInfo.lib.js is properly installed

Issue: {"success": false, "error": "Missing API key"}

Solutions:

• Confirm REQUIRE_API_KEY=true in .env
• Enter correct API Key in userscript
• Check if request header contains x-api-key
• For local testing, set REQUIRE_API_KEY=false

Issue: CORS error

Solutions:

• Confirm @connect directive in Tampermonkey includes target domain
• API server has CORS enabled (default configuration)
• Use GM_xmlhttpRequest instead of fetch

Issue: Luhn algorithm validation failed

Solutions:

• Check if BIN prefix is correct
• Confirm card number length is 16 digits
• Verify Luhn checksum calculation in generation logic

Issue: OpenStreetMap API returns error

Solutions:

• Check network connection
• Confirm IP geolocation service is available
• OSM Nominatim has rate limits (1 request/second)
• Consider adding User-Agent and email parameters

Issue: Slow when generating large batches

Solutions:

• Recommend generating no more than 100 cards per batch
• Use database caching to improve performance
• Consider using database transactions for batch operations
• Monitor database connection pool

Issue: Concerns about data storage

Solutions:

• All generated data is test data only
• Data stored locally in your database
• No real user information is collected
• Regularly clean test data
• Never use in production environment

This tool is for educational purposes and development testing only. It must not be used for any illegal activities. Users are solely responsible for any consequences arising from misuse of this tool.

This project is for educational and testing purposes only.

1. Fork the project
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add some AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Create Pull Request

• Submit an Issue on GitHub