Class: ActiveMerchant::Billing::SagePayGateway

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

Constant Summary collapse

APPROVED =
'OK'
TRANSACTIONS =
{
  purchase: 'PAYMENT',
  credit: 'REFUND',
  authorization: 'DEFERRED',
  capture: 'RELEASE',
  void: 'VOID',
  abort: 'ABORT',
  store: 'TOKEN',
  unstore: 'REMOVETOKEN',
  repeat: 'REPEAT'
}
CREDIT_CARDS =
{
  visa: 'VISA',
  master: 'MC',
  delta: 'DELTA',
  maestro: 'MAESTRO',
  american_express: 'AMEX',
  electron: 'UKE',
  diners_club: 'DC',
  jcb: 'JCB'
}
AVS_CODE =
{
  'NOTPROVIDED' => nil,
  'NOTCHECKED' => 'X',
  'MATCHED' => 'Y',
  'NOTMATCHED' => 'N'
}
CVV_CODE =
{
  'NOTPROVIDED' => 'S',
  'NOTCHECKED' => 'X',
  'MATCHED' => 'M',
  'NOTMATCHED' => 'N'
}
OPTIONAL_REQUEST_FIELDS =
{
  paypal_callback_url: :PayPalCallbackURL,
  basket: :Basket,
  gift_aid_payment: :GiftAidPayment,
  apply_avscv2: :ApplyAVSCV2,
  apply_3d_secure: :Apply3DSecure,
  account_type: :AccountType,
  billing_agreement: :BillingAgreement,
  basket_xml: :BasketXML,
  customer_xml: :CustomerXML,
  surcharge_xml: :SurchargeXML,
  vendor_data: :VendorData,
  language: :Language,
  website: :Website,
  recipient_account_number: :FIRecipientAcctNumber,
  recipient_surname: :FIRecipientSurname,
  recipient_postcode: :FIRecipientPostcode,
  recipient_dob: :FIRecipientDoB
}

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?, #supports_scrubbing?, #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 = {}) ⇒ SagePayGateway

Returns a new instance of SagePayGateway.



79
80
81
82
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 79

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

Instance Method Details

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



99
100
101
102
103
104
105
106
107
108
109
110
111
112
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 99

def authorize(money, payment_method, options = {})
  requires!(options, :order_id)

  post = {}

  add_amount(post, money, options)
  add_invoice(post, options)
  add_payment_method(post, payment_method, options)
  add_address(post, options)
  add_customer_data(post, options)
  add_optional_data(post, options)

  commit(:authorization, post)
end

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

You can only capture a transaction once, even if you didn’t capture the full amount the first time.



115
116
117
118
119
120
121
122
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 115

def capture(money, identification, options = {})
  post = {}

  add_reference(post, identification)
  add_release_amount(post, money, options)

  commit(:capture, post)
end

#credit(money, identification, options = {}) ⇒ Object



146
147
148
149
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 146

def credit(money, identification, options = {})
  ActiveMerchant.deprecated CREDIT_DEPRECATION_MESSAGE
  refund(money, identification, options)
end

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



84
85
86
87
88
89
90
91
92
93
94
95
96
97
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 84

def purchase(money, payment_method, options = {})
  requires!(options, :order_id)

  post = {}

  add_amount(post, money, options)
  add_invoice(post, options)
  add_payment_method(post, payment_method, options)
  add_address(post, options)
  add_customer_data(post, options)
  add_optional_data(post, options)

  commit((past_purchase_reference?(payment_method) ? :repeat : :purchase), post)
end

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

Refunding requires a new order_id to passed in, as well as a description



134
135
136
137
138
139
140
141
142
143
144
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 134

def refund(money, identification, options = {})
  requires!(options, :order_id, :description)

  post = {}

  add_related_reference(post, identification)
  add_amount(post, money, options)
  add_invoice(post, options)

  commit(:credit, post)
end

#scrub(transcript) ⇒ Object



176
177
178
179
180
181
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 176

def scrub(transcript)
  transcript.
    gsub(%r((Authorization: Basic )\w+), '\1[FILTERED]').
    gsub(%r((&?CardNumber=)\d+(&?)), '\1[FILTERED]\2').
    gsub(%r((&?CV2=)\d+(&?)), '\1[FILTERED]\2')
end

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



151
152
153
154
155
156
157
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 151

def store(credit_card, options = {})
  post = {}
  add_credit_card(post, credit_card)
  add_currency(post, 0, options)

  commit(:store, post)
end

#supports_scrubbingObject



172
173
174
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 172

def supports_scrubbing
  true
end

#unstore(token, options = {}) ⇒ Object



159
160
161
162
163
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 159

def unstore(token, options = {})
  post = {}
  add_token(post, token)
  commit(:unstore, post)
end

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



165
166
167
168
169
170
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 165

def verify(credit_card, options = {})
  MultiResponse.run(:use_first_response) do |r|
    r.process { authorize(100, credit_card, options) }
    r.process(:ignore_result) { void(r.authorization, options) }
  end
end

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



124
125
126
127
128
129
130
131
# File 'lib/active_merchant/billing/gateways/sage_pay.rb', line 124

def void(identification, options = {})
  post = {}

  add_reference(post, identification)
  action = abort_or_void_from(identification)

  commit(action, post)
end