Class: Spree::CreditCard

Inherits:
ActiveRecord::Base
  • Object
show all
Defined in:
app/models/spree/credit_card.rb

Direct Known Subclasses

TestCard

Constant Summary collapse

CARD_TYPES =
{
  visa: /^4[0-9]{12}(?:[0-9]{3})?$/,
  master: /(^5[1-5][0-9]{14}$)|(^6759[0-9]{2}([0-9]{10})$)|(^6759[0-9]{2}([0-9]{12})$)|(^6759[0-9]{2}([0-9]{13})$)/,
  diners_club: /^3(?:0[0-5]|[68][0-9])[0-9]{11}$/,
  american_express: /^3[47][0-9]{13}$/,
  discover: /^6(?:011|5[0-9]{2})[0-9]{12}$/,
  jcb: /^(?:2131|1800|35\d{3})\d{11}$/
}

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#numberObject

Returns the value of attribute number.



7
8
9
# File 'app/models/spree/credit_card.rb', line 7

def number
  @number
end

#verification_valueObject

Returns the value of attribute verification_value.



7
8
9
# File 'app/models/spree/credit_card.rb', line 7

def verification_value
  @verification_value
end

Instance Method Details

#actionsObject



81
82
83
# File 'app/models/spree/credit_card.rb', line 81

def actions
  %w{capture void credit}
end

#can_capture?(payment) ⇒ Boolean

Indicates whether its possible to capture the payment

Returns:

  • (Boolean)


86
87
88
# File 'app/models/spree/credit_card.rb', line 86

def can_capture?(payment)
  payment.pending? || payment.checkout?
end

#can_credit?(payment) ⇒ Boolean

Indicates whether its possible to credit the payment. Note that most gateways require that the payment be settled first which generally happens within 12-24 hours of the transaction.

Returns:

  • (Boolean)


97
98
99
100
101
# File 'app/models/spree/credit_card.rb', line 97

def can_credit?(payment)
  return false unless payment.completed?
  return false unless payment.order.payment_state == 'credit_owed'
  payment.credit_allowed > 0
end

#can_void?(payment) ⇒ Boolean

Indicates whether its possible to void the payment.

Returns:

  • (Boolean)


91
92
93
# File 'app/models/spree/credit_card.rb', line 91

def can_void?(payment)
  !payment.void?
end

#cc_type=(type) ⇒ Object

cc_type is set by jquery.payment, which helpfully provides different types from Active Merchant. Converting them is necessary.



43
44
45
46
47
48
49
50
51
# File 'app/models/spree/credit_card.rb', line 43

def cc_type=(type)
  self[:cc_type] = case type
  when 'mastercard', 'maestro' then 'master'
  when 'amex' then 'american_express'
  when 'dinersclub' then 'diners_club'
  when '' then try_type_from_number
  else type
  end
end

#display_numberObject

Show the card number, with all but last 4 numbers replace with “X”. (XXXX-XXXX-XXXX-4338)



77
78
79
# File 'app/models/spree/credit_card.rb', line 77

def display_number
  "XXXX-XXXX-XXXX-#{last_digits}"
end

#expiry=(expiry) ⇒ Object



28
29
30
31
32
33
34
35
# File 'app/models/spree/credit_card.rb', line 28

def expiry=(expiry)
  if expiry.present?
    self[:month], self[:year] = expiry.delete(' ').split('/')
    self[:year] = "20" + self[:year] if self[:year].length == 2
    self[:year] = self[:year].to_i
    self[:month] = self[:month].to_i
  end
end

#has_payment_profile?Boolean

Returns:

  • (Boolean)


103
104
105
# File 'app/models/spree/credit_card.rb', line 103

def has_payment_profile?
  gateway_customer_profile_id.present? || gateway_payment_profile_id.present?
end

#nameObject



68
69
70
# File 'app/models/spree/credit_card.rb', line 68

def name
  "#{first_name} #{last_name}"
end

#name?Boolean

Returns:

  • (Boolean)


64
65
66
# File 'app/models/spree/credit_card.rb', line 64

def name?
  first_name? && last_name?
end

#set_last_digitsObject



53
54
55
56
57
# File 'app/models/spree/credit_card.rb', line 53

def set_last_digits
  number.to_s.gsub!(/\s/,'')
  verification_value.to_s.gsub!(/\s/,'')
  self.last_digits ||= number.to_s.length <= 4 ? number : number.to_s.slice(-4..-1)
end

#to_active_merchantObject



107
108
109
110
111
112
113
114
115
116
# File 'app/models/spree/credit_card.rb', line 107

def to_active_merchant
  ActiveMerchant::Billing::CreditCard.new(
    :number => number,
    :month => month,
    :year => year,
    :verification_value => verification_value,
    :first_name => first_name,
    :last_name => last_name
  )
end

#try_type_from_numberObject



59
60
61
62
# File 'app/models/spree/credit_card.rb', line 59

def try_type_from_number
  numbers = number.delete(' ') if number
  CARD_TYPES.find{|type, pattern| return type.to_s if numbers =~ pattern}.to_s
end

#verification_value?Boolean

Returns:

  • (Boolean)


72
73
74
# File 'app/models/spree/credit_card.rb', line 72

def verification_value?
  verification_value.present?
end