aktivemerchant 2.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (193) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG +1596 -0
  3. data/CONTRIBUTORS +511 -0
  4. data/MIT-LICENSE +20 -0
  5. data/README.md +18 -0
  6. data/lib/active_merchant.rb +108 -0
  7. data/lib/active_merchant/billing.rb +13 -0
  8. data/lib/active_merchant/billing/apple_pay_payment_token.rb +22 -0
  9. data/lib/active_merchant/billing/avs_result.rb +98 -0
  10. data/lib/active_merchant/billing/base.rb +72 -0
  11. data/lib/active_merchant/billing/check.rb +76 -0
  12. data/lib/active_merchant/billing/compatibility.rb +120 -0
  13. data/lib/active_merchant/billing/credit_card.rb +352 -0
  14. data/lib/active_merchant/billing/credit_card_formatting.rb +24 -0
  15. data/lib/active_merchant/billing/credit_card_methods.rb +160 -0
  16. data/lib/active_merchant/billing/cvv_result.rb +38 -0
  17. data/lib/active_merchant/billing/gateway.rb +268 -0
  18. data/lib/active_merchant/billing/gateways.rb +17 -0
  19. data/lib/active_merchant/billing/gateways/adyen.rb +209 -0
  20. data/lib/active_merchant/billing/gateways/alfabank.rb +117 -0
  21. data/lib/active_merchant/billing/gateways/app55.rb +176 -0
  22. data/lib/active_merchant/billing/gateways/authorize_net.rb +419 -0
  23. data/lib/active_merchant/billing/gateways/authorize_net_arb.rb +417 -0
  24. data/lib/active_merchant/billing/gateways/authorize_net_cim.rb +976 -0
  25. data/lib/active_merchant/billing/gateways/balanced.rb +256 -0
  26. data/lib/active_merchant/billing/gateways/bank_frick.rb +225 -0
  27. data/lib/active_merchant/billing/gateways/banwire.rb +105 -0
  28. data/lib/active_merchant/billing/gateways/barclays_epdq.rb +314 -0
  29. data/lib/active_merchant/billing/gateways/barclays_epdq_extra_plus.rb +15 -0
  30. data/lib/active_merchant/billing/gateways/be2bill.rb +131 -0
  31. data/lib/active_merchant/billing/gateways/beanstream.rb +188 -0
  32. data/lib/active_merchant/billing/gateways/beanstream/beanstream_core.rb +393 -0
  33. data/lib/active_merchant/billing/gateways/beanstream_interac.rb +54 -0
  34. data/lib/active_merchant/billing/gateways/blue_pay.rb +506 -0
  35. data/lib/active_merchant/billing/gateways/bogus.rb +140 -0
  36. data/lib/active_merchant/billing/gateways/borgun.rb +210 -0
  37. data/lib/active_merchant/billing/gateways/braintree.rb +19 -0
  38. data/lib/active_merchant/billing/gateways/braintree/braintree_common.rb +9 -0
  39. data/lib/active_merchant/billing/gateways/braintree_blue.rb +515 -0
  40. data/lib/active_merchant/billing/gateways/braintree_orange.rb +20 -0
  41. data/lib/active_merchant/billing/gateways/bridge_pay.rb +189 -0
  42. data/lib/active_merchant/billing/gateways/card_save.rb +23 -0
  43. data/lib/active_merchant/billing/gateways/card_stream.rb +220 -0
  44. data/lib/active_merchant/billing/gateways/cashnet.rb +191 -0
  45. data/lib/active_merchant/billing/gateways/cc5.rb +201 -0
  46. data/lib/active_merchant/billing/gateways/cecabank.rb +229 -0
  47. data/lib/active_merchant/billing/gateways/certo_direct.rb +278 -0
  48. data/lib/active_merchant/billing/gateways/checkout.rb +213 -0
  49. data/lib/active_merchant/billing/gateways/commercegate.rb +143 -0
  50. data/lib/active_merchant/billing/gateways/conekta.rb +209 -0
  51. data/lib/active_merchant/billing/gateways/cyber_source.rb +709 -0
  52. data/lib/active_merchant/billing/gateways/data_cash.rb +600 -0
  53. data/lib/active_merchant/billing/gateways/efsnet.rb +219 -0
  54. data/lib/active_merchant/billing/gateways/elavon.rb +348 -0
  55. data/lib/active_merchant/billing/gateways/epay.rb +275 -0
  56. data/lib/active_merchant/billing/gateways/evo_ca.rb +308 -0
  57. data/lib/active_merchant/billing/gateways/eway.rb +214 -0
  58. data/lib/active_merchant/billing/gateways/eway_managed.rb +291 -0
  59. data/lib/active_merchant/billing/gateways/eway_rapid.rb +524 -0
  60. data/lib/active_merchant/billing/gateways/exact.rb +218 -0
  61. data/lib/active_merchant/billing/gateways/fat_zebra.rb +173 -0
  62. data/lib/active_merchant/billing/gateways/federated_canada.rb +160 -0
  63. data/lib/active_merchant/billing/gateways/finansbank.rb +23 -0
  64. data/lib/active_merchant/billing/gateways/first_giving.rb +143 -0
  65. data/lib/active_merchant/billing/gateways/first_pay.rb +160 -0
  66. data/lib/active_merchant/billing/gateways/firstdata_e4.rb +355 -0
  67. data/lib/active_merchant/billing/gateways/garanti.rb +257 -0
  68. data/lib/active_merchant/billing/gateways/global_transport.rb +183 -0
  69. data/lib/active_merchant/billing/gateways/hdfc.rb +207 -0
  70. data/lib/active_merchant/billing/gateways/hps.rb +288 -0
  71. data/lib/active_merchant/billing/gateways/iats_payments.rb +251 -0
  72. data/lib/active_merchant/billing/gateways/ideal/ideal_base.rb +246 -0
  73. data/lib/active_merchant/billing/gateways/ideal/ideal_rabobank.pem +13 -0
  74. data/lib/active_merchant/billing/gateways/ideal/ideal_response.rb +29 -0
  75. data/lib/active_merchant/billing/gateways/ideal_rabobank.rb +66 -0
  76. data/lib/active_merchant/billing/gateways/inspire.rb +213 -0
  77. data/lib/active_merchant/billing/gateways/instapay.rb +163 -0
  78. data/lib/active_merchant/billing/gateways/iridium.rb +457 -0
  79. data/lib/active_merchant/billing/gateways/itransact.rb +448 -0
  80. data/lib/active_merchant/billing/gateways/jetpay.rb +275 -0
  81. data/lib/active_merchant/billing/gateways/linkpoint.rb +438 -0
  82. data/lib/active_merchant/billing/gateways/litle.rb +346 -0
  83. data/lib/active_merchant/billing/gateways/maxipago.rb +197 -0
  84. data/lib/active_merchant/billing/gateways/merchant_e_solutions.rb +170 -0
  85. data/lib/active_merchant/billing/gateways/merchant_one.rb +114 -0
  86. data/lib/active_merchant/billing/gateways/merchant_ware.rb +319 -0
  87. data/lib/active_merchant/billing/gateways/merchant_ware_version_four.rb +268 -0
  88. data/lib/active_merchant/billing/gateways/merchant_warrior.rb +195 -0
  89. data/lib/active_merchant/billing/gateways/mercury.rb +333 -0
  90. data/lib/active_merchant/billing/gateways/metrics_global.rb +303 -0
  91. data/lib/active_merchant/billing/gateways/migs.rb +265 -0
  92. data/lib/active_merchant/billing/gateways/migs/migs_codes.rb +100 -0
  93. data/lib/active_merchant/billing/gateways/modern_payments.rb +37 -0
  94. data/lib/active_merchant/billing/gateways/modern_payments_cim.rb +219 -0
  95. data/lib/active_merchant/billing/gateways/moneris.rb +309 -0
  96. data/lib/active_merchant/billing/gateways/moneris_us.rb +291 -0
  97. data/lib/active_merchant/billing/gateways/money_movers.rb +152 -0
  98. data/lib/active_merchant/billing/gateways/nab_transact.rb +280 -0
  99. data/lib/active_merchant/billing/gateways/net_registry.rb +198 -0
  100. data/lib/active_merchant/billing/gateways/netaxept.rb +181 -0
  101. data/lib/active_merchant/billing/gateways/netbilling.rb +190 -0
  102. data/lib/active_merchant/billing/gateways/netpay.rb +223 -0
  103. data/lib/active_merchant/billing/gateways/network_merchants.rb +242 -0
  104. data/lib/active_merchant/billing/gateways/nmi.rb +256 -0
  105. data/lib/active_merchant/billing/gateways/ogone.rb +435 -0
  106. data/lib/active_merchant/billing/gateways/openpay.rb +194 -0
  107. data/lib/active_merchant/billing/gateways/optimal_payment.rb +313 -0
  108. data/lib/active_merchant/billing/gateways/orbital.rb +803 -0
  109. data/lib/active_merchant/billing/gateways/orbital/orbital_soft_descriptors.rb +47 -0
  110. data/lib/active_merchant/billing/gateways/pac_net_raven.rb +207 -0
  111. data/lib/active_merchant/billing/gateways/pago_facil.rb +122 -0
  112. data/lib/active_merchant/billing/gateways/pay_gate_xml.rb +261 -0
  113. data/lib/active_merchant/billing/gateways/pay_junction.rb +390 -0
  114. data/lib/active_merchant/billing/gateways/pay_secure.rb +112 -0
  115. data/lib/active_merchant/billing/gateways/pay_u_latam.rb +462 -0
  116. data/lib/active_merchant/billing/gateways/paybox_direct.rb +188 -0
  117. data/lib/active_merchant/billing/gateways/payex.rb +412 -0
  118. data/lib/active_merchant/billing/gateways/payflow.rb +304 -0
  119. data/lib/active_merchant/billing/gateways/payflow/payflow_common_api.rb +209 -0
  120. data/lib/active_merchant/billing/gateways/payflow/payflow_express_response.rb +39 -0
  121. data/lib/active_merchant/billing/gateways/payflow/payflow_response.rb +13 -0
  122. data/lib/active_merchant/billing/gateways/payflow_express.rb +224 -0
  123. data/lib/active_merchant/billing/gateways/payflow_express_uk.rb +15 -0
  124. data/lib/active_merchant/billing/gateways/payflow_uk.rb +21 -0
  125. data/lib/active_merchant/billing/gateways/payment_express.rb +353 -0
  126. data/lib/active_merchant/billing/gateways/paymill.rb +281 -0
  127. data/lib/active_merchant/billing/gateways/paypal.rb +117 -0
  128. data/lib/active_merchant/billing/gateways/paypal/paypal_common_api.rb +670 -0
  129. data/lib/active_merchant/billing/gateways/paypal/paypal_express_response.rb +65 -0
  130. data/lib/active_merchant/billing/gateways/paypal/paypal_recurring_api.rb +262 -0
  131. data/lib/active_merchant/billing/gateways/paypal_ca.rb +13 -0
  132. data/lib/active_merchant/billing/gateways/paypal_digital_goods.rb +44 -0
  133. data/lib/active_merchant/billing/gateways/paypal_express.rb +264 -0
  134. data/lib/active_merchant/billing/gateways/paypal_express_common.rb +30 -0
  135. data/lib/active_merchant/billing/gateways/payscout.rb +162 -0
  136. data/lib/active_merchant/billing/gateways/paystation.rb +199 -0
  137. data/lib/active_merchant/billing/gateways/payway.rb +207 -0
  138. data/lib/active_merchant/billing/gateways/pin.rb +197 -0
  139. data/lib/active_merchant/billing/gateways/plugnpay.rb +283 -0
  140. data/lib/active_merchant/billing/gateways/psigate.rb +216 -0
  141. data/lib/active_merchant/billing/gateways/psl_card.rb +303 -0
  142. data/lib/active_merchant/billing/gateways/qbms.rb +292 -0
  143. data/lib/active_merchant/billing/gateways/quantum.rb +276 -0
  144. data/lib/active_merchant/billing/gateways/quickpay.rb +367 -0
  145. data/lib/active_merchant/billing/gateways/realex.rb +298 -0
  146. data/lib/active_merchant/billing/gateways/redsys.rb +391 -0
  147. data/lib/active_merchant/billing/gateways/sage.rb +175 -0
  148. data/lib/active_merchant/billing/gateways/sage/sage_bankcard.rb +87 -0
  149. data/lib/active_merchant/billing/gateways/sage/sage_core.rb +114 -0
  150. data/lib/active_merchant/billing/gateways/sage/sage_vault.rb +149 -0
  151. data/lib/active_merchant/billing/gateways/sage/sage_virtual_check.rb +102 -0
  152. data/lib/active_merchant/billing/gateways/sage_pay.rb +398 -0
  153. data/lib/active_merchant/billing/gateways/sallie_mae.rb +143 -0
  154. data/lib/active_merchant/billing/gateways/secure_net.rb +252 -0
  155. data/lib/active_merchant/billing/gateways/secure_pay.rb +201 -0
  156. data/lib/active_merchant/billing/gateways/secure_pay_au.rb +281 -0
  157. data/lib/active_merchant/billing/gateways/secure_pay_tech.rb +105 -0
  158. data/lib/active_merchant/billing/gateways/skip_jack.rb +452 -0
  159. data/lib/active_merchant/billing/gateways/smart_ps.rb +283 -0
  160. data/lib/active_merchant/billing/gateways/so_easy_pay.rb +194 -0
  161. data/lib/active_merchant/billing/gateways/spreedly_core.rb +247 -0
  162. data/lib/active_merchant/billing/gateways/stripe.rb +411 -0
  163. data/lib/active_merchant/billing/gateways/swipe_checkout.rb +157 -0
  164. data/lib/active_merchant/billing/gateways/tns.rb +227 -0
  165. data/lib/active_merchant/billing/gateways/trans_first.rb +126 -0
  166. data/lib/active_merchant/billing/gateways/transax.rb +23 -0
  167. data/lib/active_merchant/billing/gateways/transnational.rb +10 -0
  168. data/lib/active_merchant/billing/gateways/trust_commerce.rb +416 -0
  169. data/lib/active_merchant/billing/gateways/usa_epay.rb +25 -0
  170. data/lib/active_merchant/billing/gateways/usa_epay_advanced.rb +1516 -0
  171. data/lib/active_merchant/billing/gateways/usa_epay_transaction.rb +254 -0
  172. data/lib/active_merchant/billing/gateways/verifi.rb +225 -0
  173. data/lib/active_merchant/billing/gateways/viaklix.rb +183 -0
  174. data/lib/active_merchant/billing/gateways/vindicia.rb +385 -0
  175. data/lib/active_merchant/billing/gateways/webpay.rb +97 -0
  176. data/lib/active_merchant/billing/gateways/wepay.rb +189 -0
  177. data/lib/active_merchant/billing/gateways/wirecard.rb +421 -0
  178. data/lib/active_merchant/billing/gateways/worldpay.rb +331 -0
  179. data/lib/active_merchant/billing/gateways/worldpay_us.rb +181 -0
  180. data/lib/active_merchant/billing/model.rb +30 -0
  181. data/lib/active_merchant/billing/payment_token.rb +21 -0
  182. data/lib/active_merchant/billing/rails.rb +3 -0
  183. data/lib/active_merchant/billing/response.rb +91 -0
  184. data/lib/active_merchant/country.rb +332 -0
  185. data/lib/active_merchant/empty.rb +20 -0
  186. data/lib/active_merchant/errors.rb +29 -0
  187. data/lib/active_merchant/offsite_payments_shim.rb +19 -0
  188. data/lib/active_merchant/version.rb +3 -0
  189. data/lib/activemerchant.rb +1 -0
  190. data/lib/support/gateway_support.rb +71 -0
  191. data/lib/support/outbound_hosts.rb +25 -0
  192. data/lib/support/ssl_verify.rb +93 -0
  193. metadata +400 -0
@@ -0,0 +1,390 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ # PayJunction Gateway
4
+ #
5
+ # This gateway accepts the following arguments:
6
+ # :login => your PayJunction username
7
+ # :password => your PayJunction pass
8
+ #
9
+ # Example use:
10
+ #
11
+ # gateway = ActiveMerchant::Billing::Base.gateway(:pay_junction).new(
12
+ # :login => "my_account",
13
+ # :password => "my_pass"
14
+ # )
15
+ #
16
+ # # set up credit card obj as in main ActiveMerchant example
17
+ # creditcard = ActiveMerchant::Billing::CreditCard.new(
18
+ # :type => 'visa',
19
+ # :number => '4242424242424242',
20
+ # :month => 8,
21
+ # :year => 2009,
22
+ # :first_name => 'Bob',
23
+ # :last_name => 'Bobsen'
24
+ # )
25
+ #
26
+ # # optionally specify address if using AVS
27
+ # address = { :address1 => '101 Test Ave', :city => 'Test', :state => 'TS',
28
+ # :zip => '10101', :country => 'US' }
29
+ #
30
+ # # run request
31
+ # response = gateway.purchase(1000, creditcard, :address => address) # charge 10 dollars
32
+ #
33
+ # 1) Check whether the transaction was successful
34
+ #
35
+ # response.success?
36
+ #
37
+ # 2) Retrieve the message returned by PayJunction
38
+ #
39
+ # response.message
40
+ #
41
+ # 3) Retrieve the unique transaction ID returned by PayJunction
42
+ #
43
+ # response.authorization
44
+ #
45
+ # This gateway supports "instant" transactions. These transactions allow you
46
+ # to execute an operation on a previously run card without card information
47
+ # provided you have the transaction id from a previous transaction with the
48
+ # same card. All functions that take a credit card object for this gateway
49
+ # can take a transaction id string instead.
50
+ #
51
+ # Test Transactions
52
+ #
53
+ # See the source for initialize() for test account information. Note that
54
+ # PayJunction does not allow test transactions on your account, so if the
55
+ # gateway is running in :test mode your transaction will be run against
56
+ # PayJunction's global test account and will not show up in your account.
57
+ #
58
+ # Transactions ran on this account go through a test processor, so there is no
59
+ # need to void or otherwise cancel transactions. However, for further safety,
60
+ # please use the special card numbers 4433221111223344 or 4444333322221111 and
61
+ # keep transaction amounts below $4.00 when testing.
62
+ #
63
+ # Also note, transactions ran for an amount between $0.00 and $1.99 will likely
64
+ # result in denial. To demonstrate approvals, use amounts between $2.00 and $4.00.
65
+ #
66
+ # Test transactions can be checked by logging into
67
+ # PayJunction Web Login with username 'pj-cm-01' and password 'pj-cm-01p'
68
+ #
69
+ # Usage Details
70
+ #
71
+ # Below is a map of values accepted by PayJunction and how you should submit
72
+ # each to ActiveMerchant
73
+ #
74
+ # PayJunction Field ActiveMerchant Use
75
+ #
76
+ # dc_logon provide as :login value to gateway instantiation
77
+ # dc_password provide as :password value to gateway instantiation
78
+ #
79
+ # dc_name will be retrieved from credit_card.name
80
+ # dc_first_name :first_name on CreditCard object instantiation
81
+ # dc_last_name :last_name on CreditCard object instantiation
82
+ # dc_number :number on CreditCard object instantiation
83
+ # dc_expiration_month :month on CreditCard object instantiation
84
+ # dc_expiration_year :year on CreditCard object instantiation
85
+ # dc_verification_number :verification_value on CC object instantiation
86
+ #
87
+ # dc_transaction_amount include as argument to method for your transaction type
88
+ # dc_transaction_type do nothing, set by your transaction type
89
+ # dc_version do nothing, always "1.2"
90
+ #
91
+ # dc_transaction_id submit as a string in place of CreditCard obj for
92
+ # "instant" transactions.
93
+ #
94
+ # dc_invoice :order_id in options for transaction method
95
+ # dc_notes :description in options for transaction method
96
+ #
97
+ # See example use above for address AVS fields
98
+ # See #recurring for periodic transaction fields
99
+ class PayJunctionGateway < Gateway
100
+ API_VERSION = '1.2'
101
+
102
+ class_attribute :test_url, :live_url
103
+
104
+ self.test_url = "https://www.payjunctionlabs.com/quick_link"
105
+ self.live_url = "https://payjunction.com/quick_link"
106
+
107
+ TEST_LOGIN = 'pj-ql-01'
108
+ TEST_PASSWORD = 'pj-ql-01p'
109
+
110
+ SUCCESS_CODES = ["00", "85"]
111
+ SUCCESS_MESSAGE = 'The transaction was approved.'
112
+
113
+ FAILURE_MESSAGE = 'The transaction was declined.'
114
+
115
+ DECLINE_CODES = {
116
+ "AE" => 'Address verification failed because address did not match.',
117
+ 'ZE' => 'Address verification failed because zip did not match.',
118
+ 'XE' => 'Address verification failed because zip and address did not match.',
119
+ 'YE' => 'Address verification failed because zip and address did not match.',
120
+ 'OE' => 'Address verification failed because address or zip did not match.',
121
+ 'UE' => 'Address verification failed because cardholder address unavailable.',
122
+ 'RE' => 'Address verification failed because address verification system is not working.',
123
+ 'SE' => 'Address verification failed because address verification system is unavailable.',
124
+ 'EE' => 'Address verification failed because transaction is not a mail or phone order.',
125
+ 'GE' => 'Address verification failed because international support is unavailable.',
126
+ 'CE' => 'Declined because CVV2/CVC2 code did not match.',
127
+ '04' => 'Declined. Pick up card.',
128
+ '07' => 'Declined. Pick up card (Special Condition).',
129
+ '41' => 'Declined. Pick up card (Lost).',
130
+ '43' => 'Declined. Pick up card (Stolen).',
131
+ '13' => 'Declined because of the amount is invalid.',
132
+ '14' => 'Declined because the card number is invalid.',
133
+ '80' => 'Declined because of an invalid date.',
134
+ '05' => 'Declined. Do not honor.',
135
+ '51' => 'Declined because of insufficient funds.',
136
+ 'N4' => 'Declined because the amount exceeds issuer withdrawal limit.',
137
+ '61' => 'Declined because the amount exceeds withdrawal limit.',
138
+ '62' => 'Declined because of an invalid service code (restricted).',
139
+ '65' => 'Declined because the card activity limit exceeded.',
140
+ '93' => 'Declined because there a violation (the transaction could not be completed).',
141
+ '06' => 'Declined because address verification failed.',
142
+ '54' => 'Declined because the card has expired.',
143
+ '15' => 'Declined because there is no such issuer.',
144
+ '96' => 'Declined because of a system error.',
145
+ 'N7' => 'Declined because of a CVV2/CVC2 mismatch.',
146
+ 'M4' => 'Declined.',
147
+ "FE" => "There was a format error with your Trinity Gateway Service (API) request.",
148
+ "LE" => "Could not log you in (problem with dc_logon and/or dc_password).",
149
+ 'NL' => 'Aborted because of a system error, please try again later. ',
150
+ 'AB' => 'Aborted because of an upstream system error, please try again later.'
151
+ }
152
+
153
+ self.supported_cardtypes = [:visa, :master, :american_express, :discover]
154
+ self.supported_countries = ['US']
155
+ self.homepage_url = 'http://www.payjunction.com/'
156
+ self.display_name = 'PayJunction'
157
+
158
+ def initialize(options = {})
159
+ requires!(options, :login, :password)
160
+ super
161
+ end
162
+
163
+ # The first half of the preauth(authorize)/postauth(capture) model.
164
+ # Checks to make sure funds are available for a transaction, and returns a
165
+ # transaction_id that can be used later to postauthorize (capture) the funds.
166
+ def authorize(money, payment_source, options = {})
167
+ parameters = {
168
+ :transaction_amount => amount(money),
169
+ }
170
+
171
+ add_payment_source(parameters, payment_source)
172
+ add_address(parameters, options)
173
+ add_optional_fields(parameters, options)
174
+ commit('AUTHORIZATION', parameters)
175
+ end
176
+
177
+ # A simple sale, capturing funds immediately.
178
+ # Execute authorization and capture in a single step.
179
+ def purchase(money, payment_source, options = {})
180
+ parameters = {
181
+ :transaction_amount => amount(money),
182
+ }
183
+
184
+ add_payment_source(parameters, payment_source)
185
+ add_address(parameters, options)
186
+ add_optional_fields(parameters, options)
187
+ commit('AUTHORIZATION_CAPTURE', parameters)
188
+ end
189
+
190
+ # The second half of the preauth(authorize)/postauth(capture) model.
191
+ # Retrieve funds that have been previously authorized with _authorization_
192
+ def capture(money, authorization, options = {})
193
+ parameters = {
194
+ :transaction_id => authorization,
195
+ :posture => 'capture'
196
+ }
197
+
198
+ add_optional_fields(parameters, options)
199
+ commit('update', parameters)
200
+ end
201
+
202
+ # Return money to a card that was previously billed.
203
+ # _authorization_ should be the transaction id of the transaction we are returning.
204
+ def refund(money, authorization, options = {})
205
+ parameters = {
206
+ :transaction_amount => amount(money),
207
+ :transaction_id => authorization
208
+ }
209
+
210
+ commit('CREDIT', parameters)
211
+ end
212
+
213
+ def credit(money, authorization, options = {})
214
+ ActiveMerchant.deprecated CREDIT_DEPRECATION_MESSAGE
215
+ refund(money, authorization, options)
216
+ end
217
+
218
+ # Cancel a transaction that has been charged but has not yet made it
219
+ # through the batch process.
220
+ def void(authorization, options = {})
221
+ parameters = {
222
+ :transaction_id => authorization,
223
+ :posture => 'void'
224
+ }
225
+
226
+ add_optional_fields(parameters, options)
227
+ commit('update', parameters)
228
+ end
229
+
230
+ # Set up a sale that will be made on a regular basis for the same amount
231
+ # (ex. $20 a month for 12 months)
232
+ #
233
+ # The parameter :periodicity should be specified as either :monthly, :weekly, or :daily
234
+ # The parameter :payments should be the number of payments to be made
235
+ #
236
+ # gateway.recurring('2000', creditcard, :periodicity => :monthly, :payments => 12)
237
+ #
238
+ # The optional parameter :starting_at takes a date or time argument or a string in
239
+ # YYYYMMDD format and can be used to specify when the first charge will be made.
240
+ # If omitted the first charge will be immediate.
241
+ def recurring(money, payment_source, options = {})
242
+ ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE
243
+
244
+ requires!(options, [:periodicity, :monthly, :weekly, :daily], :payments)
245
+
246
+ periodic_type = case options[:periodicity]
247
+ when :monthly
248
+ 'month'
249
+ when :weekly
250
+ 'week'
251
+ when :daily
252
+ 'day'
253
+ end
254
+
255
+ if options[:starting_at].nil?
256
+ start_date = Time.now.strftime('%Y-%m-%d')
257
+ elsif options[:starting_at].is_a?(String)
258
+ sa = options[:starting_at]
259
+ start_date = "#{sa[0..3]}-#{sa[4..5]}-#{sa[6..7]}"
260
+ else
261
+ start_date = options[:starting_at].strftime('%Y-%m-%d')
262
+ end
263
+
264
+ parameters = {
265
+ :transaction_amount => amount(money),
266
+ :schedule_periodic_type => periodic_type,
267
+ :schedule_create => 'true',
268
+ :schedule_limit => options[:payments].to_i > 1 ? options[:payments] : 1,
269
+ :schedule_periodic_number => 1,
270
+ :schedule_start => start_date
271
+ }
272
+
273
+ add_payment_source(parameters, payment_source)
274
+ add_optional_fields(parameters, options)
275
+ add_address(parameters, options)
276
+ commit('AUTHORIZATION_CAPTURE', parameters)
277
+ end
278
+
279
+ def test?
280
+ (test_login? || super)
281
+ end
282
+
283
+ private
284
+
285
+ def test_login?
286
+ @options[:login] == TEST_LOGIN && @options[:password] == TEST_PASSWORD
287
+ end
288
+
289
+ # add fields depending on payment source selected (cc or transaction id)
290
+ def add_payment_source(params, source)
291
+ if source.is_a?(String)
292
+ add_billing_id(params, source)
293
+ else
294
+ add_creditcard(params, source)
295
+ end
296
+ end
297
+
298
+ # add fields for credit card
299
+ def add_creditcard(params, creditcard)
300
+ if creditcard.respond_to?(:track_data) && creditcard.track_data.present?
301
+ params[:track] = creditcard.track_data
302
+ else
303
+ params[:name] = creditcard.name
304
+ params[:number] = creditcard.number
305
+ params[:expiration_month] = creditcard.month
306
+ params[:expiration_year] = creditcard.year
307
+ params[:verification_number] = creditcard.verification_value if creditcard.verification_value?
308
+ end
309
+ end
310
+
311
+ # add field for "instant" transaction, using previous transaction id
312
+ def add_billing_id(params, billingid)
313
+ params[:transaction_id] = billingid
314
+ end
315
+
316
+ # add address fields if present
317
+ def add_address(params, options)
318
+ address = options[:billing_address] || options[:address]
319
+
320
+ if address
321
+ params[:address] = address[:address1] unless address[:address1].blank?
322
+ params[:city] = address[:city] unless address[:city].blank?
323
+ params[:state] = address[:state] unless address[:state].blank?
324
+ params[:zipcode] = address[:zip] unless address[:zip].blank?
325
+ params[:country] = address[:country] unless address[:country].blank?
326
+ end
327
+ end
328
+
329
+ def add_optional_fields(params, options)
330
+ params[:notes] = options[:description] unless options[:description].blank?
331
+ params[:invoice] = options[:order_id].to_s.gsub(/[^-\/\w.,']/, '') unless options[:order_id].blank?
332
+ end
333
+
334
+ def commit(action, parameters)
335
+ url = test? ? self.test_url : self.live_url
336
+
337
+ response = parse( ssl_post(url, post_data(action, parameters)) )
338
+
339
+ Response.new(successful?(response), message_from(response), response,
340
+ :test => test?,
341
+ :authorization => response[:transaction_id] || parameters[:transaction_id]
342
+ )
343
+ end
344
+
345
+ def successful?(response)
346
+ SUCCESS_CODES.include?(response[:response_code]) || response[:query_status] == true
347
+ end
348
+
349
+ def message_from(response)
350
+ if successful?(response)
351
+ SUCCESS_MESSAGE
352
+ else
353
+ DECLINE_CODES[response[:response_code]] || FAILURE_MESSAGE
354
+ end
355
+ end
356
+
357
+ def post_data(action, params)
358
+ if test?
359
+ # test requests must use global test account
360
+ params[:logon] = TEST_LOGIN
361
+ params[:password] = TEST_PASSWORD
362
+ else
363
+ params[:logon] = @options[:login]
364
+ params[:password] = @options[:password]
365
+ end
366
+ params[:version] = API_VERSION
367
+ params[:transaction_type] = action
368
+
369
+ params.reject{|k,v| v.blank?}.collect{ |k, v| "dc_#{k.to_s}=#{CGI.escape(v.to_s)}" }.join("&")
370
+ end
371
+
372
+ def parse(body)
373
+ # PayJunction uses the Field Separator ASCII character to separate key/val
374
+ # pairs in the response. The <FS> character's octal value is 034.
375
+ #
376
+ # Sample response:
377
+ #
378
+ # transaction_id=44752<FS>response_code=M4<FS>response_message=Declined (INV TEST CARD).
379
+
380
+ pairs = body.chomp.split("\034")
381
+ response = {}
382
+ pairs.each do |pair|
383
+ key, val = pair.split('=')
384
+ response[key[3..-1].to_sym] = val ? normalize(val) : nil
385
+ end
386
+ response
387
+ end
388
+ end
389
+ end
390
+ end
@@ -0,0 +1,112 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ class PaySecureGateway < Gateway
4
+ self.live_url = self.test_url = 'https://clearance.commsecure.com.au/cgi-bin/PSDirect'
5
+
6
+ self.money_format = :cents
7
+
8
+ # Currently Authorization and Capture is not implemented because
9
+ # capturing requires the original credit card information
10
+ TRANSACTIONS = {
11
+ :purchase => 'PURCHASE',
12
+ :authorization => 'AUTHORISE',
13
+ :capture => 'ADVICE',
14
+ :credit => 'REFUND'
15
+ }
16
+
17
+ SUCCESS = 'Accepted'
18
+ SUCCESS_MESSAGE = 'The transaction was approved'
19
+
20
+ self.supported_countries = ['AU']
21
+ self.homepage_url = 'http://www.commsecure.com.au/paysecure.shtml'
22
+ self.display_name = 'PaySecure'
23
+ self.supported_cardtypes = [:visa, :master, :american_express, :diners_club]
24
+
25
+ def initialize(options = {})
26
+ requires!(options, :login, :password)
27
+ super
28
+ end
29
+
30
+ def purchase(money, credit_card, options = {})
31
+ requires!(options, :order_id)
32
+
33
+ post = {}
34
+ add_amount(post, money)
35
+ add_invoice(post, options)
36
+ add_credit_card(post, credit_card)
37
+
38
+ commit(:purchase, money, post)
39
+ end
40
+
41
+ private
42
+ # Used for capturing, which is currently not supported.
43
+ def add_reference(post, identification)
44
+ auth, trans_id = identification.split(";")
45
+ post[:authnum] = auth
46
+ post[:transid] = trans_id
47
+ end
48
+
49
+ def add_amount(post, money)
50
+ post[:amount] = amount(money)
51
+ end
52
+
53
+ def add_invoice(post, options)
54
+ post[:merchant_transid] = options[:order_id].to_s.slice(0,21)
55
+ post[:memnum] = options[:invoice]
56
+ post[:custnum] = options[:customer]
57
+ post[:clientdata] = options[:description]
58
+ end
59
+
60
+ def add_credit_card(post, credit_card)
61
+ post[:cardnum] = credit_card.number
62
+ post[:cardname] = credit_card.name
63
+ post[:expiry] = expdate(credit_card)
64
+ post[:cvv2] = credit_card.verification_value
65
+ end
66
+
67
+ def commit(action, money, parameters)
68
+ response = parse( ssl_post(self.live_url, post_data(action, parameters)) )
69
+
70
+ Response.new(successful?(response), message_from(response), response,
71
+ :test => test_response?(response),
72
+ :authorization => authorization_from(response)
73
+ )
74
+
75
+ end
76
+
77
+ def successful?(response)
78
+ response[:status] == SUCCESS
79
+ end
80
+
81
+ def authorization_from(response)
82
+ [ response[:authnum], response[:transid] ].compact.join(";")
83
+ end
84
+
85
+ def test_response?(response)
86
+ !!(response[:transid] =~ /SimProxy/)
87
+ end
88
+
89
+ def message_from(response)
90
+ successful?(response) ? SUCCESS_MESSAGE : response[:errorstring]
91
+ end
92
+
93
+ def parse(body)
94
+ response = {}
95
+ body.to_s.each_line do |l|
96
+ key, value = l.split(":", 2)
97
+ response[key.to_s.downcase.to_sym] = value.strip
98
+ end
99
+ response
100
+ end
101
+
102
+ def post_data(action, parameters = {})
103
+ parameters[:request_type] = TRANSACTIONS[action]
104
+ parameters[:merchant_id] = @options[:login]
105
+ parameters[:password] = @options[:password]
106
+
107
+ parameters.reject{|k,v| v.blank?}.collect { |key, value| "#{key.to_s.upcase}=#{CGI.escape(value.to_s)}" }.join("&")
108
+ end
109
+ end
110
+ end
111
+ end
112
+