cw_credit_card_validations 3.4.0

data/lib/credit_card_validations.rb

@@ -0,0 +1,36 @@
+require 'credit_card_validations/version'
+require 'credit_card_validations/error'
+require 'active_model'
+require 'active_support/core_ext'
+require 'active_model/validations'
+require 'active_model/credit_card_number_validator'
+require 'yaml'
+
+module CreditCardValidations
+  extend ActiveSupport::Autoload
+  autoload :VERSION, 'credit_card_validations/version'
+  autoload :Luhn, 'credit_card_validations/luhn'
+  autoload :Detector, 'credit_card_validations/detector'
+  autoload :Factory, 'credit_card_validations/factory'
+  autoload :Mmi, 'credit_card_validations/mmi'
+
+
+  def self.add_brand(key, rules, options = {})
+    Detector.add_brand(key, rules, options)
+  end
+
+  DATA = YAML.load_file(File.join(File.dirname(__FILE__),  'data', 'brands.yaml')) || {}
+
+  def self.reload!
+    Detector.brands = {}
+    DATA.each do |key, data|
+      add_brand(key, data.fetch(:rules), data.fetch(:options, {}))
+    end
+  end
+
+end
+
+CreditCardValidations.reload!
+
+
+

data/lib/credit_card_validations/detector.rb

@@ -0,0 +1,148 @@
+# == CreditCardValidations Detector
+#
+# class provides credit card number validations
+module CreditCardValidations
+  class Detector
+
+    include Mmi
+
+    class_attribute :brands
+    self.brands = {}
+
+    attr_reader :number
+
+    def initialize(number)
+      @number = number.to_s.tr('- ', '')
+    end
+
+    # credit card number validation
+    def valid?(*brands)
+      !!valid_number?(*brands)
+    end
+
+    #brand name
+    def brand(*keys)
+      valid_number?(*keys)
+    end
+
+    def valid_number?(*keys)
+      selected_brands = keys.blank? ? self.brands : resolve_keys(*keys)
+      if selected_brands.any?
+        selected_brands.each do |key, brand|
+          return key if matches_brand?(brand)
+        end
+      end
+      nil
+    end
+
+    #check if luhn valid
+    def valid_luhn?
+      @valid_luhn ||= Luhn.valid?(number)
+    end
+
+    def brand_name
+      self.class.brand_name(brand)
+    end
+
+    protected
+
+    def resolve_keys(*keys)
+      brand_keys = keys.map do |el|
+        if el.is_a? String
+          #try to find key by name
+          el = (self.class.brand_key(el) || el).to_sym
+        end
+        el.downcase
+      end
+      self.brands.slice(*brand_keys)
+    end
+
+    def matches_brand?(brand)
+      rules = brand.fetch(:rules)
+      options = brand.fetch(:options, {})
+
+      rules.each do |rule|
+        if (options[:skip_luhn] || valid_luhn?) &&
+            rule[:length].include?(number.length) &&
+            number.match(rule[:regexp])
+          return true
+        end
+      end
+      false
+    end
+
+    class << self
+
+      def has_luhn_check_rule?(key)
+        !brands[key].fetch(:options, {}).fetch(:skip_luhn, false)
+      end
+
+      #
+      # add brand
+      #
+      #   CreditCardValidations.add_brand(:en_route, {length: 15, prefixes: ['2014', '2149']}, {skip_luhn: true}) #skip luhn
+      #
+      def add_brand(key, rules, options = {})
+
+        brands[key] = {rules: [], options: options || {}}
+
+        Array.wrap(rules).each do |rule|
+          add_rule(key, rule[:length], rule[:prefixes])
+        end
+
+        define_brand_method(key)
+
+      end
+
+      def brand_name(brand_key)
+        brand = brands[brand_key]
+        if brand
+          brand.fetch(:options, {})[:brand_name] || brand_key.to_s.titleize
+        else
+          nil
+        end
+      end
+
+      def brand_key(brand_name)
+        brands.detect do |_, brand|
+          brand[:options][:brand_name] == brand_name
+        end.try(:first)
+      end
+
+      # CreditCardValidations.delete_brand(:en_route)
+      def delete_brand(key)
+        key = key.to_sym
+        undef_brand_method(key)
+        brands.reject! { |k, _| k == key }
+      end
+
+      #create rule for detecting brand
+      def add_rule(key, length, prefixes)
+        unless brands.has_key?(key)
+          raise Error.new("brand #{key} is undefined, please use #add_brand method")
+        end
+        length, prefixes = Array(length), Array(prefixes)
+        brands[key][:rules] << {length: length, regexp: compile_regexp(prefixes), prefixes: prefixes}
+      end
+
+      protected
+
+      # create methods like visa?,  maestro? etc
+      def define_brand_method(key)
+        define_method "#{key}?".to_sym do
+          valid?(key)
+        end unless method_defined? "#{key}?".to_sym
+      end
+
+      def undef_brand_method(key)
+        undef_method "#{key}?".to_sym if method_defined? "#{key}?".to_sym
+      end
+
+      #create regexp by array of prefixes
+      def compile_regexp(prefixes)
+        Regexp.new("^((#{prefixes.join(")|(")}))")
+      end
+
+    end
+  end
+end

data/lib/credit_card_validations/error.rb

@@ -0,0 +1,4 @@
+module CreditCardValidations
+  class Error < StandardError
+  end
+end

data/lib/credit_card_validations/factory.rb

@@ -0,0 +1,64 @@
+# == CreditCardValidations Factory
+# Generates card number that passes validation
+#
+# #random
+#   CreditCardValidations::Factory.random
+# #or particular brand
+#   CreditCardValidations::Factory.random(:maestro) # "6010430241237266856"
+#
+#
+#
+module CreditCardValidations
+  class Factory
+    class << self
+      def random(brand = nil)
+        brand = Detector.brands.keys.sample if brand.nil?
+        if Detector.brands[brand].nil?
+          raise Error.new('Unsupported brand')
+        end
+        generate(Detector.brands[brand][:rules].sample)
+      end
+
+      def generate(rule)
+        number(rule[:prefixes].sample, rule[:length].sample, rule.fetch(:options, {})[:skip_luhn])
+      end
+
+      def number(prefix, length, skip_luhn = false)
+        number = prefix.dup
+        1.upto(length - (prefix.length + 1)) do
+          number << "#{rand(9)}"
+        end
+        #if skip luhn
+        if skip_luhn
+          number += "#{rand(9)}"
+        else
+          number += last_digit(number).to_s
+        end
+        number
+      end
+
+      #extracted from darkcoding-credit-card
+
+      def last_digit(number)
+        # Calculate sum
+        sum, pos = 0, 0
+        length = number.length + 1
+
+        reversed_number = number.reverse
+        while pos < length do
+          odd = reversed_number[pos].to_i * 2
+          odd -= 9 if odd > 9
+
+          sum += odd
+
+          sum += reversed_number[pos + 1].to_i if pos != (length - 2)
+
+          pos += 2
+        end
+
+        (((sum / 10).floor + 1) * 10 - sum) % 10
+      end
+
+    end
+  end
+end

data/lib/credit_card_validations/luhn.rb

@@ -0,0 +1,22 @@
+# == CreditCardValidations Luhn
+# simple class to validate Luhn numbers.
+#
+#   Luhn.valid? 4111111111111111
+#
+module CreditCardValidations
+  class Luhn
+    def self.valid?(number)
+      s1 = s2 = 0
+      number.to_s.reverse.chars.each_slice(2) do |odd, even|
+        s1 += odd.to_i
+
+        double = even.to_i * 2
+        double -= 9 if double >= 10
+        s2 += double
+      end
+      (s1 + s2) % 10 == 0
+    end
+  end
+end  
+  
+  

data/lib/credit_card_validations/mmi.rb

@@ -0,0 +1,43 @@
+# == CreditCardValidations Mmi
+#
+# Implements Major Industry Identifier (MII) detection
+#
+# The first digit of a credit card number is the Major Industry Identifier (MII), which represents the category of entity which issued the card. MII digits represent the following issuer categories:
+# 0 – ISO/TC 68 and other future industry assignments
+# 1 – Airlines
+# 2 – Airlines and other future industry assignments
+# 3 – Travel and entertainment and banking/financial
+# 4 – Banking and financial
+# 5 – Banking and financial
+# 6 – Merchandising and banking/financial
+# 7 – Petroleum and other future industry assignments
+# 8 – Healthcare, telecommunications and other future industry assignments
+# 9 – National assignment
+# For example, American Express, Diner's Club, Carte Blanche,
+# and JCB are in the travel and entertainment category;
+# VISA, MasterCard, and Discover are in the banking and financial category (Discover being in the Merchandising and banking/financial category);
+# and Sun Oil and Exxon are in the petroleum category.
+
+
+module CreditCardValidations
+  module Mmi
+
+    ISSUER_CATEGORIES = {
+        '0' => 'ISO/TC 68 nd other industry assignments',
+        '1' => 'Airlines',
+        '2' => 'Airlines and other industry assignments',
+        '3' => 'Travel and entertainment and banking/financial',
+        '4' => 'Banking and financial',
+        '5' => 'Banking and financial',
+        '6' => 'Merchandising and banking/financial',
+        '7' => 'Petroleum and other industry assignments',
+        '8' => 'Healthcare, telecommunications and other industry assignments',
+        '9' => 'National assignment'
+
+    }
+
+    def issuer_category
+      ISSUER_CATEGORIES[@number.to_s[0]]
+    end
+  end
+end

data/lib/credit_card_validations/plugins/diners_us.rb

@@ -0,0 +1,6 @@
+CreditCardValidations.add_brand(
+  :diners_us,
+  { length: 16, prefixes: %w(54 55) },
+  brand_name: 'Diners Club US'
+)
+

data/lib/credit_card_validations/plugins/en_route.rb

@@ -0,0 +1,5 @@
+CreditCardValidations.add_brand(
+  :en_route,
+  { length: 15, prefixes: %w(2014 2149) },
+  skip_luhn: true
+)

data/lib/credit_card_validations/plugins/laser.rb

@@ -0,0 +1,4 @@
+CreditCardValidations.add_brand(
+  :laser,
+  length: [16, 17, 18, 19], prefixes: %w(6304 6706 6771)
+)

data/lib/credit_card_validations/string.rb

@@ -0,0 +1,22 @@
+# String extension for brand detecting and number validation
+#
+#    require 'credit_card_validations/string'
+#    '5274 5763 9425 9961'.credit_card_brand
+#    '5274 5763 9425 9961'.credit_card_brand_name
+#    '5274 5763 9425 9961'.valid_credit_card_brand?(:mastercard, :visa)
+#    '5274 5763 9425 9961'.valid_credit_card_brand?(:amex)
+#
+class String
+  def credit_card_brand
+    CreditCardValidations::Detector.new(self).brand
+  end
+
+  def valid_credit_card_brand?(*brands)
+    CreditCardValidations::Detector.new(self).valid?(*brands)
+  end
+
+  def credit_card_brand_name
+    CreditCardValidations::Detector.new(self).brand_name
+  end
+
+end  

data/lib/credit_card_validations/version.rb

@@ -0,0 +1,3 @@
+module CreditCardValidations
+  VERSION = '3.4.0'
+end

data/lib/data/brands.yaml

@@ -0,0 +1,409 @@
+---
+:visa:
+  :rules:
+  - :length:
+    - 13
+    - 16
+    - 19
+    :prefixes:
+    - '4'
+  :options:
+    :brand_name: Visa
+:mastercard:
+  :rules:
+  - :length:
+    - 16
+    :prefixes:
+    - '2221'
+    - '2222'
+    - '2223'
+    - '2224'
+    - '2225'
+    - '2226'
+    - '2227'
+    - '2228'
+    - '2229'
+    - '223'
+    - '224'
+    - '225'
+    - '226'
+    - '227'
+    - '228'
+    - '229'
+    - '23'
+    - '24'
+    - '25'
+    - '26'
+    - '271'
+    - '2720'
+    - '51'
+    - '52'
+    - '53'
+    - '54'
+    - '55'
+  :options:
+    :brand_name: MasterCard
+:amex:
+  :rules:
+  - :length:
+    - 15
+    :prefixes:
+    - '34'
+    - '37'
+  :options:
+    :brand_name: American Express
+:diners:
+  :rules:
+  - :length:
+    - 14
+    :prefixes:
+    - '300'
+    - '301'
+    - '302'
+    - '303'
+    - '304'
+    - '305'
+    - '36'
+    - '38'
+  :options:
+    :brand_name: Diners Club
+:jcb:
+  :rules:
+  - :length:
+    - 15
+    - 16
+    :prefixes:
+    - '3528'
+    - '3529'
+    - '353'
+    - '354'
+    - '355'
+    - '356'
+    - '357'
+    - '358'
+  - :length:
+    - 15
+    :prefixes:
+    - '1800'
+    - '2131'
+  - :length:
+    - 19
+    :prefixes:
+    - '357266'
+  :options:
+    :brand_name: JCB
+:solo:
+  :rules:
+  - :length:
+    - 16
+    - 18
+    - 19
+    :prefixes:
+    - '6334'
+    - '6767'
+:switch:
+  :rules:
+  - :length:
+    - 16
+    - 18
+    - 19
+    :prefixes:
+    - '633110'
+    - '633312'
+    - '633304'
+    - '633303'
+    - '633301'
+    - '633300'
+:maestro:
+  :rules:
+  - :length:
+    - 12
+    - 13
+    - 14
+    - 15
+    - 16
+    - 17
+    - 18
+    - 19
+    :prefixes:
+    - '500'
+    - '5010'
+    - '5011'
+    - '5012'
+    - '5013'
+    - '5014'
+    - '5015'
+    - '5016'
+    - '5017'
+    - '5018'
+    - '502'
+    - '503'
+    - '504'
+    - '505'
+    - '506'
+    - '507'
+    - '508'
+    - '509'
+    - '56'
+    - '57'
+    - '58'
+    - '59'
+    - '6010'
+    - '6012'
+    - '6013'
+    - '6014'
+    - '6015'
+    - '6016'
+    - '6017'
+    - '6018'
+    - '6019'
+    - '602'
+    - '603'
+    - '604'
+    - '605'
+    - '6060'
+    - '621'
+    - '627'
+    - '629'
+    - '6304'
+    - '639'
+    - '670'
+    - '671'
+    - '672'
+    - '673'
+    - '674'
+    - '675'
+    - '677'
+    - '6760'
+    - '6761'
+    - '6762'
+    - '6763'
+    - '6764'
+    - '6765'
+    - '6766'
+    - '6768'
+    - '6769'
+    - '6771'
+    - '679'
+:unionpay:
+  :rules:
+  - :length:
+    - 16
+    - 17
+    - 18
+    - 19
+    :prefixes:
+    - '622'
+    - '624'
+    - '625'
+    - '626'
+    - '628'
+  :options:
+    :skip_luhn: true
+    :brand_name: China UnionPay
+:dankort:
+  :rules:
+  - :length:
+    - 16
+    :prefixes:
+    - '5019'
+:rupay:
+  :rules:
+  - :length:
+    - 16
+    :prefixes:
+    - '6061'
+    - '6062'
+    - '6063'
+    - '6064'
+    - '6065'
+    - '6066'
+    - '6067'
+    - '6068'
+    - '6069'
+    - '607'
+    - '608'
+  :options:
+    :skip_luhn: true
+:hipercard:
+  :rules:
+  - :length:
+    - 19
+    :prefixes:
+    - '384'
+    - '606282'
+    - '637095'
+    - '637568'
+    - '637599'
+    - '637609'
+    - '637612'
+:elo:
+  :rules:
+  - :length:
+    - 16
+    :prefixes:
+    - '401178'
+    - '401179'
+    - '431274'
+    - '438935'
+    - '451416'
+    - '457393'
+    - '457631'
+    - '457632'
+    - '504175'
+    - '506699'
+    - '50670'
+    - '50671'
+    - '506717'
+    - '506718'
+    - '50672'
+    - '506720'
+    - '506721'
+    - '506724'
+    - '506725'
+    - '506726'
+    - '506727'
+    - '506728'
+    - '506729'
+    - '50673'
+    - '50674'
+    - '50675'
+    - '50676'
+    - '506770'
+    - '506771'
+    - '506772'
+    - '506773'
+    - '506774'
+    - '506775'
+    - '506776'
+    - '506777'
+    - '506778'
+    - '50900'
+    - '509013'
+    - '50902'
+    - '509031'
+    - '509033'
+    - '509035'
+    - '509036'
+    - '509037'
+    - '509038'
+    - '509039'
+    - '50904'
+    - '509050'
+    - '509051'
+    - '509052'
+    - '509053'
+    - '509064'
+    - '509066'
+    - '509067'
+    - '509068'
+    - '509069'
+    - '509072'
+    - '509074'
+    - '509076'
+    - '509077'
+    - '509078'
+    - '509079'
+    - '509080'
+    - '509081'
+    - '509082'
+    - '509083'
+    - '509085'
+    - '636297'
+    - '636368'
+    - '650031'
+    - '650032'
+    - '650033'
+    - '650035'
+    - '650036'
+    - '650037'
+    - '650038'
+    - '650039'
+    - '65004'
+    - '650050'
+    - '650051'
+    - '650405'
+    - '650406'
+    - '650407'
+    - '650408'
+    - '650409'
+    - '65041'
+    - '65042'
+    - '65043'
+    - '650485'
+    - '650486'
+    - '650487'
+    - '650488'
+    - '650489'
+    - '65049'
+    - '65050'
+    - '65051'
+    - '65052'
+    - '650530'
+    - '650531'
+    - '650532'
+    - '650533'
+    - '650534'
+    - '650535'
+    - '650536'
+    - '650537'
+    - '650538'
+    - '650541'
+    - '650700'
+    - '650720'
+    - '650901'
+    - '650921'
+    - '650922'
+    - '650923'
+    - '650924'
+    - '650925'
+    - '650926'
+    - '650927'
+    - '650928'
+    - '650929'
+    - '65093'
+    - '65094'
+    - '65095'
+    - '65096'
+    - '650970'
+    - '650971'
+    - '650972'
+    - '650973'
+    - '650974'
+    - '650975'
+    - '650976'
+    - '650977'
+    - '650978'
+    - '651652'
+    - '65500'
+    - '65501'
+    - '655021'
+    - '65503'
+    - '65504'
+  :options:
+    :skip_luhn: true
+    :brand_name: Elo
+:mir:
+  :rules:
+  - :length:
+    - 16
+    :prefixes:
+    - '2200'
+    - '2201'
+    - '2202'
+    - '2203'
+    - '2204'
+:discover:
+  :rules:
+  - :length:
+    - 16
+    - 19
+    :prefixes:
+    - '6011'
+    - '644'
+    - '645'
+    - '646'
+    - '647'
+    - '648'
+    - '649'
+    - '65'