patmaddox-activemerchant 1.4.2
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG +480 -0
- data/CONTRIBUTORS +126 -0
- data/MIT-LICENSE +20 -0
- data/README +136 -0
- data/Rakefile +153 -0
- data/gem-public_cert.pem +20 -0
- data/init.rb +3 -0
- data/lib/active_merchant.rb +66 -0
- data/lib/active_merchant/billing/avs_result.rb +98 -0
- data/lib/active_merchant/billing/base.rb +57 -0
- data/lib/active_merchant/billing/check.rb +68 -0
- data/lib/active_merchant/billing/credit_card.rb +159 -0
- data/lib/active_merchant/billing/credit_card_formatting.rb +21 -0
- data/lib/active_merchant/billing/credit_card_methods.rb +125 -0
- data/lib/active_merchant/billing/cvv_result.rb +38 -0
- data/lib/active_merchant/billing/expiry_date.rb +34 -0
- data/lib/active_merchant/billing/gateway.rb +158 -0
- data/lib/active_merchant/billing/gateways.rb +18 -0
- data/lib/active_merchant/billing/gateways/authorize_net.rb +657 -0
- data/lib/active_merchant/billing/gateways/authorize_net_cim.rb +743 -0
- data/lib/active_merchant/billing/gateways/beanstream.rb +102 -0
- data/lib/active_merchant/billing/gateways/beanstream/beanstream_core.rb +233 -0
- data/lib/active_merchant/billing/gateways/beanstream_interac.rb +54 -0
- data/lib/active_merchant/billing/gateways/bogus.rb +101 -0
- data/lib/active_merchant/billing/gateways/braintree.rb +17 -0
- data/lib/active_merchant/billing/gateways/card_stream.rb +230 -0
- data/lib/active_merchant/billing/gateways/cyber_source.rb +406 -0
- data/lib/active_merchant/billing/gateways/data_cash.rb +595 -0
- data/lib/active_merchant/billing/gateways/efsnet.rb +229 -0
- data/lib/active_merchant/billing/gateways/elavon.rb +134 -0
- data/lib/active_merchant/billing/gateways/eway.rb +277 -0
- data/lib/active_merchant/billing/gateways/exact.rb +222 -0
- data/lib/active_merchant/billing/gateways/first_pay.rb +172 -0
- data/lib/active_merchant/billing/gateways/instapay.rb +164 -0
- data/lib/active_merchant/billing/gateways/jetpay.rb +270 -0
- data/lib/active_merchant/billing/gateways/linkpoint.rb +449 -0
- data/lib/active_merchant/billing/gateways/merchant_e_solutions.rb +154 -0
- data/lib/active_merchant/billing/gateways/merchant_ware.rb +283 -0
- data/lib/active_merchant/billing/gateways/modern_payments.rb +36 -0
- data/lib/active_merchant/billing/gateways/modern_payments_cim.rb +220 -0
- data/lib/active_merchant/billing/gateways/moneris.rb +205 -0
- data/lib/active_merchant/billing/gateways/net_registry.rb +189 -0
- data/lib/active_merchant/billing/gateways/netbilling.rb +168 -0
- data/lib/active_merchant/billing/gateways/ogone.rb +279 -0
- data/lib/active_merchant/billing/gateways/pay_junction.rb +392 -0
- data/lib/active_merchant/billing/gateways/pay_secure.rb +120 -0
- data/lib/active_merchant/billing/gateways/payflow.rb +236 -0
- data/lib/active_merchant/billing/gateways/payflow/payflow_common_api.rb +207 -0
- data/lib/active_merchant/billing/gateways/payflow/payflow_express_response.rb +39 -0
- data/lib/active_merchant/billing/gateways/payflow/payflow_response.rb +13 -0
- data/lib/active_merchant/billing/gateways/payflow_express.rb +138 -0
- data/lib/active_merchant/billing/gateways/payflow_express_uk.rb +15 -0
- data/lib/active_merchant/billing/gateways/payflow_uk.rb +21 -0
- data/lib/active_merchant/billing/gateways/payment_express.rb +230 -0
- data/lib/active_merchant/billing/gateways/paypal.rb +121 -0
- data/lib/active_merchant/billing/gateways/paypal/paypal_common_api.rb +326 -0
- data/lib/active_merchant/billing/gateways/paypal/paypal_express_response.rb +38 -0
- data/lib/active_merchant/billing/gateways/paypal_ca.rb +13 -0
- data/lib/active_merchant/billing/gateways/paypal_express.rb +130 -0
- data/lib/active_merchant/billing/gateways/paypal_express_common.rb +20 -0
- data/lib/active_merchant/billing/gateways/plugnpay.rb +292 -0
- data/lib/active_merchant/billing/gateways/psigate.rb +214 -0
- data/lib/active_merchant/billing/gateways/psl_card.rb +306 -0
- data/lib/active_merchant/billing/gateways/quickpay.rb +213 -0
- data/lib/active_merchant/billing/gateways/realex.rb +200 -0
- data/lib/active_merchant/billing/gateways/sage.rb +146 -0
- data/lib/active_merchant/billing/gateways/sage/sage_bankcard.rb +88 -0
- data/lib/active_merchant/billing/gateways/sage/sage_core.rb +116 -0
- data/lib/active_merchant/billing/gateways/sage/sage_virtual_check.rb +97 -0
- data/lib/active_merchant/billing/gateways/sage_pay.rb +308 -0
- data/lib/active_merchant/billing/gateways/sallie_mae.rb +144 -0
- data/lib/active_merchant/billing/gateways/secure_pay.rb +31 -0
- data/lib/active_merchant/billing/gateways/secure_pay_au.rb +157 -0
- data/lib/active_merchant/billing/gateways/secure_pay_tech.rb +113 -0
- data/lib/active_merchant/billing/gateways/skip_jack.rb +452 -0
- data/lib/active_merchant/billing/gateways/smart_ps.rb +265 -0
- data/lib/active_merchant/billing/gateways/trans_first.rb +127 -0
- data/lib/active_merchant/billing/gateways/transax.rb +26 -0
- data/lib/active_merchant/billing/gateways/trust_commerce.rb +418 -0
- data/lib/active_merchant/billing/gateways/usa_epay.rb +194 -0
- data/lib/active_merchant/billing/gateways/verifi.rb +228 -0
- data/lib/active_merchant/billing/gateways/viaklix.rb +189 -0
- data/lib/active_merchant/billing/gateways/wirecard.rb +318 -0
- data/lib/active_merchant/billing/integrations.rb +29 -0
- data/lib/active_merchant/billing/integrations/action_view_helper.rb +79 -0
- data/lib/active_merchant/billing/integrations/bogus.rb +23 -0
- data/lib/active_merchant/billing/integrations/bogus/helper.rb +17 -0
- data/lib/active_merchant/billing/integrations/bogus/notification.rb +11 -0
- data/lib/active_merchant/billing/integrations/bogus/return.rb +10 -0
- data/lib/active_merchant/billing/integrations/chronopay.rb +23 -0
- data/lib/active_merchant/billing/integrations/chronopay/helper.rb +81 -0
- data/lib/active_merchant/billing/integrations/chronopay/notification.rb +156 -0
- data/lib/active_merchant/billing/integrations/chronopay/return.rb +10 -0
- data/lib/active_merchant/billing/integrations/gestpay.rb +25 -0
- data/lib/active_merchant/billing/integrations/gestpay/common.rb +42 -0
- data/lib/active_merchant/billing/integrations/gestpay/helper.rb +70 -0
- data/lib/active_merchant/billing/integrations/gestpay/notification.rb +83 -0
- data/lib/active_merchant/billing/integrations/gestpay/return.rb +10 -0
- data/lib/active_merchant/billing/integrations/helper.rb +93 -0
- data/lib/active_merchant/billing/integrations/hi_trust.rb +27 -0
- data/lib/active_merchant/billing/integrations/hi_trust/helper.rb +58 -0
- data/lib/active_merchant/billing/integrations/hi_trust/notification.rb +59 -0
- data/lib/active_merchant/billing/integrations/hi_trust/return.rb +67 -0
- data/lib/active_merchant/billing/integrations/nochex.rb +88 -0
- data/lib/active_merchant/billing/integrations/nochex/helper.rb +68 -0
- data/lib/active_merchant/billing/integrations/nochex/notification.rb +94 -0
- data/lib/active_merchant/billing/integrations/nochex/return.rb +10 -0
- data/lib/active_merchant/billing/integrations/notification.rb +62 -0
- data/lib/active_merchant/billing/integrations/paypal.rb +39 -0
- data/lib/active_merchant/billing/integrations/paypal/helper.rb +119 -0
- data/lib/active_merchant/billing/integrations/paypal/notification.rb +154 -0
- data/lib/active_merchant/billing/integrations/paypal/return.rb +10 -0
- data/lib/active_merchant/billing/integrations/quickpay.rb +17 -0
- data/lib/active_merchant/billing/integrations/quickpay/helper.rb +72 -0
- data/lib/active_merchant/billing/integrations/quickpay/notification.rb +74 -0
- data/lib/active_merchant/billing/integrations/return.rb +35 -0
- data/lib/active_merchant/billing/integrations/two_checkout.rb +23 -0
- data/lib/active_merchant/billing/integrations/two_checkout/helper.rb +59 -0
- data/lib/active_merchant/billing/integrations/two_checkout/notification.rb +114 -0
- data/lib/active_merchant/billing/integrations/two_checkout/return.rb +17 -0
- data/lib/active_merchant/billing/response.rb +32 -0
- data/lib/active_merchant/lib/connection.rb +170 -0
- data/lib/active_merchant/lib/country.rb +319 -0
- data/lib/active_merchant/lib/error.rb +4 -0
- data/lib/active_merchant/lib/post_data.rb +22 -0
- data/lib/active_merchant/lib/posts_data.rb +47 -0
- data/lib/active_merchant/lib/requires_parameters.rb +16 -0
- data/lib/active_merchant/lib/utils.rb +18 -0
- data/lib/active_merchant/lib/validateable.rb +76 -0
- data/lib/certs/cacert.pem +7815 -0
- data/lib/support/gateway_support.rb +58 -0
- data/script/destroy +14 -0
- data/script/generate +14 -0
- data/test/fixtures.yml +355 -0
- data/test/remote/gateways/remote_authorize_net_cim_test.rb +460 -0
- data/test/remote/gateways/remote_authorize_net_test.rb +145 -0
- data/test/remote/gateways/remote_beanstream_interac_test.rb +53 -0
- data/test/remote/gateways/remote_beanstream_test.rb +150 -0
- data/test/remote/gateways/remote_braintree_test.rb +154 -0
- data/test/remote/gateways/remote_card_stream_test.rb +148 -0
- data/test/remote/gateways/remote_cyber_source_test.rb +144 -0
- data/test/remote/gateways/remote_data_cash_test.rb +357 -0
- data/test/remote/gateways/remote_efsnet_test.rb +81 -0
- data/test/remote/gateways/remote_elavon_test.rb +66 -0
- data/test/remote/gateways/remote_eway_test.rb +74 -0
- data/test/remote/gateways/remote_exact_test.rb +60 -0
- data/test/remote/gateways/remote_first_pay_test.rb +87 -0
- data/test/remote/gateways/remote_instapay_test.rb +61 -0
- data/test/remote/gateways/remote_jetpay_test.rb +103 -0
- data/test/remote/gateways/remote_linkpoint_test.rb +121 -0
- data/test/remote/gateways/remote_merchant_e_solutions_test.rb +173 -0
- data/test/remote/gateways/remote_merchant_ware_test.rb +113 -0
- data/test/remote/gateways/remote_modern_payments_cim_test.rb +58 -0
- data/test/remote/gateways/remote_modern_payments_test.rb +57 -0
- data/test/remote/gateways/remote_moneris_test.rb +82 -0
- data/test/remote/gateways/remote_net_registry_test.rb +85 -0
- data/test/remote/gateways/remote_netbilling_test.rb +70 -0
- data/test/remote/gateways/remote_ogone_test.rb +115 -0
- data/test/remote/gateways/remote_pay_junction_test.rb +143 -0
- data/test/remote/gateways/remote_pay_secure_test.rb +39 -0
- data/test/remote/gateways/remote_payflow_express_test.rb +50 -0
- data/test/remote/gateways/remote_payflow_test.rb +237 -0
- data/test/remote/gateways/remote_payflow_uk_test.rb +173 -0
- data/test/remote/gateways/remote_payment_express_test.rb +136 -0
- data/test/remote/gateways/remote_paypal_express_test.rb +49 -0
- data/test/remote/gateways/remote_paypal_test.rb +191 -0
- data/test/remote/gateways/remote_plugnpay_test.rb +72 -0
- data/test/remote/gateways/remote_psigate_test.rb +50 -0
- data/test/remote/gateways/remote_psl_card_test.rb +125 -0
- data/test/remote/gateways/remote_quickpay_test.rb +190 -0
- data/test/remote/gateways/remote_realex_test.rb +224 -0
- data/test/remote/gateways/remote_sage_bankcard_test.rb +109 -0
- data/test/remote/gateways/remote_sage_pay_test.rb +219 -0
- data/test/remote/gateways/remote_sage_test.rb +87 -0
- data/test/remote/gateways/remote_sage_virtual_check_test.rb +62 -0
- data/test/remote/gateways/remote_sallie_mae_test.rb +51 -0
- data/test/remote/gateways/remote_secure_pay_au_test.rb +40 -0
- data/test/remote/gateways/remote_secure_pay_tech_test.rb +37 -0
- data/test/remote/gateways/remote_secure_pay_test.rb +28 -0
- data/test/remote/gateways/remote_skipjack_test.rb +105 -0
- data/test/remote/gateways/remote_trans_first_test.rb +34 -0
- data/test/remote/gateways/remote_transax_test.rb +112 -0
- data/test/remote/gateways/remote_trust_commerce_test.rb +152 -0
- data/test/remote/gateways/remote_usa_epay_test.rb +46 -0
- data/test/remote/gateways/remote_verifi_test.rb +107 -0
- data/test/remote/gateways/remote_viaklix_test.rb +43 -0
- data/test/remote/gateways/remote_wirecard_test.rb +111 -0
- data/test/remote/integrations/remote_gestpay_integration_test.rb +37 -0
- data/test/remote/integrations/remote_paypal_integration_test.rb +26 -0
- data/test/test_helper.rb +182 -0
- data/test/unit/avs_result_test.rb +59 -0
- data/test/unit/base_test.rb +55 -0
- data/test/unit/check_test.rb +88 -0
- data/test/unit/connection_test.rb +129 -0
- data/test/unit/country_code_test.rb +33 -0
- data/test/unit/country_test.rb +64 -0
- data/test/unit/credit_card_formatting_test.rb +19 -0
- data/test/unit/credit_card_methods_test.rb +179 -0
- data/test/unit/credit_card_test.rb +318 -0
- data/test/unit/cvv_result_test.rb +33 -0
- data/test/unit/expiry_date_test.rb +32 -0
- data/test/unit/gateways/authorize_net_cim_test.rb +676 -0
- data/test/unit/gateways/authorize_net_test.rb +290 -0
- data/test/unit/gateways/beanstream_interac_test.rb +51 -0
- data/test/unit/gateways/beanstream_test.rb +108 -0
- data/test/unit/gateways/bogus_test.rb +46 -0
- data/test/unit/gateways/braintree_test.rb +126 -0
- data/test/unit/gateways/card_stream_test.rb +90 -0
- data/test/unit/gateways/cyber_source_test.rb +188 -0
- data/test/unit/gateways/data_cash_test.rb +133 -0
- data/test/unit/gateways/efsnet_test.rb +123 -0
- data/test/unit/gateways/elavon_test.rb +139 -0
- data/test/unit/gateways/eway_test.rb +118 -0
- data/test/unit/gateways/exact_test.rb +156 -0
- data/test/unit/gateways/first_pay_test.rb +125 -0
- data/test/unit/gateways/gateway_test.rb +48 -0
- data/test/unit/gateways/instapay_test.rb +102 -0
- data/test/unit/gateways/jetpay_test.rb +185 -0
- data/test/unit/gateways/linkpoint_test.rb +197 -0
- data/test/unit/gateways/merchant_e_solutions_test.rb +169 -0
- data/test/unit/gateways/merchant_ware_test.rb +188 -0
- data/test/unit/gateways/modern_payments_cim_test.rb +162 -0
- data/test/unit/gateways/moneris_test.rb +158 -0
- data/test/unit/gateways/net_registry_test.rb +416 -0
- data/test/unit/gateways/netbilling_test.rb +54 -0
- data/test/unit/gateways/ogone_test.rb +319 -0
- data/test/unit/gateways/pay_junction_test.rb +123 -0
- data/test/unit/gateways/pay_secure_test.rb +71 -0
- data/test/unit/gateways/payflow_express_test.rb +173 -0
- data/test/unit/gateways/payflow_express_uk_test.rb +86 -0
- data/test/unit/gateways/payflow_test.rb +305 -0
- data/test/unit/gateways/payflow_uk_test.rb +30 -0
- data/test/unit/gateways/payment_express_test.rb +195 -0
- data/test/unit/gateways/paypal_express_test.rb +382 -0
- data/test/unit/gateways/paypal_test.rb +569 -0
- data/test/unit/gateways/plugnpay_test.rb +86 -0
- data/test/unit/gateways/psigate_test.rb +169 -0
- data/test/unit/gateways/psl_card_test.rb +64 -0
- data/test/unit/gateways/quickpay_test.rb +112 -0
- data/test/unit/gateways/realex_test.rb +151 -0
- data/test/unit/gateways/sage_bankcard_test.rb +196 -0
- data/test/unit/gateways/sage_pay_test.rb +139 -0
- data/test/unit/gateways/sage_virtual_check_test.rb +71 -0
- data/test/unit/gateways/sallie_mae_test.rb +53 -0
- data/test/unit/gateways/secure_pay_au_test.rb +207 -0
- data/test/unit/gateways/secure_pay_tech_test.rb +44 -0
- data/test/unit/gateways/secure_pay_test.rb +87 -0
- data/test/unit/gateways/skip_jack_test.rb +213 -0
- data/test/unit/gateways/trans_first_test.rb +112 -0
- data/test/unit/gateways/trust_commerce_test.rb +90 -0
- data/test/unit/gateways/usa_epay_test.rb +128 -0
- data/test/unit/gateways/verifi_test.rb +96 -0
- data/test/unit/gateways/viaklix_test.rb +78 -0
- data/test/unit/gateways/wirecard_test.rb +250 -0
- data/test/unit/generators/test_gateway_generator.rb +46 -0
- data/test/unit/generators/test_generator_helper.rb +20 -0
- data/test/unit/generators/test_integration_generator.rb +53 -0
- data/test/unit/integrations/action_view_helper_test.rb +50 -0
- data/test/unit/integrations/bogus_module_test.rb +20 -0
- data/test/unit/integrations/chronopay_module_test.rb +13 -0
- data/test/unit/integrations/gestpay_module_test.rb +14 -0
- data/test/unit/integrations/helpers/bogus_helper_test.rb +28 -0
- data/test/unit/integrations/helpers/chronopay_helper_test.rb +67 -0
- data/test/unit/integrations/helpers/gestpay_helper_test.rb +100 -0
- data/test/unit/integrations/helpers/hi_trust_helper_test.rb +16 -0
- data/test/unit/integrations/helpers/nochex_helper_test.rb +53 -0
- data/test/unit/integrations/helpers/paypal_helper_test.rb +171 -0
- data/test/unit/integrations/helpers/quickpay_helper_test.rb +40 -0
- data/test/unit/integrations/helpers/two_checkout_helper_test.rb +92 -0
- data/test/unit/integrations/hi_trust_module_test.rb +13 -0
- data/test/unit/integrations/nochex_module_test.rb +13 -0
- data/test/unit/integrations/notifications/chronopay_notification_test.rb +66 -0
- data/test/unit/integrations/notifications/gestpay_notification_test.rb +60 -0
- data/test/unit/integrations/notifications/hi_trust_notification_test.rb +59 -0
- data/test/unit/integrations/notifications/nochex_notification_test.rb +51 -0
- data/test/unit/integrations/notifications/notification_test.rb +54 -0
- data/test/unit/integrations/notifications/paypal_notification_test.rb +85 -0
- data/test/unit/integrations/notifications/quickpay_notification_test.rb +69 -0
- data/test/unit/integrations/notifications/two_checkout_notification_test.rb +55 -0
- data/test/unit/integrations/paypal_module_test.rb +28 -0
- data/test/unit/integrations/quickpay_module_test.rb +9 -0
- data/test/unit/integrations/returns/chronopay_return_test.rb +11 -0
- data/test/unit/integrations/returns/gestpay_return_test.rb +10 -0
- data/test/unit/integrations/returns/hi_trust_return_test.rb +24 -0
- data/test/unit/integrations/returns/nochex_return_test.rb +10 -0
- data/test/unit/integrations/returns/paypal_return_test.rb +10 -0
- data/test/unit/integrations/returns/return_test.rb +11 -0
- data/test/unit/integrations/returns/two_checkout_return_test.rb +24 -0
- data/test/unit/integrations/two_checkout_module_test.rb +13 -0
- data/test/unit/post_data_test.rb +55 -0
- data/test/unit/posts_data_test.rb +48 -0
- data/test/unit/response_test.rb +28 -0
- data/test/unit/utils_test.rb +7 -0
- data/test/unit/validateable_test.rb +60 -0
- metadata +367 -0
@@ -0,0 +1,265 @@
|
|
1
|
+
require File.join(File.dirname(__FILE__), '..', 'check.rb')
|
2
|
+
|
3
|
+
module ActiveMerchant #:nodoc:
|
4
|
+
module Billing #:nodoc:
|
5
|
+
class SmartPs < Gateway #:nodoc:
|
6
|
+
|
7
|
+
##
|
8
|
+
# This is the base gateway for processors who use the smartPS processing system
|
9
|
+
|
10
|
+
def initialize(options = {})
|
11
|
+
requires!(options, :login, :password)
|
12
|
+
@options = options
|
13
|
+
super
|
14
|
+
end
|
15
|
+
|
16
|
+
# Pass :store => true in the options to store the
|
17
|
+
# payment info at the gateway and get a generated
|
18
|
+
# customer_vault_id in the response.
|
19
|
+
# Pass :store => some_number_or_string to specify the
|
20
|
+
# customer_vault_id the gateway should use (make sure it's
|
21
|
+
# unique).
|
22
|
+
def authorize(money, creditcard, options = {})
|
23
|
+
post = {}
|
24
|
+
add_invoice(post, options)
|
25
|
+
add_payment_source(post, creditcard,options)
|
26
|
+
add_address(post, options[:billing_address] || options[:address])
|
27
|
+
add_address(post, options[:shipping_address], "shipping")
|
28
|
+
add_customer_data(post, options)
|
29
|
+
add_currency(post, money, options)
|
30
|
+
add_processor(post, options)
|
31
|
+
commit('auth', money, post)
|
32
|
+
end
|
33
|
+
|
34
|
+
def purchase(money, payment_source, options = {})
|
35
|
+
post = {}
|
36
|
+
add_invoice(post, options)
|
37
|
+
add_payment_source(post, payment_source, options)
|
38
|
+
add_address(post, options[:billing_address] || options[:address])
|
39
|
+
add_address(post, options[:shipping_address], "shipping")
|
40
|
+
add_customer_data(post, options)
|
41
|
+
add_currency(post, money, options)
|
42
|
+
add_processor(post, options)
|
43
|
+
commit('sale', money, post)
|
44
|
+
end
|
45
|
+
|
46
|
+
def capture(money, authorization, options = {})
|
47
|
+
post ={}
|
48
|
+
post[:transactionid] = authorization
|
49
|
+
commit('capture', money, post)
|
50
|
+
end
|
51
|
+
|
52
|
+
def void(authorization, options = {})
|
53
|
+
post ={}
|
54
|
+
post[:transactionid] = authorization
|
55
|
+
commit('void', nil, post)
|
56
|
+
end
|
57
|
+
|
58
|
+
def credit(money, payment_source, options = {})
|
59
|
+
post = {}
|
60
|
+
add_invoice(post, options)
|
61
|
+
add_payment_source(post, payment_source, options)
|
62
|
+
add_address(post, options[:billing_address] || options[:address])
|
63
|
+
add_customer_data(post, options)
|
64
|
+
add_sku(post,options)
|
65
|
+
add_currency(post, money, options)
|
66
|
+
add_processor(post, options)
|
67
|
+
commit('credit', money, post)
|
68
|
+
end
|
69
|
+
|
70
|
+
def refund(auth, options = {})
|
71
|
+
post = {}
|
72
|
+
add_transaction(post, auth)
|
73
|
+
commit('refund', options.delete(:amount), post)
|
74
|
+
end
|
75
|
+
|
76
|
+
|
77
|
+
# Update the values (such as CC expiration) stored at
|
78
|
+
# the gateway. The CC number must be supplied in the
|
79
|
+
# CreditCard object.
|
80
|
+
def update(vault_id, creditcard, options = {})
|
81
|
+
post = {}
|
82
|
+
post[:customer_vault] = "update_customer"
|
83
|
+
add_customer_vault_id(post, vault_id)
|
84
|
+
add_creditcard(post, creditcard, options)
|
85
|
+
add_address(post, options[:billing_address] || options[:address])
|
86
|
+
add_customer_data(post, options)
|
87
|
+
|
88
|
+
commit(nil, nil, post)
|
89
|
+
end
|
90
|
+
|
91
|
+
# Amend an existing transaction
|
92
|
+
def amend(auth, options = {})
|
93
|
+
post = {}
|
94
|
+
add_invoice(post, options)
|
95
|
+
add_transaction(post, auth)
|
96
|
+
commit('update', nil, post)
|
97
|
+
end
|
98
|
+
|
99
|
+
|
100
|
+
def delete(vault_id)
|
101
|
+
post = {}
|
102
|
+
post[:customer_vault] = "delete_customer"
|
103
|
+
add_customer_vault_id(post, vault_id)
|
104
|
+
commit(nil, nil, post)
|
105
|
+
end
|
106
|
+
|
107
|
+
# To match the other stored-value gateways, like TrustCommerce,
|
108
|
+
# store and unstore need to be defined
|
109
|
+
def store(payment_source, options = {})
|
110
|
+
post = {}
|
111
|
+
billing_id = options.delete(:billing_id).to_s || true
|
112
|
+
add_payment_source(post, payment_source, :store => billing_id)
|
113
|
+
add_address(post, options[:billing_address] || options[:address])
|
114
|
+
add_customer_data(post, options)
|
115
|
+
commit(nil, nil, post)
|
116
|
+
end
|
117
|
+
|
118
|
+
alias_method :unstore, :delete
|
119
|
+
|
120
|
+
private
|
121
|
+
def add_customer_data(post, options)
|
122
|
+
if options.has_key? :email
|
123
|
+
post[:email] = options[:email]
|
124
|
+
end
|
125
|
+
|
126
|
+
if options.has_key? :ip
|
127
|
+
post[:ipaddress] = options[:ip]
|
128
|
+
end
|
129
|
+
end
|
130
|
+
|
131
|
+
def add_address(post, address,prefix="")
|
132
|
+
prefix +="_" unless prefix.blank?
|
133
|
+
unless address.blank? or address.values.blank?
|
134
|
+
post[prefix+"address1"] = address[:address1].to_s
|
135
|
+
post[prefix+"address2"] = address[:address2].to_s unless address[:address2].blank?
|
136
|
+
post[prefix+"company"] = address[:company].to_s
|
137
|
+
post[prefix+"phone"] = address[:phone].to_s
|
138
|
+
post[prefix+"zip"] = address[:zip].to_s
|
139
|
+
post[prefix+"city"] = address[:city].to_s
|
140
|
+
post[prefix+"country"] = address[:country].to_s
|
141
|
+
post[prefix+"state"] = address[:state].blank? ? 'n/a' : address[:state]
|
142
|
+
end
|
143
|
+
end
|
144
|
+
|
145
|
+
def add_currency(post, money, options)
|
146
|
+
post[:currency] = options[:currency] || currency(money)
|
147
|
+
end
|
148
|
+
|
149
|
+
def add_processor(post, options)
|
150
|
+
post[:processor] = options[:processor] unless options[:processor].nil?
|
151
|
+
end
|
152
|
+
|
153
|
+
def add_invoice(post, options)
|
154
|
+
post[:orderid] = options[:order_id].to_s.gsub(/[^\w.]/, '')
|
155
|
+
end
|
156
|
+
|
157
|
+
def add_payment_source(params, source, options={})
|
158
|
+
case determine_funding_source(source)
|
159
|
+
when :vault then add_customer_vault_id(params, source)
|
160
|
+
when :credit_card then add_creditcard(params, source, options)
|
161
|
+
when :check then add_check(params, source, options)
|
162
|
+
end
|
163
|
+
end
|
164
|
+
|
165
|
+
def add_customer_vault_id(params, vault_id)
|
166
|
+
params[:customer_vault_id] = vault_id
|
167
|
+
end
|
168
|
+
|
169
|
+
def add_creditcard(post, creditcard, options)
|
170
|
+
if options[:store]
|
171
|
+
post[:customer_vault] = "add_customer"
|
172
|
+
post[:customer_vault_id] = options[:store] unless options[:store] == true
|
173
|
+
end
|
174
|
+
post[:ccnumber] = creditcard.number
|
175
|
+
post[:cvv] = creditcard.verification_value if creditcard.verification_value?
|
176
|
+
post[:ccexp] = expdate(creditcard)
|
177
|
+
post[:firstname] = creditcard.first_name
|
178
|
+
post[:lastname] = creditcard.last_name
|
179
|
+
end
|
180
|
+
|
181
|
+
def add_check(post, check, options)
|
182
|
+
if options[:store]
|
183
|
+
post[:customer_vault] = "add_customer"
|
184
|
+
post[:customer_vault_id] = options[:store] unless options[:store] == true
|
185
|
+
end
|
186
|
+
|
187
|
+
post[:payment] = 'check' # Set transaction to ACH
|
188
|
+
post[:checkname] = check.name # The name on the customer's Checking Account
|
189
|
+
post[:checkaba] = check.routing_number # The customer's bank routing number
|
190
|
+
post[:checkaccount] = check.account_number # The customer's account number
|
191
|
+
post[:account_holder_type] = check.account_holder_type # The customer's type of ACH account
|
192
|
+
post[:account_type] = check.account_type # The customer's type of ACH account
|
193
|
+
end
|
194
|
+
|
195
|
+
def add_sku(post,options)
|
196
|
+
post["product_sku_#"] = options[:sku] || options["product_sku_#"]
|
197
|
+
end
|
198
|
+
|
199
|
+
def add_transaction(post, auth)
|
200
|
+
post[:transactionid] = auth
|
201
|
+
end
|
202
|
+
|
203
|
+
def parse(body)
|
204
|
+
results = {}
|
205
|
+
body.split(/&/).each do |pair|
|
206
|
+
key,val = pair.split(/=/)
|
207
|
+
results[key] = val
|
208
|
+
end
|
209
|
+
|
210
|
+
results
|
211
|
+
end
|
212
|
+
|
213
|
+
def commit(action, money, parameters)
|
214
|
+
parameters[:amount] = amount(money) if money
|
215
|
+
response = parse( ssl_post(api_url, post_data(action,parameters)) )
|
216
|
+
Response.new(response["response"] == "1", message_from(response), response,
|
217
|
+
:authorization => response["transactionid"],
|
218
|
+
:test => test?,
|
219
|
+
:cvv_result => response["cvvresponse"],
|
220
|
+
:avs_result => { :code => response["avsresponse"] }
|
221
|
+
)
|
222
|
+
|
223
|
+
end
|
224
|
+
|
225
|
+
def expdate(creditcard)
|
226
|
+
year = sprintf("%.04i", creditcard.year.to_i)
|
227
|
+
month = sprintf("%.02i", creditcard.month.to_i)
|
228
|
+
|
229
|
+
"#{month}#{year[-2..-1]}"
|
230
|
+
end
|
231
|
+
|
232
|
+
|
233
|
+
def message_from(response)
|
234
|
+
case response["responsetext"]
|
235
|
+
when "SUCCESS", "Approved", nil # This is dubious, but responses from UPDATE are nil.
|
236
|
+
"This transaction has been approved"
|
237
|
+
when "DECLINE"
|
238
|
+
"This transaction has been declined"
|
239
|
+
else
|
240
|
+
response["responsetext"]
|
241
|
+
end
|
242
|
+
end
|
243
|
+
|
244
|
+
def post_data(action, parameters = {})
|
245
|
+
post = {}
|
246
|
+
post[:username] = @options[:login]
|
247
|
+
post[:password] = @options[:password]
|
248
|
+
post[:type] = action if action
|
249
|
+
|
250
|
+
request = post.merge(parameters).map {|key,value| "#{key}=#{CGI.escape(value.to_s)}"}.join("&")
|
251
|
+
request
|
252
|
+
end
|
253
|
+
|
254
|
+
def determine_funding_source(source)
|
255
|
+
case
|
256
|
+
when source.is_a?(String) then :vault
|
257
|
+
when CreditCard.card_companies.keys.include?(card_brand(source)) then :credit_card
|
258
|
+
when card_brand(source) == 'check' then :check
|
259
|
+
else raise ArgumentError, "Unsupported funding source provided"
|
260
|
+
end
|
261
|
+
end
|
262
|
+
end
|
263
|
+
end
|
264
|
+
end
|
265
|
+
|
@@ -0,0 +1,127 @@
|
|
1
|
+
module ActiveMerchant #:nodoc:
|
2
|
+
module Billing #:nodoc:
|
3
|
+
class TransFirstGateway < Gateway
|
4
|
+
URL = 'https://webservices.primerchants.com/creditcard.asmx/CCSale'
|
5
|
+
|
6
|
+
self.supported_countries = ['US']
|
7
|
+
self.supported_cardtypes = [:visa, :master, :american_express, :discover]
|
8
|
+
self.homepage_url = 'http://www.transfirst.com/'
|
9
|
+
self.display_name = 'TransFirst'
|
10
|
+
|
11
|
+
UNUSED_FIELDS = %w(ECIValue UserId CAVVData TrackData POSInd EComInd MerchZIP MerchCustPNum MCC InstallmentNum InstallmentOf POSEntryMode POSConditionCode AuthCharInd CardCertData)
|
12
|
+
|
13
|
+
DECLINED = 'The transaction was declined'
|
14
|
+
|
15
|
+
def initialize(options = {})
|
16
|
+
requires!(options, :login, :password)
|
17
|
+
@options = options
|
18
|
+
super
|
19
|
+
end
|
20
|
+
|
21
|
+
def purchase(money, credit_card, options = {})
|
22
|
+
post = {}
|
23
|
+
|
24
|
+
add_amount(post, money)
|
25
|
+
add_invoice(post, options)
|
26
|
+
add_credit_card(post, credit_card)
|
27
|
+
add_address(post, options)
|
28
|
+
|
29
|
+
commit(post)
|
30
|
+
end
|
31
|
+
|
32
|
+
private
|
33
|
+
def add_amount(post, money)
|
34
|
+
add_pair(post, :Amount, amount(money), :required => true)
|
35
|
+
end
|
36
|
+
|
37
|
+
def add_address(post, options)
|
38
|
+
address = options[:billing_address] || options[:address]
|
39
|
+
|
40
|
+
if address
|
41
|
+
add_pair(post, :Address, address[:address1])
|
42
|
+
add_pair(post, :ZipCode, address[:zip])
|
43
|
+
end
|
44
|
+
end
|
45
|
+
|
46
|
+
def add_invoice(post, options)
|
47
|
+
add_pair(post, :RefID, options[:order_id], :required => true)
|
48
|
+
add_pair(post, :PONumber, options[:invoice], :required => true)
|
49
|
+
add_pair(post, :SaleTaxAmount, amount(options[:tax] || 0))
|
50
|
+
add_pair(post, :PaymentDesc, options[:description], :required => true)
|
51
|
+
add_pair(post, :TaxIndicator, 0)
|
52
|
+
end
|
53
|
+
|
54
|
+
def add_credit_card(post, credit_card)
|
55
|
+
add_pair(post, :CardHolderName, credit_card.name, :required => true)
|
56
|
+
add_pair(post, :CardNumber, credit_card.number, :required => true)
|
57
|
+
|
58
|
+
add_pair(post, :Expiration, expdate(credit_card), :required => true)
|
59
|
+
add_pair(post, :CVV2, credit_card.verification_value)
|
60
|
+
end
|
61
|
+
|
62
|
+
def add_unused_fields(post)
|
63
|
+
UNUSED_FIELDS.each do |f|
|
64
|
+
post[f] = ""
|
65
|
+
end
|
66
|
+
end
|
67
|
+
|
68
|
+
def expdate(credit_card)
|
69
|
+
year = format(credit_card.year, :two_digits)
|
70
|
+
month = format(credit_card.month, :two_digits)
|
71
|
+
|
72
|
+
"#{month}#{year}"
|
73
|
+
end
|
74
|
+
|
75
|
+
def parse(data)
|
76
|
+
response = {}
|
77
|
+
|
78
|
+
xml = REXML::Document.new(data)
|
79
|
+
root = REXML::XPath.first(xml, "//CCSaleDebitResponse")
|
80
|
+
|
81
|
+
if root.nil?
|
82
|
+
response[:message] = data.to_s.strip
|
83
|
+
else
|
84
|
+
root.elements.to_a.each do |node|
|
85
|
+
response[node.name.underscore.to_sym] = node.text
|
86
|
+
end
|
87
|
+
end
|
88
|
+
|
89
|
+
response
|
90
|
+
end
|
91
|
+
|
92
|
+
def commit(params)
|
93
|
+
response = parse( ssl_post(URL, post_data(params)) )
|
94
|
+
|
95
|
+
Response.new(response[:status] == "Authorized", message_from(response), response,
|
96
|
+
:test => test?,
|
97
|
+
:authorization => response[:trans_id],
|
98
|
+
:avs_result => { :code => response[:avs_code] },
|
99
|
+
:cvv_result => response[:cvv2_code]
|
100
|
+
)
|
101
|
+
end
|
102
|
+
|
103
|
+
def message_from(response)
|
104
|
+
case response[:message]
|
105
|
+
when 'Call Voice Center'
|
106
|
+
DECLINED
|
107
|
+
else
|
108
|
+
response[:message]
|
109
|
+
end
|
110
|
+
end
|
111
|
+
|
112
|
+
def post_data(params = {})
|
113
|
+
add_unused_fields(params)
|
114
|
+
params[:MerchantID] = @options[:login]
|
115
|
+
params[:RegKey] = @options[:password]
|
116
|
+
|
117
|
+
request = params.collect { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join("&")
|
118
|
+
request
|
119
|
+
end
|
120
|
+
|
121
|
+
def add_pair(post, key, value, options = {})
|
122
|
+
post[key] = value if !value.blank? || options[:required]
|
123
|
+
end
|
124
|
+
end
|
125
|
+
end
|
126
|
+
end
|
127
|
+
|
@@ -0,0 +1,26 @@
|
|
1
|
+
require File.join(File.dirname(__FILE__),'smart_ps.rb')
|
2
|
+
|
3
|
+
module ActiveMerchant #:nodoc:
|
4
|
+
module Billing #:nodoc:
|
5
|
+
class TransaxGateway < SmartPs
|
6
|
+
def api_url
|
7
|
+
'https://secure.nelixtransax.net/api/transact.php'
|
8
|
+
end
|
9
|
+
|
10
|
+
# The countries the gateway supports merchants from as 2 digit ISO country codes
|
11
|
+
self.supported_countries = ['US']
|
12
|
+
|
13
|
+
# The card types supported by the payment gateway
|
14
|
+
self.supported_cardtypes = [:visa, :master, :american_express, :discover]
|
15
|
+
|
16
|
+
# The homepage URL of the gateway
|
17
|
+
self.homepage_url = 'https://www.nelixtransax.com/'
|
18
|
+
|
19
|
+
# The name of the gateway
|
20
|
+
self.display_name = 'NELiX TransaX'
|
21
|
+
|
22
|
+
end
|
23
|
+
TransaXGateway = TransaxGateway
|
24
|
+
end
|
25
|
+
end
|
26
|
+
|
@@ -0,0 +1,418 @@
|
|
1
|
+
begin
|
2
|
+
require 'tclink'
|
3
|
+
rescue LoadError
|
4
|
+
# Falls back to an SSL post to TrustCommerce
|
5
|
+
end
|
6
|
+
|
7
|
+
module ActiveMerchant #:nodoc:
|
8
|
+
module Billing #:nodoc:
|
9
|
+
# TO USE:
|
10
|
+
# First, make sure you have everything setup correctly and all of your dependencies in place with:
|
11
|
+
#
|
12
|
+
# require 'rubygems'
|
13
|
+
# require 'active_merchant'
|
14
|
+
#
|
15
|
+
# ActiveMerchant expects amounts to be Integer values in cents
|
16
|
+
#
|
17
|
+
# tendollar = 1000
|
18
|
+
#
|
19
|
+
# Next, create a credit card object using a TC approved test card.
|
20
|
+
#
|
21
|
+
# creditcard = ActiveMerchant::Billing::CreditCard.new(
|
22
|
+
# :number => '4111111111111111',
|
23
|
+
# :month => 8,
|
24
|
+
# :year => 2006,
|
25
|
+
# :first_name => 'Longbob',
|
26
|
+
# :last_name => 'Longsen'
|
27
|
+
# )
|
28
|
+
#
|
29
|
+
# To finish setting up, create the active_merchant object you will be using, with the TrustCommerce gateway. If you have a
|
30
|
+
# functional TrustCommerce account, replace login and password with your account info. Otherwise the defaults will work for
|
31
|
+
# testing.
|
32
|
+
#
|
33
|
+
# gateway = ActiveMerchant::Billing::Base.gateway(:trust_commerce).new(:login => "TestMerchant", :password => "password")
|
34
|
+
#
|
35
|
+
# Now we are ready to process our transaction
|
36
|
+
#
|
37
|
+
# response = gateway.purchase(tendollar, creditcard)
|
38
|
+
#
|
39
|
+
# Sending a transaction to TrustCommerce with active_merchant returns a Response object, which consistently allows you to:
|
40
|
+
#
|
41
|
+
# 1) Check whether the transaction was successful
|
42
|
+
#
|
43
|
+
# response.success?
|
44
|
+
#
|
45
|
+
# 2) Retrieve any message returned by TrustCommerce, either a "transaction was successful" note or an explanation of why the
|
46
|
+
# transaction was rejected.
|
47
|
+
#
|
48
|
+
# response.message
|
49
|
+
#
|
50
|
+
# 3) Retrieve and store the unique transaction ID returned by Trust Commerece, for use in referencing the transaction in the future.
|
51
|
+
#
|
52
|
+
# response.params["transid"]
|
53
|
+
#
|
54
|
+
# For higher performance and failover with the TrustCommerceGateway you can install the TCLink library from http://www.trustcommerce.com/tclink.html.
|
55
|
+
# Follow the instructions available there to get it working on your system. ActiveMerchant will automatically use tclink if available.
|
56
|
+
#
|
57
|
+
# The TCLink library has the following added benefits:
|
58
|
+
# * Good transaction times. Transaction duration under 1.2 seconds are common.
|
59
|
+
# * Fail-over to geographically distributed servers for extreme reliability
|
60
|
+
#
|
61
|
+
# Once it is installed, you should be able to make sure
|
62
|
+
# that it is visible to your ruby install by opening irb and typing "require 'tclink'", which should return "true".
|
63
|
+
#
|
64
|
+
# This should be enough to get you started with Trust Commerce and active_merchant. For further information, review the methods
|
65
|
+
# below and the rest of active_merchant's documentation, as well as Trust Commerce's user and developer documentation.
|
66
|
+
|
67
|
+
class TrustCommerceGateway < Gateway
|
68
|
+
URL = 'https://vault.trustcommerce.com/trans/'
|
69
|
+
|
70
|
+
SUCCESS_TYPES = ["approved", "accepted"]
|
71
|
+
|
72
|
+
DECLINE_CODES = {
|
73
|
+
"decline" => "The credit card was declined",
|
74
|
+
"avs" => "AVS failed; the address entered does not match the billing address on file at the bank",
|
75
|
+
"cvv" => "CVV failed; the number provided is not the correct verification number for the card",
|
76
|
+
"call" => "The card must be authorized manually over the phone",
|
77
|
+
"expiredcard" => "Issuer was not certified for card verification",
|
78
|
+
"carderror" => "Card number is invalid",
|
79
|
+
"authexpired" => "Attempt to postauth an expired (more than 14 days old) preauth",
|
80
|
+
"fraud" => "CrediGuard fraud score was below requested threshold",
|
81
|
+
"blacklist" => "CrediGuard blacklist value was triggered",
|
82
|
+
"velocity" => "CrediGuard velocity control value was triggered",
|
83
|
+
"dailylimit" => "Daily limit in transaction count or amount as been reached",
|
84
|
+
"weeklylimit" => "Weekly limit in transaction count or amount as been reached",
|
85
|
+
"monthlylimit" => "Monthly limit in transaction count or amount as been reached"
|
86
|
+
}
|
87
|
+
|
88
|
+
BADDATA_CODES = {
|
89
|
+
"missingfields" => "One or more parameters required for this transaction type were not sent",
|
90
|
+
"extrafields" => "Parameters not allowed for this transaction type were sent",
|
91
|
+
"badformat" => "A field was improperly formatted, such as non-digit characters in a number field",
|
92
|
+
"badlength" => "A field was longer or shorter than the server allows",
|
93
|
+
"merchantcantaccept" => "The merchant can't accept data passed in this field",
|
94
|
+
"mismatch" => "Data in one of the offending fields did not cross-check with the other offending field"
|
95
|
+
}
|
96
|
+
|
97
|
+
ERROR_CODES = {
|
98
|
+
"cantconnect" => "Couldn't connect to the TrustCommerce gateway",
|
99
|
+
"dnsfailure" => "The TCLink software was unable to resolve DNS hostnames",
|
100
|
+
"linkfailure" => "The connection was established, but was severed before the transaction could complete",
|
101
|
+
"failtoprocess" => "The bank servers are offline and unable to authorize transactions"
|
102
|
+
}
|
103
|
+
|
104
|
+
TEST_LOGIN = 'TestMerchant'
|
105
|
+
TEST_PASSWORD = 'password'
|
106
|
+
|
107
|
+
self.money_format = :cents
|
108
|
+
self.supported_cardtypes = [:visa, :master, :discover, :american_express, :diners_club, :jcb]
|
109
|
+
self.supported_countries = ['US']
|
110
|
+
self.homepage_url = 'http://www.trustcommerce.com/'
|
111
|
+
self.display_name = 'TrustCommerce'
|
112
|
+
|
113
|
+
def self.tclink?
|
114
|
+
defined?(TCLink)
|
115
|
+
end
|
116
|
+
|
117
|
+
# Creates a new TrustCommerceGateway
|
118
|
+
#
|
119
|
+
# The gateway requires that a valid login and password be passed
|
120
|
+
# in the +options+ hash.
|
121
|
+
#
|
122
|
+
# ==== Options
|
123
|
+
#
|
124
|
+
# * <tt>:login</tt> -- The TrustCommerce account login.
|
125
|
+
# * <tt>:password</tt> -- The TrustCommerce account password.
|
126
|
+
# * <tt>:test => +true+ or +false+</tt> -- Perform test transactions
|
127
|
+
#
|
128
|
+
# ==== Test Account Credentials
|
129
|
+
# * <tt>:login</tt> -- TestMerchant
|
130
|
+
# * <tt>:password</tt> -- password
|
131
|
+
def initialize(options = {})
|
132
|
+
requires!(options, :login, :password)
|
133
|
+
|
134
|
+
@options = options
|
135
|
+
super
|
136
|
+
end
|
137
|
+
|
138
|
+
def tclink?
|
139
|
+
self.class.tclink?
|
140
|
+
end
|
141
|
+
|
142
|
+
def test?
|
143
|
+
@options[:login] == TEST_LOGIN &&
|
144
|
+
@options[:password] == TEST_PASSWORD || @options[:test] || super
|
145
|
+
end
|
146
|
+
|
147
|
+
# authorize() is the first half of the preauth(authorize)/postauth(capture) model. The TC API docs call this
|
148
|
+
# preauth, we preserve active_merchant's nomenclature of authorize() for consistency with the rest of the library. This
|
149
|
+
# method simply checks to make sure funds are available for a transaction, and returns a transid that can be used later to
|
150
|
+
# postauthorize (capture) the funds.
|
151
|
+
|
152
|
+
def authorize(money, creditcard_or_billing_id, options = {})
|
153
|
+
parameters = {
|
154
|
+
:amount => amount(money),
|
155
|
+
}
|
156
|
+
|
157
|
+
add_order_id(parameters, options)
|
158
|
+
add_customer_data(parameters, options)
|
159
|
+
add_payment_source(parameters, creditcard_or_billing_id)
|
160
|
+
add_addresses(parameters, options)
|
161
|
+
commit('preauth', parameters)
|
162
|
+
end
|
163
|
+
|
164
|
+
# purchase() is a simple sale. This is one of the most common types of transactions, and is extremely simple. All that you need
|
165
|
+
# to process a purchase are an amount in cents or a money object and a creditcard object or billingid string.
|
166
|
+
def purchase(money, creditcard_or_billing_id, options = {})
|
167
|
+
parameters = {
|
168
|
+
:amount => amount(money),
|
169
|
+
}
|
170
|
+
|
171
|
+
add_order_id(parameters, options)
|
172
|
+
add_customer_data(parameters, options)
|
173
|
+
add_payment_source(parameters, creditcard_or_billing_id)
|
174
|
+
add_addresses(parameters, options)
|
175
|
+
commit('sale', parameters)
|
176
|
+
end
|
177
|
+
|
178
|
+
# capture() is the second half of the preauth(authorize)/postauth(capture) model. The TC API docs call this
|
179
|
+
# postauth, we preserve active_merchant's nomenclature of capture() for consistency with the rest of the library. To process
|
180
|
+
# a postauthorization with TC, you need an amount in cents or a money object, and a TC transid.
|
181
|
+
def capture(money, authorization, options = {})
|
182
|
+
parameters = {
|
183
|
+
:amount => amount(money),
|
184
|
+
:transid => authorization,
|
185
|
+
}
|
186
|
+
|
187
|
+
commit('postauth', parameters)
|
188
|
+
end
|
189
|
+
|
190
|
+
# credit() allows you to return money to a card that was previously billed. You need to supply the amount, in cents or a money object,
|
191
|
+
# that you want to refund, and a TC transid for the transaction that you are refunding.
|
192
|
+
def credit(money, identification, options = {})
|
193
|
+
parameters = {
|
194
|
+
:amount => amount(money),
|
195
|
+
:transid => identification
|
196
|
+
}
|
197
|
+
|
198
|
+
commit('credit', parameters)
|
199
|
+
end
|
200
|
+
|
201
|
+
# void() clears an existing authorization and releases the reserved fund
|
202
|
+
# s back to the cardholder. The TC API refers to this transaction as a
|
203
|
+
# reversal. After voiding, you will no longer be able to capture funds
|
204
|
+
# from this authorization. TrustCommerce seems to always return a status
|
205
|
+
# of "accepted" even if the transid you are trying to deauthorize has
|
206
|
+
# already been captured. Note: Your account needs to be configured by
|
207
|
+
# TrustCommerce to allow for reversal transactions before you can use this
|
208
|
+
# method.
|
209
|
+
#
|
210
|
+
# NOTE: AMEX preauth's cannot be reversed. If you want to clear it more
|
211
|
+
# quickly than the automatic expiration (7-10 days), you will have to
|
212
|
+
# capture it and then immediately issue a credit for the same amount
|
213
|
+
# which should clear the customers credit card with 48 hours according to
|
214
|
+
# TC.
|
215
|
+
def void(authorization, options = {})
|
216
|
+
parameters = {
|
217
|
+
:transid => authorization,
|
218
|
+
}
|
219
|
+
|
220
|
+
commit('reversal', parameters)
|
221
|
+
end
|
222
|
+
|
223
|
+
# recurring() a TrustCommerce account that is activated for Citatdel, TrustCommerce's
|
224
|
+
# hosted customer billing info database.
|
225
|
+
#
|
226
|
+
# Recurring billing uses the same TC action as a plain-vanilla 'store', but we have a separate method for clarity. It can be called
|
227
|
+
# like store, with the addition of a required 'periodicity' parameter:
|
228
|
+
#
|
229
|
+
# The parameter :periodicity should be specified as either :bimonthly, :monthly, :biweekly, :weekly, :yearly or :daily
|
230
|
+
#
|
231
|
+
# gateway.recurring(tendollar, creditcard, :periodicity => :weekly)
|
232
|
+
#
|
233
|
+
# You can optionally specify how long you want payments to continue using 'payments'
|
234
|
+
def recurring(money, creditcard, options = {})
|
235
|
+
requires!(options, [:periodicity, :bimonthly, :monthly, :biweekly, :weekly, :yearly, :daily] )
|
236
|
+
|
237
|
+
cycle = case options[:periodicity]
|
238
|
+
when :monthly
|
239
|
+
'1m'
|
240
|
+
when :bimonthly
|
241
|
+
'2m'
|
242
|
+
when :weekly
|
243
|
+
'1w'
|
244
|
+
when :biweekly
|
245
|
+
'2w'
|
246
|
+
when :yearly
|
247
|
+
'1y'
|
248
|
+
when :daily
|
249
|
+
'1d'
|
250
|
+
end
|
251
|
+
|
252
|
+
parameters = {
|
253
|
+
:amount => amount(money),
|
254
|
+
:cycle => cycle,
|
255
|
+
:verify => options[:verify] || 'y',
|
256
|
+
:billingid => options[:billingid] || nil,
|
257
|
+
:payments => options[:payments] || nil,
|
258
|
+
}
|
259
|
+
|
260
|
+
add_creditcard(parameters, creditcard)
|
261
|
+
|
262
|
+
commit('store', parameters)
|
263
|
+
end
|
264
|
+
|
265
|
+
# store() requires a TrustCommerce account that is activated for Citatdel. You can call it with a credit card and a billing ID
|
266
|
+
# you would like to use to reference the stored credit card info for future captures. Use 'verify' to specify whether you want
|
267
|
+
# to simply store the card in the DB, or you want TC to verify the data first.
|
268
|
+
|
269
|
+
def store(creditcard, options = {})
|
270
|
+
parameters = {
|
271
|
+
:verify => options[:verify] || 'y',
|
272
|
+
:billingid => options[:billingid] || options[:billing_id] || nil,
|
273
|
+
}
|
274
|
+
|
275
|
+
add_creditcard(parameters, creditcard)
|
276
|
+
add_addresses(parameters, options)
|
277
|
+
commit('store', parameters)
|
278
|
+
end
|
279
|
+
|
280
|
+
# To unstore a creditcard stored in Citadel using store() or recurring(), all that is required is the billing id. When you run
|
281
|
+
# unstore() the information will be removed and a Response object will be returned indicating the success of the action.
|
282
|
+
def unstore(identification, options = {})
|
283
|
+
parameters = {
|
284
|
+
:billingid => identification,
|
285
|
+
}
|
286
|
+
|
287
|
+
commit('unstore', parameters)
|
288
|
+
end
|
289
|
+
|
290
|
+
private
|
291
|
+
def add_payment_source(params, source)
|
292
|
+
if source.is_a?(String)
|
293
|
+
add_billing_id(params, source)
|
294
|
+
else
|
295
|
+
add_creditcard(params, source)
|
296
|
+
end
|
297
|
+
end
|
298
|
+
|
299
|
+
def expdate(creditcard)
|
300
|
+
year = sprintf("%.4i", creditcard.year)
|
301
|
+
month = sprintf("%.2i", creditcard.month)
|
302
|
+
|
303
|
+
"#{month}#{year[-2..-1]}"
|
304
|
+
end
|
305
|
+
|
306
|
+
def add_creditcard(params, creditcard)
|
307
|
+
params[:media] = "cc"
|
308
|
+
params[:name] = creditcard.name
|
309
|
+
params[:cc] = creditcard.number
|
310
|
+
params[:exp] = expdate(creditcard)
|
311
|
+
params[:cvv] = creditcard.verification_value if creditcard.verification_value?
|
312
|
+
end
|
313
|
+
|
314
|
+
def add_order_id(params, options)
|
315
|
+
params[:ticket] = options[:order_id] unless options[:order_id].blank?
|
316
|
+
end
|
317
|
+
|
318
|
+
def add_billing_id(params, billingid)
|
319
|
+
params[:billingid] = billingid
|
320
|
+
end
|
321
|
+
|
322
|
+
def add_customer_data(params, options)
|
323
|
+
params[:email] = options[:email] unless options[:email].blank?
|
324
|
+
params[:ip] = options[:ip] unless options[:ip].blank?
|
325
|
+
end
|
326
|
+
|
327
|
+
def add_addresses(params, options)
|
328
|
+
address = options[:billing_address] || options[:address]
|
329
|
+
|
330
|
+
if address
|
331
|
+
params[:address1] = address[:address1] unless address[:address1].blank?
|
332
|
+
params[:address2] = address[:address2] unless address[:address2].blank?
|
333
|
+
params[:city] = address[:city] unless address[:city].blank?
|
334
|
+
params[:state] = address[:state] unless address[:state].blank?
|
335
|
+
params[:zip] = address[:zip] unless address[:zip].blank?
|
336
|
+
params[:country] = address[:country] unless address[:country].blank?
|
337
|
+
params[:avs] = 'n'
|
338
|
+
end
|
339
|
+
|
340
|
+
if shipping_address = options[:shipping_address]
|
341
|
+
params[:shipto_name] = shipping_address[:name] unless shipping_address[:name].blank?
|
342
|
+
params[:shipto_address1] = shipping_address[:address1] unless shipping_address[:address1].blank?
|
343
|
+
params[:shipto_address2] = shipping_address[:address2] unless shipping_address[:address2].blank?
|
344
|
+
params[:shipto_city] = shipping_address[:city] unless shipping_address[:city].blank?
|
345
|
+
params[:shipto_state] = shipping_address[:state] unless shipping_address[:state].blank?
|
346
|
+
params[:shipto_zip] = shipping_address[:zip] unless shipping_address[:zip].blank?
|
347
|
+
params[:shipto_country] = shipping_address[:country] unless shipping_address[:country].blank?
|
348
|
+
end
|
349
|
+
end
|
350
|
+
|
351
|
+
def clean_and_stringify_params(parameters)
|
352
|
+
# TCLink wants us to send a hash with string keys, and activemerchant pushes everything around with
|
353
|
+
# symbol keys. Before sending our input to TCLink, we convert all our keys to strings and dump the symbol keys.
|
354
|
+
# We also remove any pairs with nil values, as these confuse TCLink.
|
355
|
+
parameters.keys.reverse.each do |key|
|
356
|
+
if parameters[key]
|
357
|
+
parameters[key.to_s] = parameters[key]
|
358
|
+
end
|
359
|
+
parameters.delete(key)
|
360
|
+
end
|
361
|
+
end
|
362
|
+
|
363
|
+
def post_data(parameters)
|
364
|
+
parameters.collect { |key, value| "#{key}=#{ CGI.escape(value.to_s)}" }.join("&")
|
365
|
+
end
|
366
|
+
|
367
|
+
def commit(action, parameters)
|
368
|
+
parameters[:custid] = @options[:login]
|
369
|
+
parameters[:password] = @options[:password]
|
370
|
+
parameters[:demo] = test? ? 'y' : 'n'
|
371
|
+
parameters[:action] = action
|
372
|
+
|
373
|
+
clean_and_stringify_params(parameters)
|
374
|
+
|
375
|
+
data = if tclink?
|
376
|
+
TCLink.send(parameters)
|
377
|
+
else
|
378
|
+
parse( ssl_post(URL, post_data(parameters)) )
|
379
|
+
end
|
380
|
+
|
381
|
+
# to be considered successful, transaction status must be either "approved" or "accepted"
|
382
|
+
success = SUCCESS_TYPES.include?(data["status"])
|
383
|
+
message = message_from(data)
|
384
|
+
Response.new(success, message, data,
|
385
|
+
:test => test?,
|
386
|
+
:authorization => data["transid"],
|
387
|
+
:cvv_result => data["cvv"],
|
388
|
+
:avs_result => { :code => data["avs"] }
|
389
|
+
)
|
390
|
+
end
|
391
|
+
|
392
|
+
def parse(body)
|
393
|
+
results = {}
|
394
|
+
|
395
|
+
body.split(/\n/).each do |pair|
|
396
|
+
key,val = pair.split(/=/)
|
397
|
+
results[key] = val
|
398
|
+
end
|
399
|
+
|
400
|
+
results
|
401
|
+
end
|
402
|
+
|
403
|
+
def message_from(data)
|
404
|
+
status = case data["status"]
|
405
|
+
when "decline"
|
406
|
+
return DECLINE_CODES[data["declinetype"]]
|
407
|
+
when "baddata"
|
408
|
+
return BADDATA_CODES[data["error"]]
|
409
|
+
when "error"
|
410
|
+
return ERROR_CODES[data["errortype"]]
|
411
|
+
else
|
412
|
+
return "The transaction was successful"
|
413
|
+
end
|
414
|
+
end
|
415
|
+
|
416
|
+
end
|
417
|
+
end
|
418
|
+
end
|