mcmire-activemerchant 1.5.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (131) hide show
  1. data/CHANGELOG +508 -0
  2. data/CONTRIBUTORS +134 -0
  3. data/MIT-LICENSE +20 -0
  4. data/README.rdoc +136 -0
  5. data/gem-public_cert.pem +20 -0
  6. data/lib/active_merchant.rb +46 -0
  7. data/lib/active_merchant/billing.rb +9 -0
  8. data/lib/active_merchant/billing/avs_result.rb +98 -0
  9. data/lib/active_merchant/billing/base.rb +57 -0
  10. data/lib/active_merchant/billing/check.rb +68 -0
  11. data/lib/active_merchant/billing/credit_card.rb +159 -0
  12. data/lib/active_merchant/billing/credit_card_formatting.rb +21 -0
  13. data/lib/active_merchant/billing/credit_card_methods.rb +125 -0
  14. data/lib/active_merchant/billing/cvv_result.rb +38 -0
  15. data/lib/active_merchant/billing/expiry_date.rb +34 -0
  16. data/lib/active_merchant/billing/gateway.rb +163 -0
  17. data/lib/active_merchant/billing/gateways.rb +18 -0
  18. data/lib/active_merchant/billing/gateways/authorize_net.rb +654 -0
  19. data/lib/active_merchant/billing/gateways/authorize_net_cim.rb +885 -0
  20. data/lib/active_merchant/billing/gateways/beanstream.rb +102 -0
  21. data/lib/active_merchant/billing/gateways/beanstream/beanstream_core.rb +244 -0
  22. data/lib/active_merchant/billing/gateways/beanstream_interac.rb +54 -0
  23. data/lib/active_merchant/billing/gateways/bogus.rb +98 -0
  24. data/lib/active_merchant/billing/gateways/braintree.rb +17 -0
  25. data/lib/active_merchant/billing/gateways/card_stream.rb +230 -0
  26. data/lib/active_merchant/billing/gateways/cyber_source.rb +406 -0
  27. data/lib/active_merchant/billing/gateways/data_cash.rb +593 -0
  28. data/lib/active_merchant/billing/gateways/efsnet.rb +229 -0
  29. data/lib/active_merchant/billing/gateways/elavon.rb +134 -0
  30. data/lib/active_merchant/billing/gateways/eway.rb +277 -0
  31. data/lib/active_merchant/billing/gateways/exact.rb +222 -0
  32. data/lib/active_merchant/billing/gateways/first_pay.rb +172 -0
  33. data/lib/active_merchant/billing/gateways/instapay.rb +164 -0
  34. data/lib/active_merchant/billing/gateways/jetpay.rb +270 -0
  35. data/lib/active_merchant/billing/gateways/linkpoint.rb +449 -0
  36. data/lib/active_merchant/billing/gateways/merchant_e_solutions.rb +154 -0
  37. data/lib/active_merchant/billing/gateways/merchant_ware.rb +283 -0
  38. data/lib/active_merchant/billing/gateways/modern_payments.rb +36 -0
  39. data/lib/active_merchant/billing/gateways/modern_payments_cim.rb +220 -0
  40. data/lib/active_merchant/billing/gateways/moneris.rb +205 -0
  41. data/lib/active_merchant/billing/gateways/net_registry.rb +189 -0
  42. data/lib/active_merchant/billing/gateways/netbilling.rb +168 -0
  43. data/lib/active_merchant/billing/gateways/ogone.rb +279 -0
  44. data/lib/active_merchant/billing/gateways/pay_junction.rb +392 -0
  45. data/lib/active_merchant/billing/gateways/pay_secure.rb +120 -0
  46. data/lib/active_merchant/billing/gateways/payflow.rb +236 -0
  47. data/lib/active_merchant/billing/gateways/payflow/payflow_common_api.rb +207 -0
  48. data/lib/active_merchant/billing/gateways/payflow/payflow_express_response.rb +39 -0
  49. data/lib/active_merchant/billing/gateways/payflow/payflow_response.rb +13 -0
  50. data/lib/active_merchant/billing/gateways/payflow_express.rb +138 -0
  51. data/lib/active_merchant/billing/gateways/payflow_express_uk.rb +15 -0
  52. data/lib/active_merchant/billing/gateways/payflow_uk.rb +21 -0
  53. data/lib/active_merchant/billing/gateways/payment_express.rb +230 -0
  54. data/lib/active_merchant/billing/gateways/paypal.rb +121 -0
  55. data/lib/active_merchant/billing/gateways/paypal/paypal_common_api.rb +326 -0
  56. data/lib/active_merchant/billing/gateways/paypal/paypal_express_response.rb +38 -0
  57. data/lib/active_merchant/billing/gateways/paypal_ca.rb +13 -0
  58. data/lib/active_merchant/billing/gateways/paypal_express.rb +130 -0
  59. data/lib/active_merchant/billing/gateways/paypal_express_common.rb +20 -0
  60. data/lib/active_merchant/billing/gateways/plugnpay.rb +292 -0
  61. data/lib/active_merchant/billing/gateways/psigate.rb +214 -0
  62. data/lib/active_merchant/billing/gateways/psl_card.rb +304 -0
  63. data/lib/active_merchant/billing/gateways/quickpay.rb +213 -0
  64. data/lib/active_merchant/billing/gateways/realex.rb +200 -0
  65. data/lib/active_merchant/billing/gateways/sage.rb +146 -0
  66. data/lib/active_merchant/billing/gateways/sage/sage_bankcard.rb +88 -0
  67. data/lib/active_merchant/billing/gateways/sage/sage_core.rb +116 -0
  68. data/lib/active_merchant/billing/gateways/sage/sage_virtual_check.rb +97 -0
  69. data/lib/active_merchant/billing/gateways/sage_pay.rb +309 -0
  70. data/lib/active_merchant/billing/gateways/sallie_mae.rb +144 -0
  71. data/lib/active_merchant/billing/gateways/secure_pay.rb +31 -0
  72. data/lib/active_merchant/billing/gateways/secure_pay_au.rb +157 -0
  73. data/lib/active_merchant/billing/gateways/secure_pay_tech.rb +113 -0
  74. data/lib/active_merchant/billing/gateways/skip_jack.rb +453 -0
  75. data/lib/active_merchant/billing/gateways/smart_ps.rb +265 -0
  76. data/lib/active_merchant/billing/gateways/trans_first.rb +127 -0
  77. data/lib/active_merchant/billing/gateways/transax.rb +25 -0
  78. data/lib/active_merchant/billing/gateways/trust_commerce.rb +418 -0
  79. data/lib/active_merchant/billing/gateways/usa_epay.rb +194 -0
  80. data/lib/active_merchant/billing/gateways/verifi.rb +228 -0
  81. data/lib/active_merchant/billing/gateways/viaklix.rb +189 -0
  82. data/lib/active_merchant/billing/gateways/wirecard.rb +318 -0
  83. data/lib/active_merchant/billing/integrations.rb +29 -0
  84. data/lib/active_merchant/billing/integrations/action_view_helper.rb +79 -0
  85. data/lib/active_merchant/billing/integrations/bogus.rb +23 -0
  86. data/lib/active_merchant/billing/integrations/bogus/helper.rb +17 -0
  87. data/lib/active_merchant/billing/integrations/bogus/notification.rb +11 -0
  88. data/lib/active_merchant/billing/integrations/bogus/return.rb +10 -0
  89. data/lib/active_merchant/billing/integrations/chronopay.rb +23 -0
  90. data/lib/active_merchant/billing/integrations/chronopay/helper.rb +120 -0
  91. data/lib/active_merchant/billing/integrations/chronopay/notification.rb +158 -0
  92. data/lib/active_merchant/billing/integrations/chronopay/return.rb +10 -0
  93. data/lib/active_merchant/billing/integrations/gestpay.rb +25 -0
  94. data/lib/active_merchant/billing/integrations/gestpay/common.rb +42 -0
  95. data/lib/active_merchant/billing/integrations/gestpay/helper.rb +70 -0
  96. data/lib/active_merchant/billing/integrations/gestpay/notification.rb +85 -0
  97. data/lib/active_merchant/billing/integrations/gestpay/return.rb +10 -0
  98. data/lib/active_merchant/billing/integrations/helper.rb +93 -0
  99. data/lib/active_merchant/billing/integrations/hi_trust.rb +27 -0
  100. data/lib/active_merchant/billing/integrations/hi_trust/helper.rb +58 -0
  101. data/lib/active_merchant/billing/integrations/hi_trust/notification.rb +59 -0
  102. data/lib/active_merchant/billing/integrations/hi_trust/return.rb +67 -0
  103. data/lib/active_merchant/billing/integrations/nochex.rb +88 -0
  104. data/lib/active_merchant/billing/integrations/nochex/helper.rb +68 -0
  105. data/lib/active_merchant/billing/integrations/nochex/notification.rb +94 -0
  106. data/lib/active_merchant/billing/integrations/nochex/return.rb +10 -0
  107. data/lib/active_merchant/billing/integrations/notification.rb +62 -0
  108. data/lib/active_merchant/billing/integrations/paypal.rb +39 -0
  109. data/lib/active_merchant/billing/integrations/paypal/helper.rb +119 -0
  110. data/lib/active_merchant/billing/integrations/paypal/notification.rb +154 -0
  111. data/lib/active_merchant/billing/integrations/paypal/return.rb +10 -0
  112. data/lib/active_merchant/billing/integrations/quickpay.rb +17 -0
  113. data/lib/active_merchant/billing/integrations/quickpay/helper.rb +72 -0
  114. data/lib/active_merchant/billing/integrations/quickpay/notification.rb +74 -0
  115. data/lib/active_merchant/billing/integrations/return.rb +35 -0
  116. data/lib/active_merchant/billing/integrations/two_checkout.rb +23 -0
  117. data/lib/active_merchant/billing/integrations/two_checkout/helper.rb +59 -0
  118. data/lib/active_merchant/billing/integrations/two_checkout/notification.rb +114 -0
  119. data/lib/active_merchant/billing/integrations/two_checkout/return.rb +17 -0
  120. data/lib/active_merchant/billing/response.rb +32 -0
  121. data/lib/active_merchant/lib/connection.rb +170 -0
  122. data/lib/active_merchant/lib/country.rb +319 -0
  123. data/lib/active_merchant/lib/error.rb +4 -0
  124. data/lib/active_merchant/lib/post_data.rb +22 -0
  125. data/lib/active_merchant/lib/posts_data.rb +47 -0
  126. data/lib/active_merchant/lib/requires_parameters.rb +16 -0
  127. data/lib/active_merchant/lib/utils.rb +18 -0
  128. data/lib/active_merchant/lib/validateable.rb +76 -0
  129. data/lib/certs/cacert.pem +7815 -0
  130. data/lib/support/gateway_support.rb +58 -0
  131. metadata +218 -0
@@ -0,0 +1,213 @@
1
+ require 'rexml/document'
2
+ require 'digest/md5'
3
+
4
+ module ActiveMerchant #:nodoc:
5
+ module Billing #:nodoc:
6
+ class QuickpayGateway < Gateway
7
+ URL = 'https://secure.quickpay.dk/api'
8
+
9
+ self.default_currency = 'DKK'
10
+ self.money_format = :cents
11
+ self.supported_cardtypes = [ :dankort, :forbrugsforeningen, :visa, :master, :american_express, :diners_club, :jcb, :maestro ]
12
+ self.supported_countries = ['DK']
13
+ self.homepage_url = 'http://quickpay.dk/'
14
+ self.display_name = 'Quickpay'
15
+
16
+ PROTOCOL = 3
17
+
18
+ MD5_CHECK_FIELDS = {
19
+ :authorize => [:protocol, :msgtype, :merchant, :ordernumber, :amount, :currency, :autocapture, :cardnumber, :expirationdate, :cvd, :cardtypelock],
20
+ :capture => [:protocol, :msgtype, :merchant, :amount, :transaction],
21
+ :cancel => [:protocol, :msgtype, :merchant, :transaction],
22
+ :refund => [:protocol, :msgtype, :merchant, :amount, :transaction],
23
+ :subscribe => [:protocol, :msgtype, :merchant, :ordernumber, :cardnumber, :expirationdate, :cvd, :cardtypelock, :description],
24
+ :recurring => [:protocol, :msgtype, :merchant, :ordernumber, :amount, :currency, :autocapture, :transaction],
25
+ :status => [:protocol, :msgtype, :merchant, :transaction],
26
+ :chstatus => [:protocol, :msgtype, :merchant],
27
+ }
28
+
29
+ APPROVED = '000'
30
+
31
+ # The login is the QuickpayId
32
+ # The password is the md5checkword from the Quickpay admin interface
33
+ def initialize(options = {})
34
+ requires!(options, :login, :password)
35
+ @options = options
36
+ super
37
+ end
38
+
39
+ def authorize(money, credit_card_or_reference, options = {})
40
+ post = {}
41
+
42
+ add_amount(post, money, options)
43
+ add_invoice(post, options)
44
+ add_creditcard_or_reference(post, credit_card_or_reference, options)
45
+ add_autocapture(post, false)
46
+
47
+ commit(recurring_or_authorize(credit_card_or_reference), post)
48
+ end
49
+
50
+ def purchase(money, credit_card_or_reference, options = {})
51
+ post = {}
52
+
53
+ add_amount(post, money, options)
54
+ add_creditcard_or_reference(post, credit_card_or_reference, options)
55
+ add_invoice(post, options)
56
+ add_autocapture(post, true)
57
+
58
+ commit(recurring_or_authorize(credit_card_or_reference), post)
59
+ end
60
+
61
+ def capture(money, authorization, options = {})
62
+ post = {}
63
+
64
+ add_reference(post, authorization)
65
+ add_amount_without_currency(post, money)
66
+
67
+ commit(:capture, post)
68
+ end
69
+
70
+ def void(identification, options = {})
71
+ post = {}
72
+
73
+ add_reference(post, identification)
74
+
75
+ commit(:cancel, post)
76
+ end
77
+
78
+ def credit(money, identification, options = {})
79
+ post = {}
80
+
81
+ add_amount_without_currency(post, money)
82
+ add_reference(post, identification)
83
+
84
+ commit(:refund, post)
85
+ end
86
+
87
+ def store(creditcard, options = {})
88
+ post = {}
89
+
90
+ add_creditcard(post, creditcard, options)
91
+ add_invoice(post, options)
92
+ add_description(post, options)
93
+
94
+ commit(:subscribe, post)
95
+ end
96
+
97
+ private
98
+
99
+ def add_amount(post, money, options = {})
100
+ post[:amount] = amount(money)
101
+ post[:currency] = options[:currency] || currency(money)
102
+ end
103
+
104
+ def add_amount_without_currency(post, money, options = {})
105
+ post[:amount] = amount(money)
106
+ end
107
+
108
+ def add_invoice(post, options)
109
+ post[:ordernumber] = format_order_number(options[:order_id])
110
+ end
111
+
112
+ def add_creditcard(post, credit_card, options)
113
+ post[:cardnumber] = credit_card.number
114
+ post[:cvd] = credit_card.verification_value
115
+ post[:expirationdate] = expdate(credit_card)
116
+ post[:cardtypelock] = options[:cardtypelock] unless options[:cardtypelock].blank?
117
+ end
118
+
119
+ def add_reference(post, identification)
120
+ post[:transaction] = identification
121
+ end
122
+
123
+ def add_creditcard_or_reference(post, credit_card_or_reference, options)
124
+ if credit_card_or_reference.is_a?(String)
125
+ add_reference(post, credit_card_or_reference)
126
+ else
127
+ add_creditcard(post, credit_card_or_reference, options)
128
+ end
129
+ end
130
+
131
+ def add_autocapture(post, autocapture)
132
+ post[:autocapture] = autocapture ? 1 : 0
133
+ end
134
+
135
+ def recurring_or_authorize(credit_card_or_reference)
136
+ credit_card_or_reference.is_a?(String) ? :recurring : :authorize
137
+ end
138
+
139
+ def add_description(post, options)
140
+ post[:description] = options[:description]
141
+ end
142
+
143
+ def commit(action, params)
144
+ response = parse(ssl_post(URL, post_data(action, params)))
145
+
146
+ Response.new(successful?(response), message_from(response), response,
147
+ :test => test?,
148
+ :authorization => response[:transaction]
149
+ )
150
+ end
151
+
152
+ def successful?(response)
153
+ response[:qpstat] == APPROVED
154
+ end
155
+
156
+ def parse(data)
157
+ response = {}
158
+
159
+ doc = REXML::Document.new(data)
160
+
161
+ doc.root.elements.each do |element|
162
+ response[element.name.to_sym] = element.text
163
+ end
164
+
165
+ response
166
+ end
167
+
168
+ def message_from(response)
169
+ case response[:qpstat]
170
+ when '008' # Error in request data
171
+ response[:qpstatmsg].to_s
172
+ #.scan(/[A-Z][a-z0-9 \/]+/).to_sentence
173
+ else
174
+ response[:qpstatmsg].to_s
175
+ end
176
+ end
177
+
178
+ def post_data(action, params = {})
179
+ params[:protocol] = PROTOCOL
180
+ params[:msgtype] = action.to_s
181
+ params[:merchant] = @options[:login]
182
+ #params[:testmode] = '1' if test?
183
+ params[:md5check] = generate_check_hash(action, params)
184
+
185
+ params.collect { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join("&")
186
+ end
187
+
188
+ def generate_check_hash(action, params)
189
+ string = MD5_CHECK_FIELDS[action].collect do |key|
190
+ params[key]
191
+ end.join('')
192
+
193
+ # Add the md5checkword
194
+ string << @options[:password].to_s
195
+
196
+ Digest::MD5.hexdigest(string)
197
+ end
198
+
199
+ def expdate(credit_card)
200
+ year = format(credit_card.year, :two_digits)
201
+ month = format(credit_card.month, :two_digits)
202
+
203
+ "#{year}#{month}"
204
+ end
205
+
206
+ # Limited to 20 digits max
207
+ def format_order_number(number)
208
+ number.to_s.gsub(/[^\w_]/, '').rjust(4, "0")[0...20]
209
+ end
210
+ end
211
+ end
212
+ end
213
+
@@ -0,0 +1,200 @@
1
+ require 'rexml/document'
2
+ require 'digest/sha1'
3
+
4
+ module ActiveMerchant
5
+ module Billing
6
+ # Realex us the leading CC gateway in Ireland
7
+ # see http://www.realexpayments.com
8
+ # Contributed by John Ward (john@ward.name)
9
+ # see http://thinedgeofthewedge.blogspot.com
10
+ #
11
+ # Realex works using the following
12
+ # login - The unique id of the merchant
13
+ # password - The secret is used to digitally sign the request
14
+ # account - This is an optional third part of the authentication process
15
+ # and is used if the merchant wishes do distuinguish cc traffic from the different sources
16
+ # by using a different account. This must be created in advance
17
+ #
18
+ # the Realex team decided to make the orderid unique per request,
19
+ # so if validation fails you can not correct and resend using the
20
+ # same order id
21
+ class RealexGateway < Gateway
22
+ URL = 'https://epage.payandshop.com/epage-remote.cgi'
23
+
24
+ CARD_MAPPING = {
25
+ 'master' => 'MC',
26
+ 'visa' => 'VISA',
27
+ 'american_express' => 'AMEX',
28
+ 'diners_club' => 'DINERS',
29
+ 'switch' => 'SWITCH',
30
+ 'solo' => 'SWITCH',
31
+ 'laser' => 'LASER'
32
+ }
33
+
34
+ self.money_format = :cents
35
+ self.default_currency = 'EUR'
36
+ self.supported_cardtypes = [ :visa, :master, :american_express, :diners_club, :switch, :solo, :laser ]
37
+ self.supported_countries = [ 'IE', 'GB' ]
38
+ self.homepage_url = 'http://www.realexpayments.com/'
39
+ self.display_name = 'Realex'
40
+
41
+ SUCCESS, DECLINED = "Successful", "Declined"
42
+ BANK_ERROR = REALEX_ERROR = "Gateway is in maintenance. Please try again later."
43
+ ERROR = CLIENT_DEACTIVATED = "Gateway Error"
44
+
45
+ def initialize(options = {})
46
+ requires!(options, :login, :password)
47
+ @options = options
48
+ super
49
+ end
50
+
51
+ def purchase(money, credit_card, options = {})
52
+ requires!(options, :order_id)
53
+
54
+ request = build_purchase_or_authorization_request(:purchase, money, credit_card, options)
55
+ commit(request)
56
+ end
57
+
58
+ private
59
+ def commit(request)
60
+ response = parse(ssl_post(URL, request))
61
+
62
+ Response.new(response[:result] == "00", message_from(response), response,
63
+ :test => response[:message] =~ /\[ test system \]/,
64
+ :authorization => response[:authcode],
65
+ :cvv_result => response[:cvnresult]
66
+ )
67
+ end
68
+
69
+ def parse(xml)
70
+ response = {}
71
+
72
+ xml = REXML::Document.new(xml)
73
+ xml.elements.each('//response/*') do |node|
74
+
75
+ if (node.elements.size == 0)
76
+ response[node.name.downcase.to_sym] = normalize(node.text)
77
+ else
78
+ node.elements.each do |childnode|
79
+ name = "#{node.name.downcase}_#{childnode.name.downcase}"
80
+ response[name.to_sym] = normalize(childnode.text)
81
+ end
82
+ end
83
+
84
+ end unless xml.root.nil?
85
+
86
+ response
87
+ end
88
+
89
+ def parse_credit_card_number(request)
90
+ xml = REXML::Document.new(request)
91
+ card_number = REXML::XPath.first(xml, '/request/card/number')
92
+ card_number && card_number.text
93
+ end
94
+
95
+ def build_purchase_or_authorization_request(action, money, credit_card, options)
96
+ timestamp = Time.now.strftime('%Y%m%d%H%M%S')
97
+
98
+ xml = Builder::XmlMarkup.new :indent => 2
99
+ xml.tag! 'request', 'timestamp' => timestamp, 'type' => 'auth' do
100
+
101
+ xml.tag! 'merchantid', @options[:login]
102
+ xml.tag! 'account', @options[:account]
103
+
104
+ xml.tag! 'orderid', sanitize_order_id(options[:order_id])
105
+ xml.tag! 'amount', amount(money), 'currency' => options[:currency] || currency(money)
106
+
107
+ xml.tag! 'card' do
108
+ xml.tag! 'number', credit_card.number
109
+ xml.tag! 'expdate', expiry_date(credit_card)
110
+ xml.tag! 'type', CARD_MAPPING[card_brand(credit_card).to_s]
111
+ xml.tag! 'chname', credit_card.name
112
+ xml.tag! 'issueno', credit_card.issue_number
113
+
114
+ xml.tag! 'cvn' do
115
+ xml.tag! 'number', credit_card.verification_value
116
+ xml.tag! 'presind', credit_card.verification_value? ? 1 : nil
117
+ end
118
+ end
119
+
120
+ xml.tag! 'autosettle', 'flag' => auto_settle_flag(action)
121
+ xml.tag! 'sha1hash', sha1from("#{timestamp}.#{@options[:login]}.#{sanitize_order_id(options[:order_id])}.#{amount(money)}.#{options[:currency] || currency(money)}.#{credit_card.number}")
122
+ xml.tag! 'comments' do
123
+ xml.tag! 'comment', options[:description], 'id' => 1
124
+ xml.tag! 'comment', 'id' => 2
125
+ end
126
+
127
+ billing_address = options[:billing_address] || options[:address] || {}
128
+ shipping_address = options[:shipping_address] || {}
129
+
130
+ xml.tag! 'tssinfo' do
131
+ xml.tag! 'address', 'type' => 'billing' do
132
+ xml.tag! 'code', billing_address[:zip]
133
+ xml.tag! 'country', billing_address[:country]
134
+ end
135
+
136
+ xml.tag! 'address', 'type' => 'shipping' do
137
+ xml.tag! 'code', shipping_address[:zip]
138
+ xml.tag! 'country', shipping_address[:country]
139
+ end
140
+
141
+ xml.tag! 'custnum', options[:customer]
142
+
143
+ xml.tag! 'prodid', options[:invoice]
144
+ xml.tag! 'varref'
145
+ end
146
+ end
147
+
148
+ xml.target!
149
+ end
150
+
151
+ def auto_settle_flag(action)
152
+ action == :authorization ? '0' : '1'
153
+ end
154
+
155
+ def expiry_date(credit_card)
156
+ "#{format(credit_card.month, :two_digits)}#{format(credit_card.year, :two_digits)}"
157
+ end
158
+
159
+ def sha1from(string)
160
+ Digest::SHA1.hexdigest("#{Digest::SHA1.hexdigest(string)}.#{@options[:password]}")
161
+ end
162
+
163
+ def normalize(field)
164
+ case field
165
+ when "true" then true
166
+ when "false" then false
167
+ when "" then nil
168
+ when "null" then nil
169
+ else field
170
+ end
171
+ end
172
+
173
+ def message_from(response)
174
+ message = nil
175
+ case response[:result]
176
+ when "00"
177
+ message = SUCCESS
178
+ when "101"
179
+ message = response[:message]
180
+ when "102", "103"
181
+ message = DECLINED
182
+ when /^2[0-9][0-9]/
183
+ message = BANK_ERROR
184
+ when /^3[0-9][0-9]/
185
+ message = REALEX_ERROR
186
+ when /^5[0-9][0-9]/
187
+ message = ERROR
188
+ when "666"
189
+ message = CLIENT_DEACTIVATED
190
+ else
191
+ message = DECLINED
192
+ end
193
+ end
194
+
195
+ def sanitize_order_id(order_id)
196
+ order_id.to_s.gsub(/[^a-zA-Z0-9\-_]/, '')
197
+ end
198
+ end
199
+ end
200
+ end
@@ -0,0 +1,146 @@
1
+ require File.dirname(__FILE__) + '/sage/sage_bankcard'
2
+ require File.dirname(__FILE__) + '/sage/sage_virtual_check'
3
+
4
+ module ActiveMerchant #:nodoc:
5
+ module Billing #:nodoc:
6
+ class SageGateway < Gateway
7
+ self.supported_countries = SageBankcardGateway.supported_countries
8
+ self.supported_cardtypes = SageBankcardGateway.supported_cardtypes
9
+
10
+ # Creates a new SageGateway
11
+ #
12
+ # The gateway requires that a valid login and password be passed
13
+ # in the +options+ hash.
14
+ #
15
+ # ==== Options
16
+ #
17
+ # * <tt>:login</tt> - The Sage Payment Solutions Merchant ID Number.
18
+ # * <tt>:password</tt> - The Sage Payment Solutions Merchant Key Number.
19
+ def initialize(options = {})
20
+ requires!(options, :login, :password)
21
+ @options = options
22
+ super
23
+ end
24
+
25
+ # Performs an authorization transaction
26
+ #
27
+ # ==== Parameters
28
+ # * <tt>money</tt> - The amount to be authorized as an integer value in cents.
29
+ # * <tt>credit_card</tt> - The CreditCard object to be used as the funding source for the transaction.
30
+ # * <tt>options</tt> - A hash of optional parameters.
31
+ # * <tt>:order_id</tt> - A unique reference for this order. (maximum of 20 characters).
32
+ # * <tt>:email</tt> - The customer's email address
33
+ # * <tt>:customer</tt> - The Customer Number for Purchase Card Level II Transactions
34
+ # * <tt>:billing_address</tt> - The customer's billing address as a hash of address information.
35
+ # * <tt>:address1</tt> - The billing address street
36
+ # * <tt>:city</tt> - The billing address city
37
+ # * <tt>:state</tt> - The billing address state
38
+ # * <tt>:country</tt> - The 2 digit ISO billing address country code
39
+ # * <tt>:zip</tt> - The billing address zip code
40
+ # * <tt>:phone</tt> - The billing address phone number
41
+ # * <tt>:fax</tt> - The billing address fax number
42
+ # * <tt>:shipping_address</tt> - The customer's shipping address as a hash of address information.
43
+ # * <tt>:name</tt> - The name at the shipping address
44
+ # * <tt>:address1</tt> - The shipping address street
45
+ # * <tt>:city</tt> - The shipping address city
46
+ # * <tt>:state</tt> - The shipping address state code
47
+ # * <tt>:country</tt> - The 2 digit ISO shipping address country code
48
+ # * <tt>:zip</tt> - The shipping address zip code
49
+ # * <tt>:tax</tt> - The tax amount for the transaction as an Integer value in cents. Maps to Sage <tt>T_tax</tt>.
50
+ # * <tt>:shipping</tt> - The shipping amount for the transaction as an Integer value in cents. Maps to Sage <tt>T_shipping</tt>.
51
+ def authorize(money, credit_card, options = {})
52
+ bankcard.authorize(money, credit_card, options)
53
+ end
54
+
55
+ # Performs a purchase, which is essentially an authorization and capture in a single operation.
56
+ #
57
+ # ==== Parameters
58
+ #
59
+ # * <tt>money</tt> - The amount to be authorized as an integer value in cents.
60
+ # * <tt>source</tt> - The CreditCard or Check object to be used as the funding source for the transaction.
61
+ # * <tt>options</tt> - A hash of optional parameters.
62
+ # * <tt>:order_id</tt> - A unique reference for this order. (maximum of 20 characters).
63
+ # * <tt>:email</tt> - The customer's email address
64
+ # * <tt>:customer</tt> - The Customer Number for Purchase Card Level II Transactions
65
+ # * <tt>:billing_address</tt> - The customer's billing address as a hash of address information.
66
+ # * <tt>:address1</tt> - The billing address street
67
+ # * <tt>:city</tt> - The billing address city
68
+ # * <tt>:state</tt> - The billing address state
69
+ # * <tt>:country</tt> - The 2 digit ISO billing address country code
70
+ # * <tt>:zip</tt> - The billing address zip code
71
+ # * <tt>:phone</tt> - The billing address phone number
72
+ # * <tt>:fax</tt> - The billing address fax number
73
+ # * <tt>:shipping_address</tt> - The customer's shipping address as a hash of address information.
74
+ # * <tt>:name</tt> - The name at the shipping address
75
+ # * <tt>:address1</tt> - The shipping address street
76
+ # * <tt>:city</tt> - The shipping address city
77
+ # * <tt>:state</tt> - The shipping address state code
78
+ # * <tt>:country</tt> - The 2 digit ISO shipping address country code
79
+ # * <tt>:zip</tt> - The shipping address zip code
80
+ # * <tt>:tax</tt> - The tax amount for the transaction as an integer value in cents. Maps to Sage <tt>T_tax</tt>.
81
+ # * <tt>:shipping</tt> - The shipping amount for the transaction as an integer value in cents. Maps to Sage <tt>T_shipping</tt>.
82
+ #
83
+ # ==== Additional options in the +options+ hash for when using a Check as the funding source
84
+ # * <tt>:originator_id</tt> - 10 digit originator. If not provided, Sage will use the default Originator ID for the specific customer type.
85
+ # * <tt>:addenda</tt> - Transaction addenda.
86
+ # * <tt>:ssn</tt> - The customer's Social Security Number.
87
+ # * <tt>:drivers_license_state</tt> - The customer's drivers license state code.
88
+ # * <tt>:drivers_license_number</tt> - The customer's drivers license number.
89
+ # * <tt>:date_of_birth</tt> - The customer's date of birth as a Time or Date object or a string in the format <tt>mm/dd/yyyy</tt>.
90
+ def purchase(money, source, options = {})
91
+ if source.type == "check"
92
+ virtual_check.purchase(money, source, options)
93
+ else
94
+ bankcard.purchase(money, source, options)
95
+ end
96
+ end
97
+
98
+ # Captures authorized funds.
99
+ #
100
+ # ==== Parameters
101
+ #
102
+ # * <tt>money</tt> - The amount to be authorized as an integer value in cents. Sage doesn't support changing the capture amount, so the full amount of the initial transaction will be captured.
103
+ # * <tt>reference</tt> - The authorization reference string returned by the original transaction's Response#authorization.
104
+ def capture(money, reference, options = {})
105
+ bankcard.capture(money, reference, options)
106
+ end
107
+
108
+ # Voids a prior transaction. Works for both CreditCard and Check transactions.
109
+ #
110
+ # ==== Parameters
111
+ #
112
+ # * <tt>reference</tt> - The authorization reference string returned by the original transaction's Response#authorization.
113
+ def void(reference, options = {})
114
+ if reference.split(";").last == "virtual_check"
115
+ virtual_check.void(reference, options)
116
+ else
117
+ bankcard.void(reference, options)
118
+ end
119
+ end
120
+
121
+ # Performs a credit transaction. (Sage +Credit+ transaction).
122
+ #
123
+ # ==== Parameters
124
+ #
125
+ # * <tt>money</tt> - The amount to be authorized as an integer value in cents.
126
+ # * <tt>source</tt> - The CreditCard or Check object to be used as the target for the credit.
127
+ def credit(money, source, options = {})
128
+ if source.type == "check"
129
+ virtual_check.credit(money, source, options)
130
+ else
131
+ bankcard.credit(money, source, options)
132
+ end
133
+ end
134
+
135
+ private
136
+ def bankcard
137
+ @bankcard ||= SageBankcardGateway.new(@options)
138
+ end
139
+
140
+ def virtual_check
141
+ @virtual_check ||= SageVirtualCheckGateway.new(@options)
142
+ end
143
+ end
144
+ end
145
+ end
146
+