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,144 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ class SallieMaeGateway < Gateway
4
+ URL = 'https://trans.salliemae.com/cgi-bin/process.cgi'
5
+
6
+ # The countries the gateway supports merchants from as 2 digit ISO country codes
7
+ self.supported_countries = ['US']
8
+
9
+ # The card types supported by the payment gateway
10
+ self.supported_cardtypes = [:visa, :master, :american_express, :discover]
11
+
12
+ # The homepage URL of the gateway
13
+ self.homepage_url = 'http://www.salliemae.com/'
14
+
15
+ # The name of the gateway
16
+ self.display_name = 'Sallie Mae'
17
+
18
+ def initialize(options = {})
19
+ requires!(options, :login)
20
+ @options = options
21
+ super
22
+ end
23
+
24
+ def test?
25
+ @options[:login] == "TEST0"
26
+ end
27
+
28
+ def authorize(money, creditcard, options = {})
29
+ post = PostData.new
30
+ add_invoice(post, options)
31
+ add_creditcard(post, creditcard)
32
+ add_address(post, creditcard, options)
33
+ add_customer_data(post, options)
34
+
35
+ commit(:authonly, money, post)
36
+ end
37
+
38
+ def purchase(money, creditcard, options = {})
39
+ post = PostData.new
40
+ add_invoice(post, options)
41
+ add_creditcard(post, creditcard)
42
+ add_address(post, creditcard, options)
43
+ add_customer_data(post, options)
44
+
45
+ commit(:sale, money, post)
46
+ end
47
+
48
+ def capture(money, authorization, options = {})
49
+ post = PostData.new
50
+ post[:postonly] = authorization
51
+ commit(:capture, money, post)
52
+ end
53
+
54
+ private
55
+
56
+ def add_customer_data(post, options)
57
+ if address = options[:billing_address] || options[:shipping_address] || options[:address]
58
+ post[:ci_phone] = address[:phone].to_s
59
+ end
60
+
61
+ post[:ci_email] = options[:email].to_s unless options[:email].blank?
62
+ post[:ci_IP] = options[:ip].to_s unless options[:ip].blank?
63
+ end
64
+
65
+ def add_address(post, creditcard, options)
66
+ if address = options[:billing_address] || options[:address]
67
+ post[:ci_billaddr1] = address[:address1].to_s
68
+ post[:ci_billaddr2] = address[:address2].to_s unless address[:address2].blank?
69
+ post[:ci_billcity] = address[:city].to_s
70
+ post[:ci_billstate] = address[:state].to_s
71
+ post[:ci_billzip] = address[:zip].to_s
72
+ end
73
+
74
+ if shipping_address = options[:shipping_address] || options[:address]
75
+ post[:ci_shipaddr1] = shipping_address[:address1].to_s
76
+ post[:ci_shipaddr2] = shipping_address[:address2].to_s unless shipping_address[:address2].blank?
77
+ post[:ci_shipcity] = shipping_address[:city].to_s
78
+ post[:ci_shipstate] = shipping_address[:state].to_s
79
+ post[:ci_shipzip] = shipping_address[:zip].to_s
80
+ end
81
+ end
82
+
83
+ def add_invoice(post, options)
84
+ memo = "OrderID: #{options[:order_id]}\nDescription: #{options[:description]}"
85
+ post[:ci_memo] = memo
86
+ end
87
+
88
+ def add_creditcard(post, creditcard)
89
+ post[:ccnum] = creditcard.number.to_s
90
+ post[:ccname] = creditcard.name.to_s
91
+ post[:cvv2] = creditcard.verification_value.to_s if creditcard.verification_value?
92
+ post[:expmon] = creditcard.month.to_s
93
+ post[:expyear] = creditcard.year.to_s
94
+ end
95
+
96
+ def parse(body)
97
+ h = {}
98
+ body.gsub!("<html><body><plaintext>", "")
99
+ body.
100
+ split("\r\n").
101
+ map do |i|
102
+ a = i.split("=")
103
+ h[a.first] = a.last unless a.first.nil?
104
+ end
105
+ h
106
+ end
107
+
108
+ def commit(action, money, parameters)
109
+ parameters[:acctid] = @options[:login].to_s
110
+ parameters[:subid] = @options[:sub_id].to_s unless @options[:sub_id].blank?
111
+ parameters[:amount] = amount(money)
112
+
113
+ case action
114
+ when :sale
115
+ parameters[:action] = "ns_quicksale_cc"
116
+ when :authonly
117
+ parameters[:action] = "ns_quicksale_cc"
118
+ parameters[:authonly] = 1
119
+ when :capture
120
+ parameters[:action] = "ns_quicksale_cc"
121
+ end
122
+
123
+ response = parse(ssl_post(URL, parameters.to_post_data) || "")
124
+ Response.new(successful?(response), message_from(response), response,
125
+ :test => test?,
126
+ :authorization => response["refcode"]
127
+ )
128
+ end
129
+
130
+ def successful?(response)
131
+ response["Status"] == "Accepted"
132
+ end
133
+
134
+ def message_from(response)
135
+ if successful?(response)
136
+ "Accepted"
137
+ else
138
+ response["Reason"].split(":")[2].capitalize unless response["Reason"].nil?
139
+ end
140
+ end
141
+ end
142
+ end
143
+ end
144
+
@@ -0,0 +1,31 @@
1
+ require File.dirname(__FILE__) + '/authorize_net'
2
+
3
+ module ActiveMerchant #:nodoc:
4
+ module Billing #:nodoc:
5
+ class SecurePayGateway < AuthorizeNetGateway
6
+ self.live_url = self.test_url = 'https://www.securepay.com/AuthSpayAdapter/process.aspx'
7
+
8
+ self.homepage_url = 'http://www.securepay.com/'
9
+ self.display_name = 'SecurePay'
10
+
11
+ # Limit support to purchase() for the time being
12
+ # JRuby chokes here
13
+ # undef_method :authorize, :capture, :void, :credit
14
+
15
+ undef_method :authorize
16
+ undef_method :capture
17
+ undef_method :void
18
+ undef_method :credit
19
+
20
+ def test?
21
+ Base.gateway_mode == :test
22
+ end
23
+
24
+ private
25
+ def split(response)
26
+ response.split(',')
27
+ end
28
+ end
29
+ end
30
+ end
31
+
@@ -0,0 +1,157 @@
1
+ require 'rexml/document'
2
+
3
+ module ActiveMerchant #:nodoc:
4
+ module Billing #:nodoc:
5
+ class SecurePayAuGateway < Gateway
6
+ API_VERSION = 'xml-4.2'
7
+
8
+ TEST_URL = 'https://www.securepay.com.au/test/payment'
9
+ LIVE_URL = 'https://www.securepay.com.au/xmlapi/payment'
10
+
11
+ self.supported_countries = ['AU']
12
+ self.supported_cardtypes = [:visa, :master, :american_express, :diners_club, :jcb]
13
+
14
+ # The homepage URL of the gateway
15
+ self.homepage_url = 'http://securepay.com.au'
16
+
17
+ # The name of the gateway
18
+ self.display_name = 'SecurePay'
19
+
20
+ class_inheritable_accessor :request_timeout
21
+ self.request_timeout = 60
22
+
23
+ self.money_format = :cents
24
+ self.default_currency = 'AUD'
25
+
26
+ # 0 Standard Payment
27
+ # 4 Refund
28
+ # 6 Client Reversal (Void)
29
+ # 10 Preauthorise
30
+ # 11 Preauth Complete (Advice)
31
+ TRANSACTIONS = {
32
+ :purchase => 0,
33
+ :authorization => 10,
34
+ :capture => 11,
35
+ :void => 6,
36
+ :credit => 4
37
+ }
38
+
39
+ SUCCESS_CODES = [ '00', '08', '11', '16', '77' ]
40
+
41
+ def initialize(options = {})
42
+ requires!(options, :login, :password)
43
+ @options = options
44
+ super
45
+ end
46
+
47
+ def test?
48
+ @options[:test] || super
49
+ end
50
+
51
+ def purchase(money, credit_card, options = {})
52
+ commit :purchase, build_purchase_request(money, credit_card, options)
53
+ end
54
+
55
+ private
56
+
57
+ def build_purchase_request(money, credit_card, options)
58
+ xml = Builder::XmlMarkup.new
59
+
60
+ xml.tag! 'amount', amount(money)
61
+ xml.tag! 'currency', options[:currency] || currency(money)
62
+ xml.tag! 'purchaseOrderNo', options[:order_id].to_s.gsub(/[ ']/, '')
63
+
64
+ xml.tag! 'CreditCardInfo' do
65
+ xml.tag! 'cardNumber', credit_card.number
66
+ xml.tag! 'expiryDate', expdate(credit_card)
67
+ xml.tag! 'cvv', credit_card.verification_value if credit_card.verification_value?
68
+ end
69
+
70
+ xml.target!
71
+ end
72
+
73
+ def build_request(action, body)
74
+ xml = Builder::XmlMarkup.new
75
+ xml.instruct!
76
+ xml.tag! 'SecurePayMessage' do
77
+ xml.tag! 'MessageInfo' do
78
+ xml.tag! 'messageID', Utils.generate_unique_id.slice(0, 30)
79
+ xml.tag! 'messageTimestamp', generate_timestamp
80
+ xml.tag! 'timeoutValue', request_timeout
81
+ xml.tag! 'apiVersion', API_VERSION
82
+ end
83
+
84
+ xml.tag! 'MerchantInfo' do
85
+ xml.tag! 'merchantID', @options[:login]
86
+ xml.tag! 'password', @options[:password]
87
+ end
88
+
89
+ xml.tag! 'RequestType', 'Payment'
90
+ xml.tag! 'Payment' do
91
+ xml.tag! 'TxnList', "count" => 1 do
92
+ xml.tag! 'Txn', "ID" => 1 do
93
+ xml.tag! 'txnType', TRANSACTIONS[action]
94
+ xml.tag! 'txnSource', 23
95
+ xml << body
96
+ end
97
+ end
98
+ end
99
+ end
100
+
101
+ xml.target!
102
+ end
103
+
104
+ def commit(action, request)
105
+ response = parse(ssl_post(test? ? TEST_URL : LIVE_URL, build_request(action, request)))
106
+
107
+ Response.new(success?(response), message_from(response), response,
108
+ :test => test?,
109
+ :authorization => authorization_from(response)
110
+ )
111
+ end
112
+
113
+ def success?(response)
114
+ SUCCESS_CODES.include?(response[:response_code])
115
+ end
116
+
117
+ def authorization_from(response)
118
+ response[:txn_id]
119
+ end
120
+
121
+ def message_from(response)
122
+ response[:response_text] || response[:status_description]
123
+ end
124
+
125
+ def expdate(credit_card)
126
+ "#{format(credit_card.month, :two_digits)}/#{format(credit_card.year, :two_digits)}"
127
+ end
128
+
129
+ def parse(body)
130
+ xml = REXML::Document.new(body)
131
+
132
+ response = {}
133
+
134
+ xml.root.elements.to_a.each do |node|
135
+ parse_element(response, node)
136
+ end
137
+
138
+ response
139
+ end
140
+
141
+ def parse_element(response, node)
142
+ if node.has_elements?
143
+ node.elements.each{|element| parse_element(response, element) }
144
+ else
145
+ response[node.name.underscore.to_sym] = node.text
146
+ end
147
+ end
148
+
149
+ # YYYYDDMMHHNNSSKKK000sOOO
150
+ def generate_timestamp
151
+ time = Time.now.utc
152
+ time.strftime("%Y%d%m%H%M%S#{time.usec}+000")
153
+ end
154
+ end
155
+ end
156
+ end
157
+
@@ -0,0 +1,113 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ class SecurePayTechGateway < Gateway
4
+ class SecurePayTechPostData < PostData
5
+ self.required_fields = [ :OrderReference, :CardNumber, :CardExpiry, :CardHolderName, :CardType, :MerchantID, :MerchantKey, :Amount, :Currency ]
6
+ end
7
+
8
+ URL = 'https://tx.securepaytech.com/web/HttpPostPurchase'
9
+
10
+ PAYMENT_GATEWAY_RESPONSES = {
11
+ 1 => "Transaction OK",
12
+ 2 => "Insufficient funds",
13
+ 3 => "Card expired",
14
+ 4 => "Card declined",
15
+ 5 => "Server error",
16
+ 6 => "Communications error",
17
+ 7 => "Unsupported transaction type",
18
+ 8 => "Bad or malformed request",
19
+ 9 => "Invalid card number"
20
+ }
21
+
22
+ self.default_currency = 'NZD'
23
+ self.supported_countries = ['NZ']
24
+ self.supported_cardtypes = [:visa, :master, :american_express, :diners_club]
25
+ self.homepage_url = 'http://www.securepaytech.com/'
26
+ self.display_name = 'SecurePayTech'
27
+
28
+ def initialize(options = {})
29
+ requires!(options, :login, :password)
30
+ @options = options
31
+ super
32
+ end
33
+
34
+ def purchase(money, creditcard, options = {})
35
+ post = SecurePayTechPostData.new
36
+
37
+ add_invoice(post, money, options)
38
+ add_creditcard(post, creditcard)
39
+
40
+ commit(:purchase, post)
41
+ end
42
+
43
+ private
44
+
45
+ def add_invoice(post, money, options)
46
+ post[:Amount] = amount(money)
47
+ post[:Currency] = options[:currency] || currency(money)
48
+
49
+ post[:OrderReference] = options[:order_id]
50
+ end
51
+
52
+ def add_creditcard(post, creditcard)
53
+ post[:CardNumber] = creditcard.number
54
+ post[:CardExpiry] = expdate(creditcard)
55
+ post[:CardHolderName] = creditcard.name
56
+
57
+ if creditcard.verification_value?
58
+ post[:EnableCSC] = 1
59
+ post[:CSC] = creditcard.verification_value
60
+ end
61
+
62
+ # SPT will autodetect this
63
+ post[:CardType] = 0
64
+ end
65
+
66
+ def parse(body)
67
+ response = CGI.unescape(body).split(',')
68
+
69
+ result = {}
70
+ result[:result_code] = response[0].to_i
71
+
72
+ if response.length == 2
73
+ result[:fail_reason] = response[1]
74
+ else
75
+ result[:merchant_transaction_reference] = response[1]
76
+ result[:receipt_number] = response[2]
77
+ result[:transaction_number] = response[3]
78
+ result[:authorisation_id] = response[4]
79
+ result[:batch_number] = response[5]
80
+ end
81
+
82
+ result
83
+ end
84
+
85
+ def commit(action, post)
86
+ response = parse( ssl_post(URL, post_data(action, post) ) )
87
+
88
+ Response.new(response[:result_code] == 1, message_from(response), response,
89
+ :test => test?,
90
+ :authorization => response[:merchant_transaction_reference]
91
+ )
92
+ end
93
+
94
+ def message_from(result)
95
+ PAYMENT_GATEWAY_RESPONSES[result[:result_code]]
96
+ end
97
+
98
+ def post_data(action, post)
99
+ post[:MerchantID] = @options[:login]
100
+ post[:MerchantKey] = @options[:password]
101
+ post.to_s
102
+ end
103
+
104
+ def expdate(creditcard)
105
+ year = sprintf("%.4i", creditcard.year)
106
+ month = sprintf("%.2i", creditcard.month)
107
+
108
+ "#{month}#{year[-2..-1]}"
109
+ end
110
+ end
111
+ end
112
+ end
113
+
@@ -0,0 +1,453 @@
1
+ #!ruby19
2
+ # encoding: utf-8
3
+
4
+ module ActiveMerchant #:nodoc:
5
+ module Billing #:nodoc:
6
+ class SkipJackGateway < Gateway
7
+ API_VERSION = '?.?'
8
+
9
+ LIVE_HOST = "https://www.skipjackic.com"
10
+ TEST_HOST = "https://developer.skipjackic.com"
11
+
12
+ BASIC_PATH = "/scripts/evolvcc.dll"
13
+ ADVANCED_PATH = "/evolvcc/evolvcc.aspx"
14
+
15
+ ACTIONS = {
16
+ :authorization => 'AuthorizeAPI',
17
+ :change_status => 'SJAPI_TransactionChangeStatusRequest',
18
+ :get_status => 'SJAPI_TransactionStatusRequest'
19
+ }
20
+
21
+ SUCCESS_MESSAGE = 'The transaction was successful.'
22
+
23
+ MONETARY_CHANGE_STATUSES = ['AUTHORIZE', 'AUTHORIZE ADDITIONAL', 'CREDIT', 'SPLITSETTLE']
24
+
25
+ CARD_CODE_ERRORS = %w( N S "" )
26
+
27
+ CARD_CODE_MESSAGES = {
28
+ "M" => "Card verification number matched",
29
+ "N" => "Card verification number didn't match",
30
+ "P" => "Card verification number was not processed",
31
+ "S" => "Card verification number should be on card but was not indicated",
32
+ "U" => "Issuer was not certified for card verification",
33
+ "" => "Transaction failed because incorrect card verification number was entered or no number was entered"
34
+ }
35
+
36
+ AVS_ERRORS = %w( A B C E I N O P R W Z )
37
+
38
+ AVS_MESSAGES = {
39
+ "A" => "Street address matches billing information, zip/postal code does not",
40
+ "B" => "Street address match for international transaction. Postal code not verified due to incompatible formats",
41
+ "C" => "Street address and postal code not verified for internation transaction due to incompatible formats",
42
+ "D" => "Street address and postal code match for international transaction",
43
+ "E" => "Address verification service error",
44
+ "I" => "Address information not verified by international issuer",
45
+ "M" => "Street address and postal code match for international transaction",
46
+ "N" => "Neither street address nor zip/postal match billing information",
47
+ "O" => "Non-US issuer does not participate",
48
+ "P" => "Postal codes match for international transaction but street address not verified due to incompatible formats",
49
+ "P" => "Address verification not applicable for this transaction",
50
+ "R" => "Payment gateway was unavailable or timed out",
51
+ "S" => "Address verification service not supported by issuer",
52
+ "U" => "Address information is unavailable",
53
+ "W" => "9-digit zip/postal code matches billing information, street address does not",
54
+ "X" => "Street address and 9-digit zip/postal code matches billing information",
55
+ "Y" => "Street address and 5-digit zip/postal code matches billing information",
56
+ "Z" => "5-digit zip/postal code matches billing information, street address does not",
57
+ }
58
+
59
+ CHANGE_STATUS_ERROR_MESSAGES = {
60
+ '0' => 'Success',
61
+ '-1' => 'Invalid Command',
62
+ '-2' => 'Parameter Missing',
63
+ '-3' => 'Failed retrieving response',
64
+ '-4' => 'Invalid Status',
65
+ '-5' => 'Failed reading security flags',
66
+ '-6' => 'Developer serial number not found',
67
+ '-7' => 'Invalid Serial Number'
68
+ }
69
+
70
+ TRANSACTION_CURRENT_STATUS = {
71
+ '0' => 'Idle',
72
+ '1' => 'Authorized',
73
+ '2' => 'Denied',
74
+ '3' => 'Settled',
75
+ '4' => 'Credited',
76
+ '5' => 'Deleted',
77
+ '6' => 'Archived',
78
+ '7' => 'Pre-Authorized',
79
+ '8' => 'Split Settled'
80
+ }
81
+
82
+ TRANSACTION_PENDING_STATUS = {
83
+ '0' => 'Idle',
84
+ '1' => 'Pending Credit',
85
+ '2' => 'Pending Settlement',
86
+ '3' => 'Pending Authorization',
87
+ '4' => 'Pending Manual Settlement',
88
+ '5' => 'Pending Recurring'
89
+ }
90
+
91
+ RETURN_CODE_MESSAGES = {
92
+ '-1' => 'Data was not by received intact by Skipjack Transaction Network.',
93
+ '0' => 'Communication Failure. Error in Request and Response at IP level.',
94
+ '1' => 'Valid Data. Authorization request was valid.',
95
+ '-35' => 'Invalid credit card number. Retry with correct credit card number.',
96
+ '-37' => 'Merchant Processor Unavailable. Skipjack is unable to communicate with payment Processor. Retry',
97
+ '-39' => 'Length or value of HTML Serial. Number Invalid serial number. Check HTML Serial Number length and that it is a correct/valid number. Confirm you are sending to the correct environment (Development or Production)',
98
+ '-51' => 'The value or length for billing zip code is incorrect.',
99
+ '-52' => 'The value or length for shipping zip code is incorrect.',
100
+ '-53' => 'The value or length for credit card expiration month is incorrect.',
101
+ '-54' => 'The value or length of the month or year of the credit card account number was incorrect.',
102
+ '-55' => 'The value or length or billing street address is incorrect.',
103
+ '-56' => 'The value or length of the shipping address is incorrect.',
104
+ '-57' => 'The length of the transaction amount must be at least 3 digits long (excluding the decimal place).',
105
+ '-58' => 'Length or value in Merchant Name Merchant Name associated with Skipjack account is misconfigured or invalid',
106
+ '-59' => 'Length or value in Merchant Address Merchant Address associated with Skipjack account is misconfigured or invalid',
107
+ '-60' => 'Length or value in Merchant State Merchant State associated with Skipjack account is misconfigured or invalid',
108
+ '-61' => 'The value or length for shipping state/province is empty.',
109
+ '-62' => 'The value for length orderstring is empty.',
110
+ '-64' => 'The value for the phone number is incorrect.',
111
+ '-65' => 'The value or length for billing name is empty.',
112
+ '-66' => 'The value or length for billing e-mail is empty.',
113
+ '-67' => 'The value or length for billing street address is empty.',
114
+ '-68' => 'The value or length for billing city is empty.',
115
+ '-69' => 'The value or length for billing state is empty.',
116
+ '-70' => 'Empty zipcode Zip Code field is empty.',
117
+ '-71' => 'Empty ordernumber Ordernumber field is empty.',
118
+ '-72' => 'Empty accountnumber Accountnumber field is empty',
119
+ '-73' => 'Empty month Month field is empty.',
120
+ '-74' => 'Empty year Year field is empty.',
121
+ '-75' => 'Empty serialnumber Serialnumber field is empty.',
122
+ '-76' => 'Empty transactionamount Transaction amount field is empty.',
123
+ '-77' => 'Empty orderstring Orderstring field is empty.',
124
+ '-78' => 'Empty shiptophone Shiptophone field is empty.',
125
+ '-79' => 'The value or length for billing name is empty.',
126
+ '-80' => 'Length shipto name Error in the length or value of shiptophone.',
127
+ '-81' => 'Length or value of Customer location',
128
+ '-82' => 'The value or length for billing state is empty.',
129
+ '-83' => 'The value or length for shipping phone is empty.',
130
+ '-84' => 'There is already an existing pending transaction in the register sharing the posted Order Number.',
131
+ '-85' => 'Airline leg info invalid Airline leg field value is invalid or empty.',
132
+ '-86' => 'Airline ticket info invalid Airline ticket info field is invalid or empty',
133
+ '-87' => 'Point of Sale check routing number must be 9 numeric digits Point of Sale check routing number is invalid or empty.',
134
+ '-88' => 'Point of Sale check account number missing or invalid Point of Sale check account number is invalid or empty.',
135
+ '-89' => 'Point of Sale check MICR missing or invalid Point of Sale check MICR invalid or empty.',
136
+ '-90' => 'Point of Sale check number missing or invalid Point of Sale check number invalid or empty.',
137
+ '-91' => 'CVV2 Invalid or empty "Make CVV a required field feature" enabled (New feature 01 April 2006) in the Merchant Account Setup interface but no CVV code was sent in the transaction data.',
138
+ '-92' => 'Approval Code Invalid Approval Code Invalid. Approval Code is a 6 digit code.',
139
+ '-93' => 'Blind Credits Request Refused "Allow Blind Credits" option must be enabled on the Skipjack Merchant Account.',
140
+ '-94' => 'Blind Credits Failed',
141
+ '-95' => 'Voice Authorization Request Refused Voice Authorization option must be enabled on the Skipjack Merchant Account.',
142
+ '-96' => 'Voice Authorizations Failed',
143
+ '-97' => 'Fraud Rejection Violates Velocity Settling.',
144
+ '-98' => 'Invalid Discount Amount',
145
+ '-99' => 'POS PIN Debit Pin Block Debit-specific',
146
+ '-100' => 'POS PIN Debit Invalid Key Serial Number Debit-specific',
147
+ '-101' => 'Invalid Authentication Data Data for Verified by Visa/MC Secure Code is invalid.',
148
+ '-102' => 'Authentication Data Not Allowed',
149
+ '-103' => 'POS Check Invalid Birth Date POS check dateofbirth variable contains a birth date in an incorrect format. Use MM/DD/YYYY format for this variable.',
150
+ '-104' => 'POS Check Invalid Identification Type POS check identificationtype variable contains a identification type value which is invalid. Use the single digit value where Social Security Number=1, Drivers License=2 for this variable.',
151
+ '-105' => 'Invalid trackdata Track Data is in invalid format.',
152
+ '-106' => 'POS Check Invalid Account Type',
153
+ '-107' => 'POS PIN Debit Invalid Sequence Number',
154
+ '-108' => 'Invalid Transaction ID',
155
+ '-109' => 'Invalid From Account Type',
156
+ '-110' => 'Pos Error Invalid To Account Type',
157
+ '-112' => 'Pos Error Invalid Auth Option',
158
+ '-113' => 'Pos Error Transaction Failed',
159
+ '-114' => 'Pos Error Invalid Incoming Eci',
160
+ '-115' => 'POS Check Invalid Check Type',
161
+ '-116' => 'POS Check Invalid Lane Number POS Check lane or cash register number is invalid. Use a valid lane or cash register number that has been configured in the Skipjack Merchant Account.',
162
+ '-117' => 'POS Check Invalid Cashier Number'
163
+ }
164
+
165
+ self.supported_countries = ['US', 'CA']
166
+ self.supported_cardtypes = [:visa, :master, :american_express, :jcb, :discover, :diners_club]
167
+ self.homepage_url = 'http://www.skipjack.com/'
168
+ self.display_name = 'SkipJack'
169
+
170
+ # Creates a new SkipJackGateway
171
+ #
172
+ # The gateway requires that a valid login and password be passed
173
+ # in the +options+ hash.
174
+ #
175
+ # ==== Options
176
+ #
177
+ # * <tt>:login</tt> -- The SkipJack Merchant Serial Number.
178
+ # * <tt>:password</tt> -- The SkipJack Developer Serial Number.
179
+ # * <tt>:test => +true+ or +false+</tt> -- Use the test or live SkipJack url.
180
+ # * <tt>:advanced => +true+ or +false+</tt> -- Set to true if you're using an advanced processor
181
+ # See the SkipJack Integration Guide for details. (default: +false+)
182
+ def initialize(options = {})
183
+ requires!(options, :login, :password)
184
+ @options = options
185
+ super
186
+ end
187
+
188
+ def test?
189
+ @options[:test] || super
190
+ end
191
+
192
+ def authorize(money, creditcard, options = {})
193
+ requires!(options, :order_id, :email)
194
+ post = {}
195
+ add_invoice(post, options)
196
+ add_creditcard(post, creditcard)
197
+ add_address(post, options)
198
+ add_customer_data(post, options)
199
+ commit(:authorization, money, post)
200
+ end
201
+
202
+ def purchase(money, creditcard, options = {})
203
+ post = {}
204
+ authorization = authorize(money, creditcard, options)
205
+ if authorization.success?
206
+ capture(money, authorization.authorization)
207
+ else
208
+ authorization
209
+ end
210
+ end
211
+
212
+ # Captures the funds from an authorized transaction.
213
+ #
214
+ # ==== Parameters
215
+ #
216
+ # * <tt>money</tt> -- The amount to be capture as an Integer in cents.
217
+ # * <tt>authorization</tt> -- The authorization returned from the previous authorize request.
218
+ # * <tt>options</tt> -- A hash of optional parameters.
219
+ #
220
+ # ==== Options
221
+ #
222
+ # * <tt>:force_settlement</tt> -- Force the settlement to occur as soon as possible. This option is not supported by other gateways. See the SkipJack API reference for more details
223
+ def capture(money, authorization, options = {})
224
+ post = { }
225
+ add_status_action(post, 'SETTLE')
226
+ add_forced_settlement(post, options)
227
+ add_transaction_id(post, authorization)
228
+ commit(:change_status, money, post)
229
+ end
230
+
231
+ def void(authorization, options = {})
232
+ post = {}
233
+ add_status_action(post, 'DELETE')
234
+ add_forced_settlement(post, options)
235
+ add_transaction_id(post, authorization)
236
+ commit(:change_status, nil, post)
237
+ end
238
+
239
+ def credit(money, identification, options = {})
240
+ post = {}
241
+ add_status_action(post, 'CREDIT')
242
+ add_forced_settlement(post, options)
243
+ add_transaction_id(post, identification)
244
+ commit(:change_status, money, post)
245
+ end
246
+
247
+ def status(order_id)
248
+ commit(:get_status, nil, :szOrderNumber => order_id)
249
+ end
250
+
251
+ private
252
+
253
+ def advanced?
254
+ @options[:advanced]
255
+ end
256
+
257
+ def add_forced_settlement(post, options)
258
+ post[:szForceSettlement] = options[:force_settlment] ? 1 : 0
259
+ end
260
+
261
+ def add_status_action(post, action)
262
+ post[:szDesiredStatus] = action
263
+ end
264
+
265
+ def commit(action, money, parameters)
266
+ response = parse( ssl_post( url_for(action), post_data(action, money, parameters) ), action )
267
+
268
+ # Pass along the original transaction id in the case an update transaction
269
+ Response.new(response[:success], message_from(response, action), response,
270
+ :test => test?,
271
+ :authorization => response[:szTransactionFileName] || parameters[:szTransactionId],
272
+ :avs_result => { :code => response[:szAVSResponseCode] },
273
+ :cvv_result => response[:szCVV2ResponseCode]
274
+ )
275
+ end
276
+
277
+ def url_for(action)
278
+ result = test? ? TEST_HOST : LIVE_HOST
279
+ result += advanced? && action == :authorization ? ADVANCED_PATH : BASIC_PATH
280
+ result += "?#{ACTIONS[action]}"
281
+ end
282
+
283
+ def add_credentials(params, action)
284
+ if action == :authorization
285
+ params[:SerialNumber] = @options[:login]
286
+ params[:DeveloperSerialNumber] = @options[:password]
287
+ else
288
+ params[:szSerialNumber] = @options[:login]
289
+ params[:szDeveloperSerialNumber] = @options[:password]
290
+ end
291
+ end
292
+
293
+ def add_amount(params, action, money)
294
+ if action == :authorization
295
+ params[:TransactionAmount] = amount(money)
296
+ else
297
+ params[:szAmount] = amount(money) if MONETARY_CHANGE_STATUSES.include?(params[:szDesiredStatus])
298
+ end
299
+ end
300
+
301
+ def parse(body, action)
302
+ case action
303
+ when :authorization
304
+ parse_authorization_response(body)
305
+ when :get_status
306
+ parse_status_response(body, [ :SerialNumber, :TransactionAmount, :TransactionStatusCode, :TransactionStatusMessage, :OrderNumber, :TransactionDateTime, :TransactionID, :ApprovalCode, :BatchNumber ])
307
+ else
308
+ parse_status_response(body, [ :SerialNumber, :TransactionAmount, :DesiredStatus, :StatusResponse, :StatusResponseMessage, :OrderNumber, :AuditID ])
309
+ end
310
+ end
311
+
312
+ def split_lines(body)
313
+ body.split(/[\r\n]+/)
314
+ end
315
+
316
+ def split_line(line)
317
+ line.split(/","/).collect { |key| key.sub(/"*([^"]*)"*/, '\1').strip; }
318
+ end
319
+
320
+ def authorize_response_map(body)
321
+ lines = split_lines(body)
322
+ keys, values = split_line(lines[0]), split_line(lines[1])
323
+ Hash[*(keys.zip(values).flatten)].symbolize_keys
324
+ end
325
+
326
+ def parse_authorization_response(body)
327
+ result = authorize_response_map(body)
328
+ result[:success] = (result[:szIsApproved] == '1')
329
+ result
330
+ end
331
+
332
+ def parse_status_response(body, response_keys)
333
+ lines = split_lines(body)
334
+
335
+ keys = [ :szSerialNumber, :szErrorCode, :szNumberRecords]
336
+ values = split_line(lines[0])[0..2]
337
+
338
+ result = Hash[*(keys.zip(values).flatten)]
339
+
340
+ result[:szErrorMessage] = ''
341
+ result[:success] = (result[:szErrorCode] == '0')
342
+
343
+ if result[:success]
344
+ lines[1..-1].each do |line|
345
+ values = split_line(line)
346
+ response_keys.each_with_index do |key, index|
347
+ result[key] = values[index]
348
+ end
349
+ end
350
+ else
351
+ result[:szErrorMessage] = lines[1]
352
+ end
353
+ result
354
+ end
355
+
356
+ def post_data(action, money, params = {})
357
+ add_credentials(params, action)
358
+ add_amount(params, action, money)
359
+ sorted_params = params.to_a.sort{|a,b| a.to_s <=> b.to_s}.reverse
360
+ sorted_params.collect { |key, value| "#{key.to_s}=#{CGI.escape(value.to_s)}" }.join("&")
361
+ end
362
+
363
+ def add_transaction_id(post, transaction_id)
364
+ post[:szTransactionId] = transaction_id
365
+ end
366
+
367
+ def add_invoice(post, options)
368
+ post[:OrderNumber] = sanitize_order_id(options[:order_id])
369
+ post[:CustomerCode] = options[:customer].to_s.slice(0, 17)
370
+ post[:InvoiceNumber] = options[:invoice]
371
+ post[:OrderDescription] = options[:description]
372
+
373
+ if order_items = options[:items]
374
+ post[:OrderString] = order_items.collect { |item| "#{item[:sku]}~#{item[:description].tr('~','-')}~#{item[:declared_value]}~#{item[:quantity]}~#{item[:taxable]}~~~~~~~~#{item[:tax_rate]}~||"}.join
375
+ else
376
+ post[:OrderString] = '1~None~0.00~0~N~||'
377
+ end
378
+ end
379
+
380
+ def add_creditcard(post, creditcard)
381
+ post[:AccountNumber] = creditcard.number
382
+ post[:Month] = creditcard.month
383
+ post[:Year] = creditcard.year
384
+ post[:CVV2] = creditcard.verification_value if creditcard.verification_value?
385
+ post[:SJName] = creditcard.name
386
+ end
387
+
388
+ def add_customer_data(post, options)
389
+ post[:Email] = options[:email]
390
+ end
391
+
392
+ def add_address(post, options)
393
+ if address = options[:billing_address] || options[:address]
394
+ post[:StreetAddress] = address[:address1]
395
+ post[:StreetAddress2] = address[:address2]
396
+ post[:City] = address[:city]
397
+ post[:State] = address[:state]
398
+ post[:ZipCode] = address[:zip]
399
+ post[:Country] = address[:country]
400
+ post[:Phone] = address[:phone]
401
+ post[:Fax] = address[:fax]
402
+ end
403
+
404
+ if address = options[:shipping_address]
405
+ post[:ShipToName] = address[:name]
406
+ post[:ShipToStreetAddress] = address[:address1]
407
+ post[:ShipToStreetAddress2] = address[:address2]
408
+ post[:ShipToCity] = address[:city]
409
+ post[:ShipToState] = address[:state]
410
+ post[:ShipToZipCode] = address[:zip]
411
+ post[:ShipToCountry] = address[:country]
412
+ post[:ShipToPhone] = address[:phone]
413
+ post[:ShipToFax] = address[:fax]
414
+ end
415
+
416
+ # The phone number for the shipping address is required
417
+ # Use the billing address phone number if a shipping address
418
+ # phone number wasn't provided
419
+ post[:ShipToPhone] = post[:Phone] if post[:ShipToPhone].blank?
420
+ end
421
+
422
+ def message_from(response, action)
423
+ case action
424
+ when :authorization
425
+ message_from_authorization(response)
426
+ when :get_status
427
+ message_from_status(response)
428
+ else
429
+ message_from_status(response)
430
+ end
431
+ end
432
+
433
+ def message_from_authorization(response)
434
+ if response[:success]
435
+ return SUCCESS_MESSAGE
436
+ else
437
+ return CARD_CODE_MESSAGES[response[:szCVV2ResponseCode]] if CARD_CODE_ERRORS.include?(response[:szCVV2ResponseCode])
438
+ return AVS_MESSAGES[response[:szAVSResponseMessage]] if AVS_ERRORS.include?(response[:szAVSResponseCode])
439
+ return RETURN_CODE_MESSAGES[response[:szReturnCode]] if response[:szReturnCode] != '1'
440
+ return response[:szAuthorizationDeclinedMessage]
441
+ end
442
+ end
443
+
444
+ def message_from_status(response)
445
+ response[:success] ? SUCCESS_MESSAGE : response[:szErrorMessage]
446
+ end
447
+
448
+ def sanitize_order_id(value)
449
+ value.to_s.gsub(/[^\w.]/, '')
450
+ end
451
+ end
452
+ end
453
+ end