https://github.com/scarfacedeb/credit_card_detector
:credit_card: ruby gem to provide credit card number validation, type detecting and luhn checks
https://github.com/scarfacedeb/credit_card_detector
Last synced: about 2 months ago
JSON representation
:credit_card: ruby gem to provide credit card number validation, type detecting and luhn checks
- Host: GitHub
- URL: https://github.com/scarfacedeb/credit_card_detector
- Owner: scarfacedeb
- License: mit
- Created: 2016-09-19T12:09:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-30T15:02:19.000Z (over 2 years ago)
- Last Synced: 2025-03-14T05:02:12.291Z (3 months ago)
- Language: Ruby
- Homepage: https://rubygems.org/gems/credit_card_detector
- Size: 145 KB
- Stars: 4
- Watchers: 0
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Credit card detector
Gem provides credit card number validator and type detector.
It checks whether or not a given number actually falls within the ranges of possible numbers for given brands and provides an optional Luhn check.
More info about card BIN numbers http://en.wikipedia.org/wiki/Bank_card_number
## Installation
Add this line to your application's Gemfile:
gem 'credit_card_detector'
And then execute:
$ bundle
Or install it yourself as:
$ gem install credit_card_detector
## Usage
The following issuing institutes are accepted:
Name | Key |
--------------------- | ------------|
[American Express](http://en.wikipedia.org/wiki/American_Express) | :amex
[China UnionPay](http://en.wikipedia.org/wiki/China_UnionPay) | :unionpay
[Dankort](http://en.wikipedia.org/wiki/Dankort) | :dankort
[Diners Club](http://en.wikipedia.org/wiki/Diners_Club_International) | :diners
[Elo](https://pt.wikipedia.org/wiki/Elo_Participa%C3%A7%C3%B5es_S/A) | :elo
[Discover](http://en.wikipedia.org/wiki/Discover_Card) | :discover
[Hipercard](http://pt.wikipedia.org/wiki/Hipercard) | :hipercard
[JCB](http://en.wikipedia.org/wiki/Japan_Credit_Bureau) | :jcb
[Maestro](http://en.wikipedia.org/wiki/Maestro_%28debit_card%29) | :maestro
[MasterCard](http://en.wikipedia.org/wiki/MasterCard) | :mastercard
[MIR](http://www.nspk.ru/en/cards-mir/) | :mir
[Rupay](http://en.wikipedia.org/wiki/RuPay) | :rupay
[Solo](http://en.wikipedia.org/wiki/Solo_(debit_card)) | :solo
[Switch](http://en.wikipedia.org/wiki/Switch_(debit_card)) | :switch
[Visa](http://en.wikipedia.org/wiki/Visa_Inc.) | :visa
### Examples
```ruby
number = "4111111111111111"
detector = CreditCardDetector::Detector.new(number)
detector.brand # Visa brand
detector.brand_name # Visa
detector.valid?(:mastercard, :maestro) #false
detector.valid?(:visa, :mastercard) #true
```
### Check luhn
```ruby
CreditCardDetector::Detector.new(number).valid_luhn?
```
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
## Original version
[credit_card_validations](https://github.com/Fivell/credit_card_validations) - provides more extended API, but depends on activemodel and activesupport.