📚 Documentation

🚀 Getting Started

Card Generator is easy to use. Simply select your desired options and click "Generate" to create valid test credit card numbers.

Basic Usage

1. Navigate to the Generator page
2. Choose between Basic mode (preset networks) or Advanced mode (custom BIN)
3. Configure your options (quantity, format, expiration, CVV)
4. Click "Generate"
5. Copy and use the generated cards in your test environment

💳 Basic Mode

Basic mode allows you to generate cards from predefined card networks.

Available Networks

• Random: Randomly selects from all available networks
• Visa: World's most widely accepted card network
• Mastercard: Global payment solutions provider
• American Express: Premium cards with 4-digit CVV
• Discover: Popular US card network
• Diners Club: Business and travel cards
• Maestro: International debit card service
• UnionPay: Chinese card issuer with global reach

🎯 Advanced Mode

Advanced mode gives you full control with custom BIN support and additional features.

Custom BIN

Enter your own Bank Identification Number (6-16 digits). The system will complete it to 16 digits and add a valid Luhn check digit.

Money Features

Enable the Money toggle to add currency and balance information to generated cards. Perfect for comprehensive testing scenarios.

📊 Output Formats

CARD Format

4532 0123 4567 8901 | 12/25 | 123

PIPE Format

4532012345678901|12|2025|123

CSV Format

Card Number,Expiration Month,Expiration Year,CVV,Network
4532012345678901,12,2025,123,visa

SQL Format

INSERT INTO cards (card_number, exp_month, exp_year, cvv, network) VALUES
('4532012345678901', '12', '2025', '123', 'visa');

JSON Format

[
  {
    "network": "visa",
    "cardNumber": "4532012345678901",
    "expMonth": "12",
    "expYear": "2025",
    "cvv": "123"
  }
]

XML Format

<?xml version="1.0" encoding="UTF-8"?>
<cards>
  <card>
    <number>4532012345678901</number>
    <expMonth>12</expMonth>
    <expYear>2025</expYear>
    <cvv>123</cvv>
    <network>visa</network>
  </card>
</cards>

🔌 API Reference

Generate Cards (Basic Mode)

{
  "action": "generate",
  "network": "visa",
  "quantity": 10,
  "format": "card",
  "includeDate": true,
  "includeCvv": true,
  "expirationMonth": "random",
  "expirationYear": "random"
}

Generate Cards (Advanced Mode)

{
  "action": "generateAdvance",
  "customBin": "453590",
  "quantity": 10,
  "format": "pipe",
  "includeDate": true,
  "includeCvv": true,
  "includeMoney": true,
  "currency": "USD",
  "balance": "500-1000"
}

Response Format

{
  "success": true,
  "data": {
    "cards": [...],
    "formatted": "...",
    "count": 10
  },
  "message": "Cards generated successfully"
}

✓ Luhn Algorithm

All generated cards use the Luhn algorithm (mod 10 algorithm) to calculate the check digit. This ensures that all generated numbers pass basic validation checks used by payment systems.

How It Works

1. Starting from the rightmost digit (excluding the check digit), double every second digit
2. If doubling results in a number greater than 9, subtract 9
3. Sum all the digits
4. The check digit is the amount needed to make the total a multiple of 10

Example

Card number: 453590123456789X (X = check digit)
Process: [4,5,3,5,9,0,1,2,3,4,5,6,7,8,9]
After doubling: [4,10,3,10,9,0,1,4,3,8,5,12,7,16,9]
After subtraction: [4,1,3,1,9,0,1,4,3,8,5,3,7,7,9]
Sum: 65
Check digit: (10 - (65 % 10)) % 10 = 5
Final card: 4535901234567895

⚠️ Important Reminders

These are test cards only! They cannot be used for real transactions. Use them only in test/development environments. For production testing, always use official test cards provided by payment processors (Stripe, PayPal, etc.).