Professional Telegram bot for credit card BIN validation and payment gateway testing. Built with Python, Pyrogram, and async architecture for high performance and reliability.
- BIN Lookup System: Retrieve detailed credit card BIN information including bank, country, card type, and level
- Multiple Payment Gateways: 25+ integrated payment gateway checkers for comprehensive testing
- Mass Checking: Batch processing capabilities for testing multiple cards simultaneously
- Card Generation: Generate valid card numbers from BIN patterns
- Premium Membership System: Multi-tier access control with credits and expiration dates
- User Ranks: Free, Premium, Seller, and Admin hierarchy with different permissions
- Key System: Secure redeemable keys for premium access distribution
- Credit System: Track and manage user checking credits
- Admin Panel: Complete user management, credits allocation, and system configuration
- User Control: Ban/unban users, grant/revoke premium access
- Broadcast System: Send announcements to all users or specific groups
- Anti-spam Protection: Configurable rate limiting and cooldown periods
- Logs Channel: Automated logging of important events and transactions
- Async Architecture: Non-blocking I/O operations for optimal performance
- SQLite Database: Lightweight local storage for users, keys, and BIN data
- Multi-language Support: Configurable response messages
- Error Handling: Comprehensive error management and user feedback
- Session Management: Persistent Telegram sessions
- Python 3.10 or higher
- Telegram Bot Token from @BotFather
- Telegram API credentials from my.telegram.org
- Clone the repository
git clone https://github.com/mat1520/telegram-card-checker-bot.git
cd telegram-card-checker-bot- Create a virtual environment
python -m venv .venv- Activate the virtual environment
Windows:
.venv\Scripts\activateLinux/Mac:
source .venv/bin/activate- Install dependencies
pip install -r requirements.txt- Configure the bot
Edit main.py and set your credentials:
API_ID = 'YOUR_API_ID'
API_HASH = 'YOUR_API_HASH'
BOT_TOKEN = 'YOUR_BOT_TOKEN'
CHANNEL_LOGS = 'YOUR_LOG_CHANNEL_ID'- Run the bot
python main.pymat1520-checker/
├── assets/ # Configuration files and resources
│ ├── banned_bins.json
│ ├── countrys.json
│ ├── gates.json
│ ├── responses.json
│ └── proxies.txt
├── gates/ # Payment gateway checker modules
│ ├── adriana.py
│ ├── aktz.py
│ ├── astharoth.py
│ └── ... (25+ gates)
├── plugins/ # Bot command handlers
│ ├── admin/ # Admin-only commands
│ ├── gates_cmds/ # Gateway command handlers
│ ├── handlers/ # Message handlers
│ └── users/ # User commands
├── utilsdf/ # Utility functions and database
│ ├── db.py # Database operations
│ ├── functions.py # Helper functions
│ ├── vars.py # Constants and variables
│ └── generator.py # Card generation utilities
├── main.py # Bot entry point
└── requirements.txt # Python dependencies
/start- Initialize bot and display welcome message/cmds- Display all available commands/bin <bin>- Retrieve BIN information/gbin <bin>- Generate card numbers from BIN/id- Display user ID and account status/plan- Check subscription plan details/key <key>- Redeem premium access key
Format: /gatename cc|mm|yyyy|cvv
Available gateways: adriana, aktz, astharoth, boruto, brenda, darkito, devilsx, djbaby, ghoul, hinata, hoshigaki, ka, ko, lynx, odali, pepe, pussy, rohee, sebas, sexo, zukesito
Example:
/adriana 4111111111111111|12|2025|123
/addpremium <user_id> <days> <credits>- Grant premium membership/removepremium <user_id>- Revoke premium membership/ban <user_id>- Ban user from bot/unban <user_id>- Unban user/broadcast <message>- Send message to all users/setantispam <seconds>- Configure rate limiting delay/addgp- Add group to whitelist/key- Manage premium access keys
SQLite databases are automatically created on first run:
db_bot.db- User data, memberships, and keysbins.db- BIN information cache
Configure payment gateway settings:
{
"gate_name": {
"status": true,
"response": "Gateway response message",
"cc": "Required format: xxxx xxxx xxxx xxxx|mm|yyyy|cvv"
}
}Customize bot response messages and templates.
Define blocked BINs to prevent checking.
Verify gateway functionality with test scripts:
python test_gates_direct.pyGenerates detailed test reports for all configured gateways.
- Create gateway file in
gates/directory - Implement async function:
async def your_gate(cc: str, month: str, year: str, cvv: str) -> tuple:
# Gateway testing logic
return status, message- Create command handler in
plugins/gates_cmds/ - Update
assets/gates.jsonconfiguration
- Follow PEP 8 guidelines
- Use async/await for I/O operations
- Implement proper error handling and logging
- Document complex functions with docstrings
- Each user account maintains a credit balance
- Credits are consumed per gateway check operation
- Admins can allocate credits to users
- Free: Limited access to basic features
- Premium: Full gateway access with credits
- Seller: Advanced features for resellers
- Admin: Complete system control
- Generate redeemable keys for premium access
- Configure duration and credits per key
- Track key usage and redemption history
Implement rate limiting to prevent abuse:
/setantispam 5Sets a 5-second cooldown between command executions.
Retrieve detailed card information:
- Card brand identification (Visa, Mastercard, American Express, Discover)
- Card type classification (Credit, Debit, Prepaid)
- Card level determination (Classic, Gold, Platinum, Business)
- Issuing bank information
- Country of origin
- Additional BIN metadata
- Store sensitive credentials in environment variables
- Never commit tokens or API keys to version control
- Telegram handles user authentication
- Rate limiting prevents system abuse
- Admin operations restricted by user ID verification
Configure credentials securely:
import os
API_ID = os.getenv('TELEGRAM_API_ID')
API_HASH = os.getenv('TELEGRAM_API_HASH')
BOT_TOKEN = os.getenv('TELEGRAM_BOT_TOKEN')Create a .env file:
TELEGRAM_API_ID=your_api_id
TELEGRAM_API_HASH=your_api_hash
TELEGRAM_BOT_TOKEN=your_bot_tokenContributions are welcome. Please follow these steps:
- Fork the repository
- Create a feature branch:
git checkout -b feature/new-gateway - Commit changes:
git commit -m 'Add new payment gateway' - Push to branch:
git push origin feature/new-gateway - Submit a Pull Request
See CONTRIBUTING.md for detailed guidelines.
This software is provided for educational and testing purposes only. Users are solely responsible for compliance with all applicable laws and regulations. The developers assume no liability for misuse or damages.
Important:
- Do not use for unauthorized transactions
- Respect payment gateway terms of service
- Obtain proper authorization before testing
- Comply with local and international laws
Licensed under the MIT License. See LICENSE file for complete terms.
Built with:
Get help:
- Report bugs via GitHub Issues
- Review documentation in
/docs - Check existing issues before creating new ones
- Consult INSTALLATION.md for setup help
Keep your installation current:
git pull origin main
pip install -r requirements.txt --upgrade
python main.pyTelegram Card Checker Bot - Professional BIN validation and gateway testing platform