Class: ActiveMerchant::Billing::BlueSnapGateway

Inherits:
Gateway
  • Object
show all
Defined in:
lib/active_merchant/billing/gateways/blue_snap.rb

Constant Summary collapse

TRANSACTIONS =
{
  purchase: 'AUTH_CAPTURE',
  authorize: 'AUTH_ONLY',
  capture: 'CAPTURE',
  void: 'AUTH_REVERSAL',
  refund: 'REFUND'
}
CVC_CODE_TRANSLATOR =
{
  'MA' => 'M',
  'NC' => 'U',
  'ND' => 'P',
  'NM' => 'N',
  'NP' => 'S'
}
AVS_CODE_TRANSLATOR =
{
  'line1: U, zip: U, name: U' => 'I',
  'line1: U, zip: U, name: M' => 'I',
  'line1: U, zip: U, name: N' => 'I',
  'line1: U, zip: M, name: U' => 'P',
  'line1: U, zip: M, name: M' => 'P',
  'line1: U, zip: M, name: N' => 'F',
  'line1: U, zip: N, name: U' => 'O',
  'line1: U, zip: N, name: M' => 'O',
  'line1: U, zip: N, name: N' => 'O',
  'line1: M, zip: U, name: U' => 'B',
  'line1: M, zip: U, name: M' => 'B',
  'line1: M, zip: U, name: N' => 'T',
  'line1: M, zip: M, name: U' => 'M',
  'line1: M, zip: M, name: M' => 'V',
  'line1: M, zip: M, name: N' => 'H',
  'line1: M, zip: N, name: U' => 'A',
  'line1: M, zip: N, name: M' => 'O',
  'line1: M, zip: N, name: N' => 'A',
  'line1: N, zip: U, name: U' => 'C',
  'line1: N, zip: U, name: M' => 'C',
  'line1: N, zip: U, name: N' => 'C',
  'line1: N, zip: M, name: U' => 'W',
  'line1: N, zip: M, name: M' => 'L',
  'line1: N, zip: M, name: N' => 'W',
  'line1: N, zip: N, name: U' => 'N',
  'line1: N, zip: N, name: M' => 'K',
  'line1: N, zip: N, name: N' => 'N',
}
BANK_ACCOUNT_TYPE_MAPPING =
{
  'personal_checking' => 'CONSUMER_CHECKING',
  'personal_savings' => 'CONSUMER_SAVINGS',
  'business_checking' => 'CORPORATE_CHECKING',
  'business_savings' => 'CORPORATE_SAVINGS'
}
STATE_CODE_COUNTRIES =
%w(US CA)

Constants inherited from Gateway

Gateway::CREDIT_DEPRECATION_MESSAGE, Gateway::RECURRING_DEPRECATION_MESSAGE, Gateway::STANDARD_ERROR_CODE

Instance Attribute Summary

Attributes inherited from Gateway

#options

Instance Method Summary collapse

Methods inherited from Gateway

#add_field_to_post_if_present, #add_fields_to_post_if_present, #card_brand, card_brand, #generate_unique_id, inherited, #supported_countries, supported_countries, supported_countries=, supports?, #supports_network_tokenization?, #test?

Methods included from CreditCardFormatting

#expdate, #format

Methods included from PostsData

included, #raw_ssl_request, #ssl_get, #ssl_post, #ssl_request

Constructor Details

#initialize(options = {}) ⇒ BlueSnapGateway

Returns a new instance of BlueSnapGateway.



71
72
73
74
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 71

def initialize(options={})
  requires!(options, :api_username, :api_password)
  super
end

Instance Method Details

#authorize(money, payment_method, options = {}) ⇒ Object



88
89
90
91
92
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 88

def authorize(money, payment_method, options={})
  commit(:authorize) do |doc|
    add_auth_purchase(doc, money, payment_method, options)
  end
end

#capture(money, authorization, options = {}) ⇒ Object



94
95
96
97
98
99
100
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 94

def capture(money, authorization, options={})
  commit(:capture, :put) do |doc|
    add_authorization(doc, authorization)
    add_order(doc, options)
    add_amount(doc, money, options) if options[:include_capture_amount] == true
  end
end

#purchase(money, payment_method, options = {}) ⇒ Object



76
77
78
79
80
81
82
83
84
85
86
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 76

def purchase(money, payment_method, options={})
  payment_method_details = PaymentMethodDetails.new(payment_method)

  commit(:purchase, :post, payment_method_details) do |doc|
    if payment_method_details.alt_transaction?
      add_alt_transaction_purchase(doc, money, payment_method_details, options)
    else
      add_auth_purchase(doc, money, payment_method, options)
    end
  end
end

#refund(money, authorization, options = {}) ⇒ Object



102
103
104
105
106
107
108
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 102

def refund(money, authorization, options={})
  commit(:refund, :put) do |doc|
    add_authorization(doc, authorization)
    add_amount(doc, money, options)
    add_order(doc, options)
  end
end

#scrub(transcript) ⇒ Object



162
163
164
165
166
167
168
169
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 162

def scrub(transcript)
  transcript.
    gsub(%r((Authorization: Basic )\w+), '\1[FILTERED]').
    gsub(%r((<card-number>).+(</card-number>)), '\1[FILTERED]\2').
    gsub(%r((<security-code>).+(</security-code>)), '\1[FILTERED]\2').
    gsub(%r((<(?:public-)?account-number>).+(</(?:public-)?account-number>)), '\1[FILTERED]\2').
    gsub(%r((<(?:public-)?routing-number>).+(</(?:public-)?routing-number>)), '\1[FILTERED]\2')
end

#store(payment_method, options = {}) ⇒ Object



121
122
123
124
125
126
127
128
129
130
131
132
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 121

def store(payment_method, options = {})
  payment_method_details = PaymentMethodDetails.new(payment_method)

  commit(:store, :post, payment_method_details) do |doc|
    add_personal_info(doc, payment_method, options)
    add_echeck_company(doc, payment_method) if payment_method_details.check?
    doc.send('payment-sources') do
      payment_method_details.check? ? store_echeck(doc, payment_method) : store_credit_card(doc, payment_method)
    end
    add_order(doc, options)
  end
end

#store_credit_card(doc, payment_method) ⇒ Object



134
135
136
137
138
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 134

def store_credit_card(doc, payment_method)
  doc.send('credit-card-info') do
    add_credit_card(doc, payment_method)
  end
end

#store_echeck(doc, payment_method) ⇒ Object



140
141
142
143
144
145
146
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 140

def store_echeck(doc, payment_method)
  doc.send('ecp-info') do
    doc.send('ecp') do
      add_echeck(doc, payment_method)
    end
  end
end

#supports_scrubbing?Boolean

Returns:

  • (Boolean)


158
159
160
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 158

def supports_scrubbing?
  true
end

#verify(payment_method, options = {}) ⇒ Object



117
118
119
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 117

def verify(payment_method, options={})
  authorize(0, payment_method, options)
end

#verify_credentialsObject



148
149
150
151
152
153
154
155
156
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 148

def verify_credentials
  begin
    ssl_get(url.to_s, headers)
  rescue ResponseError => e
    return false if e.response.code.to_i == 401
  end

  true
end

#void(authorization, options = {}) ⇒ Object



110
111
112
113
114
115
# File 'lib/active_merchant/billing/gateways/blue_snap.rb', line 110

def void(authorization, options={})
  commit(:void, :put) do |doc|
    add_authorization(doc, authorization)
    add_order(doc, options)
  end
end