johnreitano-activemerchant 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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/billing/avs_result.rb +98 -0
  7. data/lib/active_merchant/billing/base.rb +57 -0
  8. data/lib/active_merchant/billing/check.rb +68 -0
  9. data/lib/active_merchant/billing/credit_card.rb +159 -0
  10. data/lib/active_merchant/billing/credit_card_formatting.rb +21 -0
  11. data/lib/active_merchant/billing/credit_card_methods.rb +125 -0
  12. data/lib/active_merchant/billing/cvv_result.rb +38 -0
  13. data/lib/active_merchant/billing/expiry_date.rb +34 -0
  14. data/lib/active_merchant/billing/gateway.rb +163 -0
  15. data/lib/active_merchant/billing/gateways/authorize_net.rb +654 -0
  16. data/lib/active_merchant/billing/gateways/authorize_net_cim.rb +736 -0
  17. data/lib/active_merchant/billing/gateways/beanstream/beanstream_core.rb +244 -0
  18. data/lib/active_merchant/billing/gateways/beanstream.rb +102 -0
  19. data/lib/active_merchant/billing/gateways/beanstream_interac.rb +54 -0
  20. data/lib/active_merchant/billing/gateways/bogus.rb +98 -0
  21. data/lib/active_merchant/billing/gateways/braintree.rb +17 -0
  22. data/lib/active_merchant/billing/gateways/card_stream.rb +230 -0
  23. data/lib/active_merchant/billing/gateways/cyber_source.rb +594 -0
  24. data/lib/active_merchant/billing/gateways/data_cash.rb +593 -0
  25. data/lib/active_merchant/billing/gateways/efsnet.rb +229 -0
  26. data/lib/active_merchant/billing/gateways/elavon.rb +134 -0
  27. data/lib/active_merchant/billing/gateways/eway.rb +277 -0
  28. data/lib/active_merchant/billing/gateways/exact.rb +222 -0
  29. data/lib/active_merchant/billing/gateways/first_pay.rb +172 -0
  30. data/lib/active_merchant/billing/gateways/instapay.rb +164 -0
  31. data/lib/active_merchant/billing/gateways/jetpay.rb +270 -0
  32. data/lib/active_merchant/billing/gateways/linkpoint.rb +449 -0
  33. data/lib/active_merchant/billing/gateways/merchant_e_solutions.rb +154 -0
  34. data/lib/active_merchant/billing/gateways/merchant_ware.rb +283 -0
  35. data/lib/active_merchant/billing/gateways/modern_payments.rb +36 -0
  36. data/lib/active_merchant/billing/gateways/modern_payments_cim.rb +220 -0
  37. data/lib/active_merchant/billing/gateways/moneris.rb +205 -0
  38. data/lib/active_merchant/billing/gateways/net_registry.rb +189 -0
  39. data/lib/active_merchant/billing/gateways/netbilling.rb +168 -0
  40. data/lib/active_merchant/billing/gateways/ogone.rb +279 -0
  41. data/lib/active_merchant/billing/gateways/pay_junction.rb +392 -0
  42. data/lib/active_merchant/billing/gateways/pay_secure.rb +120 -0
  43. data/lib/active_merchant/billing/gateways/payflow/payflow_common_api.rb +207 -0
  44. data/lib/active_merchant/billing/gateways/payflow/payflow_express_response.rb +39 -0
  45. data/lib/active_merchant/billing/gateways/payflow/payflow_response.rb +13 -0
  46. data/lib/active_merchant/billing/gateways/payflow.rb +236 -0
  47. data/lib/active_merchant/billing/gateways/payflow_express.rb +138 -0
  48. data/lib/active_merchant/billing/gateways/payflow_express_uk.rb +15 -0
  49. data/lib/active_merchant/billing/gateways/payflow_uk.rb +21 -0
  50. data/lib/active_merchant/billing/gateways/payment_express.rb +230 -0
  51. data/lib/active_merchant/billing/gateways/paypal/paypal_common_api.rb +326 -0
  52. data/lib/active_merchant/billing/gateways/paypal/paypal_express_response.rb +38 -0
  53. data/lib/active_merchant/billing/gateways/paypal.rb +121 -0
  54. data/lib/active_merchant/billing/gateways/paypal_ca.rb +13 -0
  55. data/lib/active_merchant/billing/gateways/paypal_express.rb +130 -0
  56. data/lib/active_merchant/billing/gateways/paypal_express_common.rb +20 -0
  57. data/lib/active_merchant/billing/gateways/plugnpay.rb +292 -0
  58. data/lib/active_merchant/billing/gateways/psigate.rb +214 -0
  59. data/lib/active_merchant/billing/gateways/psl_card.rb +304 -0
  60. data/lib/active_merchant/billing/gateways/quickpay.rb +213 -0
  61. data/lib/active_merchant/billing/gateways/realex.rb +200 -0
  62. data/lib/active_merchant/billing/gateways/sage/sage_bankcard.rb +88 -0
  63. data/lib/active_merchant/billing/gateways/sage/sage_core.rb +116 -0
  64. data/lib/active_merchant/billing/gateways/sage/sage_virtual_check.rb +97 -0
  65. data/lib/active_merchant/billing/gateways/sage.rb +146 -0
  66. data/lib/active_merchant/billing/gateways/sage_pay.rb +309 -0
  67. data/lib/active_merchant/billing/gateways/sallie_mae.rb +144 -0
  68. data/lib/active_merchant/billing/gateways/secure_pay.rb +31 -0
  69. data/lib/active_merchant/billing/gateways/secure_pay_au.rb +157 -0
  70. data/lib/active_merchant/billing/gateways/secure_pay_tech.rb +113 -0
  71. data/lib/active_merchant/billing/gateways/skip_jack.rb +453 -0
  72. data/lib/active_merchant/billing/gateways/smart_ps.rb +265 -0
  73. data/lib/active_merchant/billing/gateways/trans_first.rb +127 -0
  74. data/lib/active_merchant/billing/gateways/transax.rb +25 -0
  75. data/lib/active_merchant/billing/gateways/trust_commerce.rb +418 -0
  76. data/lib/active_merchant/billing/gateways/usa_epay.rb +194 -0
  77. data/lib/active_merchant/billing/gateways/verifi.rb +228 -0
  78. data/lib/active_merchant/billing/gateways/viaklix.rb +189 -0
  79. data/lib/active_merchant/billing/gateways/wirecard.rb +318 -0
  80. data/lib/active_merchant/billing/gateways.rb +18 -0
  81. data/lib/active_merchant/billing/integrations/action_view_helper.rb +79 -0
  82. data/lib/active_merchant/billing/integrations/bogus/helper.rb +17 -0
  83. data/lib/active_merchant/billing/integrations/bogus/notification.rb +11 -0
  84. data/lib/active_merchant/billing/integrations/bogus/return.rb +10 -0
  85. data/lib/active_merchant/billing/integrations/bogus.rb +23 -0
  86. data/lib/active_merchant/billing/integrations/chronopay/helper.rb +120 -0
  87. data/lib/active_merchant/billing/integrations/chronopay/notification.rb +158 -0
  88. data/lib/active_merchant/billing/integrations/chronopay/return.rb +10 -0
  89. data/lib/active_merchant/billing/integrations/chronopay.rb +23 -0
  90. data/lib/active_merchant/billing/integrations/gestpay/common.rb +42 -0
  91. data/lib/active_merchant/billing/integrations/gestpay/helper.rb +70 -0
  92. data/lib/active_merchant/billing/integrations/gestpay/notification.rb +85 -0
  93. data/lib/active_merchant/billing/integrations/gestpay/return.rb +10 -0
  94. data/lib/active_merchant/billing/integrations/gestpay.rb +25 -0
  95. data/lib/active_merchant/billing/integrations/helper.rb +93 -0
  96. data/lib/active_merchant/billing/integrations/hi_trust/helper.rb +58 -0
  97. data/lib/active_merchant/billing/integrations/hi_trust/notification.rb +59 -0
  98. data/lib/active_merchant/billing/integrations/hi_trust/return.rb +67 -0
  99. data/lib/active_merchant/billing/integrations/hi_trust.rb +27 -0
  100. data/lib/active_merchant/billing/integrations/nochex/helper.rb +68 -0
  101. data/lib/active_merchant/billing/integrations/nochex/notification.rb +94 -0
  102. data/lib/active_merchant/billing/integrations/nochex/return.rb +10 -0
  103. data/lib/active_merchant/billing/integrations/nochex.rb +88 -0
  104. data/lib/active_merchant/billing/integrations/notification.rb +62 -0
  105. data/lib/active_merchant/billing/integrations/paypal/helper.rb +119 -0
  106. data/lib/active_merchant/billing/integrations/paypal/notification.rb +154 -0
  107. data/lib/active_merchant/billing/integrations/paypal/return.rb +10 -0
  108. data/lib/active_merchant/billing/integrations/paypal.rb +39 -0
  109. data/lib/active_merchant/billing/integrations/quickpay/helper.rb +72 -0
  110. data/lib/active_merchant/billing/integrations/quickpay/notification.rb +74 -0
  111. data/lib/active_merchant/billing/integrations/quickpay.rb +17 -0
  112. data/lib/active_merchant/billing/integrations/return.rb +35 -0
  113. data/lib/active_merchant/billing/integrations/two_checkout/helper.rb +59 -0
  114. data/lib/active_merchant/billing/integrations/two_checkout/notification.rb +114 -0
  115. data/lib/active_merchant/billing/integrations/two_checkout/return.rb +17 -0
  116. data/lib/active_merchant/billing/integrations/two_checkout.rb +23 -0
  117. data/lib/active_merchant/billing/integrations.rb +29 -0
  118. data/lib/active_merchant/billing/response.rb +32 -0
  119. data/lib/active_merchant/billing.rb +9 -0
  120. data/lib/active_merchant/lib/connection.rb +170 -0
  121. data/lib/active_merchant/lib/country.rb +319 -0
  122. data/lib/active_merchant/lib/error.rb +4 -0
  123. data/lib/active_merchant/lib/post_data.rb +22 -0
  124. data/lib/active_merchant/lib/posts_data.rb +47 -0
  125. data/lib/active_merchant/lib/requires_parameters.rb +16 -0
  126. data/lib/active_merchant/lib/utils.rb +18 -0
  127. data/lib/active_merchant/lib/validateable.rb +76 -0
  128. data/lib/active_merchant.rb +46 -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,138 @@
1
+ require File.dirname(__FILE__) + '/payflow/payflow_common_api'
2
+ require File.dirname(__FILE__) + '/payflow/payflow_express_response'
3
+ require File.dirname(__FILE__) + '/paypal_express_common'
4
+
5
+ module ActiveMerchant #:nodoc:
6
+ module Billing #:nodoc:
7
+ class PayflowExpressGateway < Gateway
8
+ include PayflowCommonAPI
9
+ include PaypalExpressCommon
10
+
11
+ self.test_redirect_url = 'https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token='
12
+ self.homepage_url = 'https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside'
13
+ self.display_name = 'PayPal Express Checkout'
14
+
15
+ def authorize(money, options = {})
16
+ requires!(options, :token, :payer_id)
17
+ request = build_sale_or_authorization_request('Authorization', money, options)
18
+ commit(request)
19
+ end
20
+
21
+ def purchase(money, options = {})
22
+ requires!(options, :token, :payer_id)
23
+ request = build_sale_or_authorization_request('Sale', money, options)
24
+ commit(request)
25
+ end
26
+
27
+ def credit(money, identification, options = {})
28
+ request = build_reference_request(:credit, money, identification, options)
29
+ commit(request)
30
+ end
31
+
32
+ def setup_authorization(money, options = {})
33
+ requires!(options, :return_url, :cancel_return_url)
34
+
35
+ request = build_setup_express_sale_or_authorization_request('Authorization', money, options)
36
+ commit(request)
37
+ end
38
+
39
+ def setup_purchase(money, options = {})
40
+ requires!(options, :return_url, :cancel_return_url)
41
+
42
+ request = build_setup_express_sale_or_authorization_request('Sale', money, options)
43
+ commit(request)
44
+ end
45
+
46
+ def details_for(token)
47
+ request = build_get_express_details_request(token)
48
+ commit(request)
49
+ end
50
+
51
+ private
52
+ def build_get_express_details_request(token)
53
+ xml = Builder::XmlMarkup.new :indent => 2
54
+ xml.tag! 'GetExpressCheckout' do
55
+ xml.tag! 'Authorization' do
56
+ xml.tag! 'PayData' do
57
+ xml.tag! 'Tender' do
58
+ xml.tag! 'PayPal' do
59
+ xml.tag! 'Token', token
60
+ end
61
+ end
62
+ end
63
+ end
64
+ end
65
+ xml.target!
66
+ end
67
+
68
+ def build_setup_express_sale_or_authorization_request(action, money, options = {})
69
+ xml = Builder::XmlMarkup.new :indent => 2
70
+ xml.tag! 'SetExpressCheckout' do
71
+ xml.tag! action do
72
+ xml.tag! 'PayData' do
73
+ xml.tag! 'Invoice' do
74
+ xml.tag! 'CustIP', options[:ip] unless options[:ip].blank?
75
+ xml.tag! 'InvNum', options[:order_id] unless options[:order_id].blank?
76
+ xml.tag! 'Description', options[:description] unless options[:description].blank?
77
+
78
+ billing_address = options[:billing_address] || options[:address]
79
+ add_address(xml, 'BillTo', billing_address, options) if billing_address
80
+ add_address(xml, 'ShipTo', options[:shipping_address], options) if options[:shipping_address]
81
+
82
+ xml.tag! 'TotalAmt', amount(money), 'Currency' => options[:currency] || currency(money)
83
+ end
84
+
85
+ xml.tag! 'Tender' do
86
+ add_paypal_details(xml, options)
87
+ end
88
+ end
89
+ end
90
+ end
91
+ xml.target!
92
+ end
93
+
94
+ def build_sale_or_authorization_request(action, money, options)
95
+ xml = Builder::XmlMarkup.new :indent => 2
96
+ xml.tag! 'DoExpressCheckout' do
97
+ xml.tag! action do
98
+ xml.tag! 'PayData' do
99
+ xml.tag! 'Invoice' do
100
+ xml.tag! 'TotalAmt', amount(money), 'Currency' => options[:currency] || currency(money)
101
+ end
102
+ xml.tag! 'Tender' do
103
+ add_paypal_details xml, options
104
+ end
105
+ end
106
+ end
107
+ end
108
+ xml.target!
109
+ end
110
+
111
+ def add_paypal_details(xml, options)
112
+ xml.tag! 'PayPal' do
113
+ xml.tag! 'EMail', options[:email] unless options[:email].blank?
114
+ xml.tag! 'ReturnURL', options[:return_url] unless options[:return_url].blank?
115
+ xml.tag! 'CancelURL', options[:cancel_return_url] unless options[:cancel_return_url].blank?
116
+ xml.tag! 'NotifyURL', options[:notify_url] unless options[:notify_url].blank?
117
+ xml.tag! 'PayerID', options[:payer_id] unless options[:payer_id].blank?
118
+ xml.tag! 'Token', options[:token] unless options[:token].blank?
119
+ xml.tag! 'NoShipping', options[:no_shipping] ? '1' : '0'
120
+ xml.tag! 'AddressOverride', options[:address_override] ? '1' : '0'
121
+ xml.tag! 'ButtonSource', application_id.to_s.slice(0,32) unless application_id.blank?
122
+
123
+ # Customization of the payment page
124
+ xml.tag! 'PageStyle', options[:page_style] unless options[:page_style].blank?
125
+ xml.tag! 'HeaderImage', options[:header_image] unless options[:header_image].blank?
126
+ xml.tag! 'HeaderBackColor', options[:header_background_color] unless options[:header_background_color].blank?
127
+ xml.tag! 'HeaderBorderColor', options[:header_border_color] unless options[:header_border_color].blank?
128
+ xml.tag! 'PayflowColor', options[:background_color] unless options[:background_color].blank?
129
+ end
130
+ end
131
+
132
+ def build_response(success, message, response, options = {})
133
+ PayflowExpressResponse.new(success, message, response, options)
134
+ end
135
+ end
136
+ end
137
+ end
138
+
@@ -0,0 +1,15 @@
1
+ require File.dirname(__FILE__) + '/payflow_express'
2
+
3
+ module ActiveMerchant #:nodoc:
4
+ module Billing #:nodoc:
5
+ class PayflowExpressUkGateway < PayflowExpressGateway
6
+ self.default_currency = 'GBP'
7
+ self.partner = 'PayPalUk'
8
+
9
+ self.supported_countries = ['GB']
10
+ self.homepage_url = 'https://www.paypal.com/uk/cgi-bin/webscr?cmd=_additional-payment-overview-outside'
11
+ self.display_name = 'PayPal Express Checkout (UK)'
12
+ end
13
+ end
14
+ end
15
+
@@ -0,0 +1,21 @@
1
+ require File.dirname(__FILE__) + '/payflow'
2
+ require File.dirname(__FILE__) + '/payflow_express_uk'
3
+
4
+ module ActiveMerchant #:nodoc:
5
+ module Billing #:nodoc:
6
+ class PayflowUkGateway < PayflowGateway
7
+ self.default_currency = 'GBP'
8
+ self.partner = 'PayPalUk'
9
+
10
+ def express
11
+ @express ||= PayflowExpressUkGateway.new(@options)
12
+ end
13
+
14
+ self.supported_cardtypes = [:visa, :master, :american_express, :discover, :solo, :switch]
15
+ self.supported_countries = ['GB']
16
+ self.homepage_url = 'https://www.paypal.com/uk/cgi-bin/webscr?cmd=_wp-pro-overview-outside'
17
+ self.display_name = 'PayPal Website Payments Pro (UK)'
18
+ end
19
+ end
20
+ end
21
+
@@ -0,0 +1,230 @@
1
+ require 'rexml/document'
2
+
3
+ module ActiveMerchant #:nodoc:
4
+ module Billing #:nodoc:
5
+
6
+ # In NZ DPS supports ANZ, Westpac, National Bank, ASB and BNZ.
7
+ # In Australia DPS supports ANZ, NAB, Westpac, CBA, St George and Bank of South Australia.
8
+ # The Maybank in Malaysia is supported and the Citibank for Singapore.
9
+ class PaymentExpressGateway < Gateway
10
+ self.default_currency = 'NZD'
11
+ # PS supports all major credit cards; Visa, Mastercard, Amex, Diners, BankCard & JCB.
12
+ # Various white label cards can be accepted as well; Farmers, AirNZCard and Elders etc.
13
+ # Please note that not all acquirers and Eftpos networks can support some of these card types.
14
+ # VISA, Mastercard, Diners Club and Farmers cards are supported
15
+ #
16
+ # However, regular accounts with DPS only support VISA and Mastercard
17
+ self.supported_cardtypes = [ :visa, :master, :american_express, :diners_club, :jcb ]
18
+
19
+ self.supported_countries = [ 'AU', 'MY', 'NZ', 'SG', 'ZA', 'GB', 'US' ]
20
+
21
+ self.homepage_url = 'http://www.paymentexpress.com/'
22
+ self.display_name = 'PaymentExpress'
23
+
24
+ URL = 'https://www.paymentexpress.com/pxpost.aspx'
25
+
26
+ APPROVED = '1'
27
+
28
+ TRANSACTIONS = {
29
+ :purchase => 'Purchase',
30
+ :credit => 'Refund',
31
+ :authorization => 'Auth',
32
+ :capture => 'Complete',
33
+ :validate => 'Validate'
34
+ }
35
+
36
+ # We require the DPS gateway username and password when the object is created.
37
+ def initialize(options = {})
38
+ # A DPS username and password must exist
39
+ requires!(options, :login, :password)
40
+ # Make the options an instance variable
41
+ @options = options
42
+ super
43
+ end
44
+
45
+ # Funds are transferred immediately.
46
+ def purchase(money, payment_source, options = {})
47
+ request = build_purchase_or_authorization_request(money, payment_source, options)
48
+ commit(:purchase, request)
49
+ end
50
+
51
+ # NOTE: Perhaps in options we allow a transaction note to be inserted
52
+ # Verifies that funds are available for the requested card and amount and reserves the specified amount.
53
+ # See: http://www.paymentexpress.com/technical_resources/ecommerce_nonhosted/pxpost.html#Authcomplete
54
+ def authorize(money, payment_source, options = {})
55
+ request = build_purchase_or_authorization_request(money, payment_source, options)
56
+ commit(:authorization, request)
57
+ end
58
+
59
+ # Transfer pre-authorized funds immediately
60
+ # See: http://www.paymentexpress.com/technical_resources/ecommerce_nonhosted/pxpost.html#Authcomplete
61
+ def capture(money, identification, options = {})
62
+ request = build_capture_or_credit_request(money, identification, options)
63
+ commit(:capture, request)
64
+ end
65
+
66
+ # Refund funds to the card holder
67
+ def credit(money, identification, options = {})
68
+ requires!(options, :description)
69
+
70
+ request = build_capture_or_credit_request(money, identification, options)
71
+ commit(:credit, request)
72
+ end
73
+
74
+ # token based billing
75
+
76
+ # initiates a "Validate" transcation to store card data on payment express servers
77
+ # returns a "token" that can be used to rebill this card
78
+ # see: http://www.paymentexpress.com/technical_resources/ecommerce_nonhosted/pxpost.html#Tokenbilling
79
+ # PaymentExpress does not support unstoring a stored card.
80
+ def store(credit_card, options = {})
81
+ request = build_token_request(credit_card, options)
82
+ commit(:validate, request)
83
+ end
84
+
85
+ private
86
+
87
+ def build_purchase_or_authorization_request(money, payment_source, options)
88
+ result = new_transaction
89
+
90
+ if payment_source.is_a?(String)
91
+ add_billing_token(result, payment_source)
92
+ else
93
+ add_credit_card(result, payment_source)
94
+ end
95
+
96
+ add_amount(result, money, options)
97
+ add_invoice(result, options)
98
+ add_address_verification_data(result, options)
99
+ result
100
+ end
101
+
102
+ def build_capture_or_credit_request(money, identification, options)
103
+ result = new_transaction
104
+
105
+ add_amount(result, money, options)
106
+ add_invoice(result, options)
107
+ add_reference(result, identification)
108
+ result
109
+ end
110
+
111
+ def build_token_request(credit_card, options)
112
+ result = new_transaction
113
+ add_credit_card(result, credit_card)
114
+ add_amount(result, 100, options) #need to make an auth request for $1
115
+ add_token_request(result, options)
116
+ result
117
+ end
118
+
119
+ def add_credentials(xml)
120
+ xml.add_element("PostUsername").text = @options[:login]
121
+ xml.add_element("PostPassword").text = @options[:password]
122
+ end
123
+
124
+ def add_reference(xml, identification)
125
+ xml.add_element("DpsTxnRef").text = identification
126
+ end
127
+
128
+ def add_credit_card(xml, credit_card)
129
+ xml.add_element("CardHolderName").text = credit_card.name
130
+ xml.add_element("CardNumber").text = credit_card.number
131
+ xml.add_element("DateExpiry").text = format_date(credit_card.month, credit_card.year)
132
+
133
+ if credit_card.verification_value?
134
+ xml.add_element("Cvc2").text = credit_card.verification_value
135
+ end
136
+
137
+ if requires_start_date_or_issue_number?(credit_card)
138
+ xml.add_element("DateStart").text = format_date(credit_card.start_month, credit_card.start_year) unless credit_card.start_month.blank? || credit_card.start_year.blank?
139
+ xml.add_element("IssueNumber").text = credit_card.issue_number unless credit_card.issue_number.blank?
140
+ end
141
+ end
142
+
143
+ def add_billing_token(xml, token)
144
+ xml.add_element("DpsBillingId").text = token
145
+ end
146
+
147
+ def add_token_request(xml, options)
148
+ xml.add_element("BillingId").text = options[:billing_id] if options[:billing_id]
149
+ xml.add_element("EnableAddBillCard").text = 1
150
+ end
151
+
152
+ def add_amount(xml, money, options)
153
+ xml.add_element("Amount").text = amount(money)
154
+ xml.add_element("InputCurrency").text = options[:currency] || currency(money)
155
+ end
156
+
157
+ def add_transaction_type(xml, action)
158
+ xml.add_element("TxnType").text = TRANSACTIONS[action]
159
+ end
160
+
161
+ def add_invoice(xml, options)
162
+ xml.add_element("TxnId").text = options[:order_id].to_s.slice(0, 16) unless options[:order_id].blank?
163
+ xml.add_element("MerchantReference").text = options[:description] unless options[:description].blank?
164
+ end
165
+
166
+ def add_address_verification_data(xml, options)
167
+ address = options[:billing_address] || options[:address]
168
+ return if address.nil?
169
+
170
+ xml.add_element("EnableAvsData").text = 1
171
+ xml.add_element("AvsAction").text = 1
172
+
173
+ xml.add_element("AvsStreetAddress").text = address[:address1]
174
+ xml.add_element("AvsPostCode").text = address[:zip]
175
+ end
176
+
177
+ def new_transaction
178
+ REXML::Document.new.add_element("Txn")
179
+ end
180
+
181
+ # Take in the request and post it to DPS
182
+ def commit(action, request)
183
+ add_credentials(request)
184
+ add_transaction_type(request, action)
185
+
186
+ # Parse the XML response
187
+ response = parse( ssl_post(URL, request.to_s) )
188
+
189
+ # Return a response
190
+ PaymentExpressResponse.new(response[:success] == APPROVED, response[:response_text], response,
191
+ :test => response[:test_mode] == '1',
192
+ :authorization => response[:dps_txn_ref]
193
+ )
194
+ end
195
+
196
+ # Response XML documentation: http://www.paymentexpress.com/technical_resources/ecommerce_nonhosted/pxpost.html#XMLTxnOutput
197
+ def parse(xml_string)
198
+ response = {}
199
+
200
+ xml = REXML::Document.new(xml_string)
201
+
202
+ # Gather all root elements such as HelpText
203
+ xml.elements.each('Txn/*') do |element|
204
+ response[element.name.underscore.to_sym] = element.text unless element.name == 'Transaction'
205
+ end
206
+
207
+ # Gather all transaction elements and prefix with "account_"
208
+ # So we could access the MerchantResponseText by going
209
+ # response[account_merchant_response_text]
210
+ xml.elements.each('Txn/Transaction/*') do |element|
211
+ response[element.name.underscore.to_sym] = element.text
212
+ end
213
+
214
+ response
215
+ end
216
+
217
+ def format_date(month, year)
218
+ "#{format(month, :two_digits)}#{format(year, :two_digits)}"
219
+ end
220
+ end
221
+
222
+ class PaymentExpressResponse < Response
223
+ # add a method to response so we can easily get the token
224
+ # for Validate transactions
225
+ def token
226
+ @params["billing_id"] || @params["dps_billing_id"]
227
+ end
228
+ end
229
+ end
230
+ end