PHPackages carddetective/card-provider-detector - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. carddetective/card-provider-detector ActiveLibrary[Utility & Helpers](/categories/utility) carddetective/card-provider-detector ==================================== A PHP library to detect the card provider from a card number v1.1.0(5mo ago)615.7k↓49%MITPHPPHP ^8.1|^8.2CI passing Since Jan 17Pushed 5mo ago2 watchersCompare [ Source](https://github.com/OmarAbdelazizMahmed/carddetective)[ Packagist](https://packagist.org/packages/carddetective/card-provider-detector)[ RSS](/packages/carddetective-card-provider-detector/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (5)Dependencies (2)Versions (7)Used By (0) Card Detective - Advanced Card Detection & Validation Package ================================================================= [](#card-detective---advanced-card-detection--validation-package) The `card-provider-detector` package is a comprehensive PHP library for detecting card providers, validating card numbers, and providing detailed card information. The package uses the first six digits of the card number (BIN) along with advanced validation algorithms to accurately detect and validate various card types. ✨ Features ---------- [](#-features) - **πŸ” Card Provider Detection**: Supports 12+ major card providers including Visa, MasterCard, American Express, and regional cards - **βœ… Luhn Algorithm Validation**: Built-in validation using the industry-standard Luhn algorithm - **🎭 Card Number Masking**: Secure masking of card numbers for display purposes - **πŸ“ Card Number Formatting**: Format card numbers with custom separators - **πŸ”’ Security Features**: CVV/CVC validation and expiry date checking - **πŸ“Š Detailed Card Information**: Comprehensive card data including type, length, and features - **🌍 Regional Support**: Support for regional card networks (RuPay, UnionPay, Mir, Elo, etc.) - **βš™οΈ Configurable**: Customizable settings and provider configurations - **πŸ›‘οΈ Exception Handling**: Proper error handling with custom exceptions - **πŸ§ͺ Comprehensive Testing**: Extensive test coverage with 50+ test cases - **πŸ“± Laravel Integration**: Seamless Laravel integration with facade and service provider πŸš€ Installation -------------- [](#-installation) Install the package via Composer: ``` composer require carddetective/card-provider-detector ``` πŸ“‹ Requirements -------------- [](#-requirements) - PHP 8.1 or higher - Laravel 5.5+ (for Laravel integration) 🎯 Supported Card Providers -------------------------- [](#-supported-card-providers) ProviderTypeLengthSecurity CodeVisaCredit/Debit13, 16, 193 digitsMasterCardCredit/Debit163 digitsAmerican ExpressCredit154 digitsDiners ClubCredit143 digitsJCBCredit15, 163 digitsDiscoverCredit163 digitsRuPayCredit/Debit163 digitsUnionPayCredit/Debit16-193 digitsMaestroDebit12-19NoneEloCredit163 digitsMirCredit/Debit163 digitsHipercardCredit13, 163 digitsπŸ“– Usage ------- [](#-usage) ### Basic Usage [](#basic-usage) ``` use CardDetective\CardProviderDetector\CardDetection\CardDetective; $detector = new CardDetective(); // Detect card provider $provider = $detector->detectCardProvider('4111111111111111'); echo $provider; // "Visa" // Validate card number $isValid = $detector->isCardNumberValid('4111111111111111'); echo $isValid ? 'Valid' : 'Invalid'; // "Valid" // Mask card number $masked = $detector->maskCardNumber('4111111111111111'); echo $masked; // "4111********1111" // Format card number $formatted = $detector->formatCardNumber('4111111111111111'); echo $formatted; // "4111 1111 1111 1111" ``` ### Advanced Usage - Card Information [](#advanced-usage---card-information) ``` use CardDetective\CardProviderDetector\CardDetection\CardDetective; $detector = new CardDetective(); $cardInfo = $detector->getCardInfo('4111111111111111'); // Access card information echo $cardInfo->provider; // "Visa" echo $cardInfo->type; // "Credit/Debit" echo $cardInfo->length; // 16 echo $cardInfo->validLengths; // [13, 16, 19] echo $cardInfo->hasSecurityCode; // true echo $cardInfo->securityCodeLength; // 3 echo $cardInfo->isValid; // true echo $cardInfo->maskedNumber; // "4111********1111" echo $cardInfo->formattedNumber; // "4111 1111 1111 1111" echo $cardInfo->features; // ["chip", "contactless", "online_payments"] // Convert to array or JSON $array = $cardInfo->toArray(); $json = $cardInfo->toJson(); ``` ### Security Features [](#security-features) ``` // Validate CVV/CVC code $isValidCvv = $detector->isValidSecurityCode('4111111111111111', '123'); echo $isValidCvv ? 'Valid CVV' : 'Invalid CVV'; // Validate expiry date $isValidExpiry = $detector->isValidExpiryDate('12', '2025'); echo $isValidExpiry ? 'Valid expiry' : 'Invalid expiry'; // Check if provider is supported $isSupported = $detector->isProviderSupported('Visa'); echo $isSupported ? 'Supported' : 'Not supported'; // Get all supported providers $providers = $detector->getSupportedProviders(); print_r($providers); // Array of all supported provider names ``` ### Custom Formatting [](#custom-formatting) ``` // Custom mask character $masked = $detector->maskCardNumber('4111111111111111', 'X'); echo $masked; // "4111XXXXXXXX1111" // Custom separator for formatting $formatted = $detector->formatCardNumber('4111111111111111', '-'); echo $formatted; // "4111-1111-1111-1111" ``` πŸ—οΈ Laravel Integration ---------------------- [](#️-laravel-integration) ### Service Provider Registration [](#service-provider-registration) Register the service provider in `config/app.php`: ``` 'providers' => [ // ... CardDetective\CardProviderDetector\Providers\CardDetectiveServiceProvider::class, ], 'aliases' => [ // ... 'CardDetective' => CardDetective\CardProviderDetector\Facades\CardDetective::class, ], ``` ### Using the Facade [](#using-the-facade) ``` use CardDetective; // Detect card provider $provider = CardDetective::detectCardProvider('4111111111111111'); // Get comprehensive card info $cardInfo = CardDetective::getCardInfo('4111111111111111'); // Validate card $isValid = CardDetective::isCardNumberValid('4111111111111111'); // Mask card number $masked = CardDetective::maskCardNumber('4111111111111111'); // Format card number $formatted = CardDetective::formatCardNumber('4111111111111111'); // Security validation $isValidCvv = CardDetective::isValidSecurityCode('4111111111111111', '123'); $isValidExpiry = CardDetective::isValidExpiryDate('12', '2025'); ``` ### Dependency Injection [](#dependency-injection) ``` use CardDetective\CardProviderDetector\CardDetection\CardDetective; class PaymentController extends Controller { public function processPayment(CardDetective $detector) { $cardInfo = $detector->getCardInfo(request('card_number')); if (!$cardInfo->isValid) { return response()->json(['error' => 'Invalid card number'], 400); } // Process payment... } } ``` βš™οΈ Configuration ---------------- [](#️-configuration) Publish the configuration file: ``` php artisan vendor:publish --provider="CardDetective\CardProviderDetector\Providers\CardDetectiveServiceProvider" --tag="carddetective-config" ``` ### Configuration Options [](#configuration-options) ``` // config/carddetective.php return [ // Default mask character 'mask_character' => '*', // Default card number separator 'card_number_separator' => ' ', // Enable strict validation 'strict_validation' => true, // Enabled card providers 'enabled_providers' => [ 'visa', 'mastercard', 'amex', 'diners', 'jcb', 'discover', 'rupay', 'unionpay', 'maestro', 'elo', 'mir', 'hipercard', ], // Custom providers 'custom_providers' => [ 'my_custom_provider' => [ 'regex' => '/^1234[0-9]{0,}$/', 'name' => 'My Custom Provider', 'type' => 'Credit', 'valid_lengths' => [16], 'has_security_code' => true, 'security_code_length' => 3, 'features' => ['chip', 'contactless'], ], ], // Security settings 'security' => [ 'validate_security_code' => true, 'validate_expiry_date' => true, 'expiry_buffer_months' => 0, ], // Logging settings 'logging' => [ 'enabled' => false, 'level' => 'info', 'channel' => 'default', ], ]; ``` πŸ§ͺ Testing --------- [](#-testing) Run the comprehensive test suite: ``` ./vendor/bin/phpunit ``` The package includes 50+ test cases covering: - All supported card providers - Card validation scenarios - Masking and formatting - Security features - Edge cases and error handling - Laravel integration πŸ›‘οΈ Exception Handling --------------------- [](#️-exception-handling) The package includes custom exceptions for better error handling: ``` use CardDetective\CardProviderDetector\Exceptions\InvalidCardNumberException; use CardDetective\CardProviderDetector\Exceptions\UnsupportedCardTypeException; try { $provider = $detector->detectCardProvider(''); } catch (InvalidCardNumberException $e) { // Handle invalid card number echo $e->getMessage(); // "Card number cannot be empty" } ``` πŸ”§ Advanced Features ------------------- [](#-advanced-features) ### Custom Card Providers [](#custom-card-providers) Add support for custom card providers: ``` // In your configuration 'custom_providers' => [ 'my_bank' => [ 'regex' => '/^1234[0-9]{0,}$/', 'name' => 'My Bank Card', 'type' => 'Debit', 'valid_lengths' => [16], 'has_security_code' => true, 'security_code_length' => 3, 'features' => ['chip', 'online_payments'], ], ], ``` ### Batch Processing [](#batch-processing) Process multiple cards efficiently: ``` $cards = ['4111111111111111', '5555555555554444', '378282246310005']; $results = []; foreach ($cards as $card) { $results[] = $detector->getCardInfo($card); } ``` ### API Integration [](#api-integration) Perfect for payment gateway integrations: ``` public function validatePaymentCard($cardNumber, $cvv, $expiryMonth, $expiryYear) { $detector = new CardDetective(); // Validate card number if (!$detector->isCardNumberValid($cardNumber)) { throw new InvalidCardException('Invalid card number'); } // Validate CVV if (!$detector->isValidSecurityCode($cardNumber, $cvv)) { throw new InvalidCardException('Invalid CVV'); } // Validate expiry date if (!$detector->isValidExpiryDate($expiryMonth, $expiryYear)) { throw new InvalidCardException('Card expired'); } // Get card information $cardInfo = $detector->getCardInfo($cardNumber); return [ 'provider' => $cardInfo->provider, 'type' => $cardInfo->type, 'masked_number' => $cardInfo->maskedNumber, 'features' => $cardInfo->features, ]; } ``` 🌟 Use Cases ----------- [](#-use-cases) - **E-commerce Platforms**: Validate customer payment cards - **Payment Gateways**: Detect card types for processing - **Financial Applications**: Secure card number handling - **CRM Systems**: Store masked card information - **Analytics**: Track payment method usage - **Security Audits**: Validate card data integrity πŸ“Š Performance ------------- [](#-performance) - **Fast Detection**: Optimized regex patterns for quick provider detection - **Memory Efficient**: Minimal memory footprint - **Cached Results**: Built-in caching for repeated operations - **Scalable**: Handles high-volume card processing πŸ”’ Security Considerations ------------------------- [](#-security-considerations) - **No Card Storage**: Package doesn't store card numbers - **PCI Compliance**: Designed with PCI DSS guidelines in mind - **Secure Masking**: Proper card number masking for display - **Input Sanitization**: Automatic sanitization of card inputs - **Exception Safety**: Secure error handling without data leakage 🀝 Contributing -------------- [](#-contributing) Contributions are welcome! Please feel free to submit a Pull Request. πŸ“„ License --------- [](#-license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. πŸ‘¨β€πŸ’» Author ---------- [](#‍-author) - [Omar Abdelaziz](https://github.com/OmarAbdelazizMahmed) πŸ†• Changelog ----------- [](#-changelog) ### Version 2.0.0 [](#version-200) - ✨ Added comprehensive card information (CardInfo DTO) - πŸ”’ Added CVV/CVC validation - πŸ“… Added expiry date validation - 🎭 Enhanced card masking with custom characters - πŸ“ Added card number formatting utilities - 🌍 Added support for regional cards (Elo, Mir, Hipercard) - βš™οΈ Added configuration system - πŸ›‘οΈ Added proper exception handling - πŸ§ͺ Expanded test coverage (50+ tests) - πŸ“š Updated documentation ### Version 1.0.0 [](#version-100) - 🎯 Basic card provider detection - βœ… Luhn algorithm validation - 🎭 Basic card masking - πŸ—οΈ Laravel integration --- **⚠️ Disclaimer**: This package is for educational and development purposes. Always follow PCI DSS guidelines and security best practices when handling card data in production environments. ### Health Score 48 β€” FairBetter than 95% of packages Maintenance73 Regular maintenance activity Popularity31 Limited adoption so far Community10 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 93.3% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~266 days Total 5 Last Release 151d ago PHP version history (2 changes)v1.0.1PHP ^7.4|^8.1 v1.1.0PHP ^8.1|^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/1a941a429abd73759a6c31abfc399cf12e88809c7e07f2ff1df9e243dff33089?d=identicon)[omarabdelaziz](/maintainers/omarabdelaziz) --- Top Contributors [![OmarAbdelazizMahmed](https://avatars.githubusercontent.com/u/46730385?v=4)](https://github.com/OmarAbdelazizMahmed "OmarAbdelazizMahmed (28 commits)")[![mo7ameds7awky](https://avatars.githubusercontent.com/u/41241081?v=4)](https://github.com/mo7ameds7awky "mo7ameds7awky (2 commits)") --- Tags php ### Code Quality TestsPHPUnit Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/carddetective-card-provider-detector/health.svg) ``` [![Health](https://phpackages.com/badges/carddetective-card-provider-detector/health.svg)](https://phpackages.com/packages/carddetective-card-provider-detector) ``` PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)