noctivityinc-activemerchant 1.5.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (132) hide show
  1. data/CHANGELOG +506 -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 +406 -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/quantum.rb +272 -0
  61. data/lib/active_merchant/billing/gateways/quickpay.rb +213 -0
  62. data/lib/active_merchant/billing/gateways/realex.rb +200 -0
  63. data/lib/active_merchant/billing/gateways/sage/sage_bankcard.rb +88 -0
  64. data/lib/active_merchant/billing/gateways/sage/sage_core.rb +116 -0
  65. data/lib/active_merchant/billing/gateways/sage/sage_virtual_check.rb +97 -0
  66. data/lib/active_merchant/billing/gateways/sage.rb +146 -0
  67. data/lib/active_merchant/billing/gateways/sage_pay.rb +309 -0
  68. data/lib/active_merchant/billing/gateways/sallie_mae.rb +144 -0
  69. data/lib/active_merchant/billing/gateways/secure_pay.rb +31 -0
  70. data/lib/active_merchant/billing/gateways/secure_pay_au.rb +157 -0
  71. data/lib/active_merchant/billing/gateways/secure_pay_tech.rb +113 -0
  72. data/lib/active_merchant/billing/gateways/skip_jack.rb +453 -0
  73. data/lib/active_merchant/billing/gateways/smart_ps.rb +265 -0
  74. data/lib/active_merchant/billing/gateways/trans_first.rb +127 -0
  75. data/lib/active_merchant/billing/gateways/transax.rb +25 -0
  76. data/lib/active_merchant/billing/gateways/trust_commerce.rb +418 -0
  77. data/lib/active_merchant/billing/gateways/usa_epay.rb +194 -0
  78. data/lib/active_merchant/billing/gateways/verifi.rb +228 -0
  79. data/lib/active_merchant/billing/gateways/viaklix.rb +189 -0
  80. data/lib/active_merchant/billing/gateways/wirecard.rb +318 -0
  81. data/lib/active_merchant/billing/gateways.rb +18 -0
  82. data/lib/active_merchant/billing/integrations/action_view_helper.rb +79 -0
  83. data/lib/active_merchant/billing/integrations/bogus/helper.rb +17 -0
  84. data/lib/active_merchant/billing/integrations/bogus/notification.rb +11 -0
  85. data/lib/active_merchant/billing/integrations/bogus/return.rb +10 -0
  86. data/lib/active_merchant/billing/integrations/bogus.rb +23 -0
  87. data/lib/active_merchant/billing/integrations/chronopay/helper.rb +120 -0
  88. data/lib/active_merchant/billing/integrations/chronopay/notification.rb +158 -0
  89. data/lib/active_merchant/billing/integrations/chronopay/return.rb +10 -0
  90. data/lib/active_merchant/billing/integrations/chronopay.rb +23 -0
  91. data/lib/active_merchant/billing/integrations/gestpay/common.rb +42 -0
  92. data/lib/active_merchant/billing/integrations/gestpay/helper.rb +70 -0
  93. data/lib/active_merchant/billing/integrations/gestpay/notification.rb +85 -0
  94. data/lib/active_merchant/billing/integrations/gestpay/return.rb +10 -0
  95. data/lib/active_merchant/billing/integrations/gestpay.rb +25 -0
  96. data/lib/active_merchant/billing/integrations/helper.rb +93 -0
  97. data/lib/active_merchant/billing/integrations/hi_trust/helper.rb +58 -0
  98. data/lib/active_merchant/billing/integrations/hi_trust/notification.rb +59 -0
  99. data/lib/active_merchant/billing/integrations/hi_trust/return.rb +67 -0
  100. data/lib/active_merchant/billing/integrations/hi_trust.rb +27 -0
  101. data/lib/active_merchant/billing/integrations/nochex/helper.rb +68 -0
  102. data/lib/active_merchant/billing/integrations/nochex/notification.rb +94 -0
  103. data/lib/active_merchant/billing/integrations/nochex/return.rb +10 -0
  104. data/lib/active_merchant/billing/integrations/nochex.rb +88 -0
  105. data/lib/active_merchant/billing/integrations/notification.rb +62 -0
  106. data/lib/active_merchant/billing/integrations/paypal/helper.rb +119 -0
  107. data/lib/active_merchant/billing/integrations/paypal/notification.rb +154 -0
  108. data/lib/active_merchant/billing/integrations/paypal/return.rb +10 -0
  109. data/lib/active_merchant/billing/integrations/paypal.rb +39 -0
  110. data/lib/active_merchant/billing/integrations/quickpay/helper.rb +72 -0
  111. data/lib/active_merchant/billing/integrations/quickpay/notification.rb +74 -0
  112. data/lib/active_merchant/billing/integrations/quickpay.rb +17 -0
  113. data/lib/active_merchant/billing/integrations/return.rb +35 -0
  114. data/lib/active_merchant/billing/integrations/two_checkout/helper.rb +59 -0
  115. data/lib/active_merchant/billing/integrations/two_checkout/notification.rb +114 -0
  116. data/lib/active_merchant/billing/integrations/two_checkout/return.rb +17 -0
  117. data/lib/active_merchant/billing/integrations/two_checkout.rb +23 -0
  118. data/lib/active_merchant/billing/integrations.rb +29 -0
  119. data/lib/active_merchant/billing/response.rb +32 -0
  120. data/lib/active_merchant/billing.rb +9 -0
  121. data/lib/active_merchant/lib/connection.rb +170 -0
  122. data/lib/active_merchant/lib/country.rb +319 -0
  123. data/lib/active_merchant/lib/error.rb +4 -0
  124. data/lib/active_merchant/lib/post_data.rb +22 -0
  125. data/lib/active_merchant/lib/posts_data.rb +47 -0
  126. data/lib/active_merchant/lib/requires_parameters.rb +16 -0
  127. data/lib/active_merchant/lib/utils.rb +18 -0
  128. data/lib/active_merchant/lib/validateable.rb +76 -0
  129. data/lib/active_merchant.rb +46 -0
  130. data/lib/certs/cacert.pem +7815 -0
  131. data/lib/support/gateway_support.rb +58 -0
  132. metadata +204 -0
data/README.rdoc ADDED
@@ -0,0 +1,136 @@
1
+ = Active Merchant
2
+
3
+ This library is supposed to aid in creating e-commerce software in Ruby.
4
+ In the future we want to support all "good" payment gateways.
5
+
6
+ This library is the foundation of commerce for http://www.shopify.com.
7
+
8
+ Please visit the {ActiveMerchant homepage}[http://activemerchant.org] for more resources, tutorials and other information about this project.
9
+
10
+ == Supported Direct Payment Gateways
11
+
12
+ The {ActiveMerchant Wiki}[http://github.com/Shopify/active_merchant/wikis] contains a {table of features supported by each gateway}[http://github.com/Shopify/active_merchant/wikis/gatewayfeaturematrix].
13
+
14
+ * {Authorize.Net CIM}[http://www.authorize.net/] - US
15
+ * {Authorize.Net}[http://www.authorize.net/] - US
16
+ * {Beanstream.com}[http://www.beanstream.com/] - CA
17
+ * {Braintree}[http://www.braintreepaymentsolutions.com] - US
18
+ * {CardStream}[http://www.cardstream.com/] - GB
19
+ * {CyberSource}[http://www.cybersource.com] - US
20
+ * {DataCash}[http://www.datacash.com/] - GB
21
+ * {Efsnet}[http://www.concordefsnet.com/] - US
22
+ * {eWAY}[http://www.eway.com.au/] - AU
23
+ * {E-xact}[http://www.e-xact.com] - CA, US
24
+ * {LinkPoint}[http://www.linkpoint.com/] - US
25
+ * {Merchant e-Solutions}[http://merchante-solutions.com/] - US
26
+ * {Modern Payments}[http://www.modpay.com] - US
27
+ * {Moneris}[http://www.moneris.com/] - CA
28
+ * {NetRegistry}[http://www.netregistry.com.au] - AU
29
+ * {NELiX TransaX Gateway}[http://www.nelixtransax.com] - US
30
+ * {NETbilling}[http://www.netbilling.com] - US
31
+ * {PayJunction}[http://www.payjunction.com/] - US
32
+ * {PaySecure}[http://www.commsecure.com.au/paysecure.shtml] - AU
33
+ * {PayPal Express Checkout}[https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside] - US, CA, SG, AU
34
+ * {PayPal Payflow Pro}[https://www.paypal.com/cgi-bin/webscr?cmd=_payflow-pro-overview-outside] - US, CA, SG, AU
35
+ * {PayPal Website Payments Pro (UK)}[https://www.paypal.com/uk/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - GB
36
+ * {PaymentExpress}[http://www.paymentexpress.com/] - AU, MY, NZ, SG, ZA, GB, US
37
+ * {PayPal Website Payments Pro (CA)}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - CA
38
+ * {PayPal Express Checkout}[https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside] - US
39
+ * {PayPal Website Payments Pro (US)}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - US
40
+ * {Plug'n Pay}[http://www.plugnpay.com/] - US
41
+ * {Protx}[http://www.protx.com] - GB
42
+ * {Psigate}[http://www.psigate.com/] - CA
43
+ * {PSL Payment Solutions}[http://www.paymentsolutionsltd.com/] - GB
44
+ * {Quickpay}[http://quickpay.dk/] - DK
45
+ * {Realex}[http://www.realexpayments.com/] - IE, GB
46
+ * {Sage Payment Solutions}[http://www.sagepayments.com] - US, CA
47
+ * {Sallie Mae}[http://www.salliemae.com] - US
48
+ * {SecurePay}[http://securepay.com.au] - AU
49
+ * {SecurePay}[http://www.securepay.com/] - US
50
+ * {SecurePayTech}[http://www.securepaytech.com/] - NZ
51
+ * {SkipJack}[http://www.skipjack.com/] - US, CA
52
+ * {TransFirst}[http://www.transfirst.com/] - US
53
+ * {TrustCommerce}[http://www.trustcommerce.com/] - US
54
+ * {USA ePay}[http://www.usaepay.com/] - US
55
+ * {Verifi}[http://www.verifi.com/] - US
56
+ * {ViaKLIX}[http://viaklix.com] - US
57
+ * {Wirecard}[http://www.wirecard.com] - DE
58
+
59
+ == Supported Offsite Payment Gateways
60
+
61
+ * {PayPal Website Payments Standard}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-standard-overview-outside]
62
+ * Chronopay[http://www.chronopay.com]
63
+ * Nochex[http://www.nochex.com]
64
+ * {Banca Sella GestPay}[https://www.sella.it/banca/ecommerce/gestpay/gestpay.jsp]
65
+ * {2 Checkout}[http://www.2checkout.com]
66
+ * {HiTRUST}[http://www.hitrust.com.hk/]
67
+
68
+ == Download
69
+
70
+ Currently this library is available with git from:
71
+
72
+ git://github.com/Shopify/active_merchant.git
73
+
74
+ == Installation
75
+
76
+ === From Git
77
+
78
+ You can check out the latest source from git:
79
+
80
+ > git pull git://github.com/Shopify/active_merchant.git
81
+
82
+ === As a Rails plugin
83
+
84
+ ActiveMerchant includes an init.rb file. This means that Rails will automatically load ActiveMerchant on startup. Run the following command from the root directory of your Rails project to install ActiveMerchant as a Rails plugin:
85
+
86
+ > ./script/plugin install git://github.com/Shopify/active_merchant.git
87
+
88
+ === From Ruby Gems
89
+
90
+ Installation from RubyGems
91
+
92
+ > gem install activemerchant
93
+
94
+ == Sample Usage
95
+ require 'rubygems'
96
+ require 'active_merchant'
97
+
98
+ # Use the TrustCommerce test servers
99
+ ActiveMerchant::Billing::Base.mode = :test
100
+
101
+ # ActiveMerchant accepts all amounts as Integer values in cents
102
+ # $10.00
103
+ amount = 1000
104
+
105
+ # The card verification value is also known as CVV2, CVC2, or CID
106
+ credit_card = ActiveMerchant::Billing::CreditCard.new(
107
+ :first_name => 'Bob',
108
+ :last_name => 'Bobsen',
109
+ :number => '4242424242424242',
110
+ :month => '8',
111
+ :year => '2012',
112
+ :verification_value => '123'
113
+ )
114
+
115
+ # Validating the card automatically detects the card type
116
+ if credit_card.valid?
117
+
118
+ # Create a gateway object for the TrustCommerce service
119
+ gateway = ActiveMerchant::Billing::TrustCommerceGateway.new(
120
+ :login => 'TestMerchant',
121
+ :password => 'password'
122
+ )
123
+
124
+ # Authorize for the amount
125
+ response = gateway.purchase(amount, credit_card)
126
+
127
+ if response.success?
128
+ puts "Successfully charged $#{sprintf("%.2f", amount / 100)} to the credit card #{credit_card.display_number}"
129
+ else
130
+ raise StandardError, response.message
131
+ end
132
+ end
133
+
134
+ == Contributing
135
+
136
+ Please see the {ActiveMerchant Guide to Contributing}[http://github.com/Shopify/active_merchant/wikis/contributing] for information on adding a new gateway to ActiveMerchant.
@@ -0,0 +1,20 @@
1
+ -----BEGIN CERTIFICATE-----
2
+ MIIDNjCCAh6gAwIBAgIBADANBgkqhkiG9w0BAQUFADBBMRMwEQYDVQQDDApjb2R5
3
+ ZmF1c2VyMRUwEwYKCZImiZPyLGQBGRYFZ21haWwxEzARBgoJkiaJk/IsZAEZFgNj
4
+ b20wHhcNMDcwMjIyMTcyMTI3WhcNMDgwMjIyMTcyMTI3WjBBMRMwEQYDVQQDDApj
5
+ b2R5ZmF1c2VyMRUwEwYKCZImiZPyLGQBGRYFZ21haWwxEzARBgoJkiaJk/IsZAEZ
6
+ FgNjb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6T4Iqt5iWvAlU
7
+ iXI6L8UO0URQhIC65X/gJ9hL/x4lwSl/ckVm/R/bPrJGmifT+YooFv824N3y/TIX
8
+ 25o/lZtRj1TUZJK4OCb0aVzosQVxBHSe6rLmxO8cItNTMOM9wn3thaITFrTa1DOQ
9
+ O3wqEjvW2L6VMozVfK1MfjL9IGgy0rCnl+2g4Gh4jDDpkLfnMG5CWI6cTCf3C1ye
10
+ ytOpWgi0XpOEy8nQWcFmt/KCQ/kFfzBo4QxqJi54b80842EyvzWT9OB7Oew/CXZG
11
+ F2yIHtiYxonz6N09vvSzq4CvEuisoUFLKZnktndxMEBKwJU3XeSHAbuS7ix40OKO
12
+ WKuI54fHAgMBAAGjOTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
13
+ BBR9QQpefI3oDCAxiqJW/3Gg6jI6qjANBgkqhkiG9w0BAQUFAAOCAQEAs0lX26O+
14
+ HpyMp7WL+SgZuM8k76AjfOHuKajl2GEn3S8pWYGpsa0xu07HtehJhKLiavrfUYeE
15
+ qlFtyYMUyOh6/1S2vfkH6VqjX7mWjoi7XKHW/99fkMS40B5SbN+ypAUst+6c5R84
16
+ w390mjtLHpdDE6WQYhS6bFvBN53vK6jG3DLyCJc0K9uMQ7gdHWoxq7RnG92ncQpT
17
+ ThpRA+fky5Xt2Q63YJDnJpkYAz79QIama1enSnd4jslKzSl89JS2luq/zioPe/Us
18
+ hbyalWR1+HrhgPoSPq7nk+s2FQUBJ9UZFK1lgMzho/4fZgzJwbu+cO8SNuaLS/bj
19
+ hPaSTyVU0yCSnw==
20
+ -----END CERTIFICATE-----
@@ -0,0 +1,98 @@
1
+ #!ruby19
2
+ # encoding: utf-8
3
+
4
+ module ActiveMerchant
5
+ module Billing
6
+ # Implements the Address Verification System
7
+ # https://www.wellsfargo.com/downloads/pdf/biz/merchant/visa_avs.pdf
8
+ # http://en.wikipedia.org/wiki/Address_Verification_System
9
+ # http://apps.cybersource.com/library/documentation/dev_guides/CC_Svcs_IG/html/app_avs_cvn_codes.htm#app_AVS_CVN_codes_7891_48375
10
+ # http://imgserver.skipjack.com/imgServer/5293710/AVS%20and%20CVV2.pdf
11
+ # http://www.emsecommerce.net/avs_cvv2_response_codes.htm
12
+ class AVSResult
13
+ MESSAGES = {
14
+ 'A' => 'Street address matches, but 5-digit and 9-digit postal code do not match.',
15
+ 'B' => 'Street address matches, but postal code not verified.',
16
+ 'C' => 'Street address and postal code do not match.',
17
+ 'D' => 'Street address and postal code match.',
18
+ 'E' => 'AVS data is invalid or AVS is not allowed for this card type.',
19
+ 'F' => 'Card member\'s name does not match, but billing postal code matches.',
20
+ 'G' => 'Non-U.S. issuing bank does not support AVS.',
21
+ 'H' => 'Card member\'s name does not match. Street address and postal code match.',
22
+ 'I' => 'Address not verified.',
23
+ 'J' => 'Card member\'s name, billing address, and postal code match. Shipping information verified and chargeback protection guaranteed through the Fraud Protection Program.',
24
+ 'K' => 'Card member\'s name matches but billing address and billing postal code do not match.',
25
+ 'L' => 'Card member\'s name and billing postal code match, but billing address does not match.',
26
+ 'M' => 'Street address and postal code match.',
27
+ 'N' => 'Street address and postal code do not match.',
28
+ 'O' => 'Card member\'s name and billing address match, but billing postal code does not match.',
29
+ 'P' => 'Postal code matches, but street address not verified.',
30
+ 'Q' => 'Card member\'s name, billing address, and postal code match. Shipping information verified but chargeback protection not guaranteed.',
31
+ 'R' => 'System unavailable.',
32
+ 'S' => 'U.S.-issuing bank does not support AVS.',
33
+ 'T' => 'Card member\'s name does not match, but street address matches.',
34
+ 'U' => 'Address information unavailable.',
35
+ 'V' => 'Card member\'s name, billing address, and billing postal code match.',
36
+ 'W' => 'Street address does not match, but 9-digit postal code matches.',
37
+ 'X' => 'Street address and 9-digit postal code match.',
38
+ 'Y' => 'Street address and 5-digit postal code match.',
39
+ 'Z' => 'Street address does not match, but 5-digit postal code matches.'
40
+ }
41
+
42
+ # Map vendor's AVS result code to a postal match code
43
+ POSTAL_MATCH_CODE = {
44
+ 'Y' => %w( D H F H J L M P Q V W X Y Z ),
45
+ 'N' => %w( A C K N O ),
46
+ 'X' => %w( G S ),
47
+ nil => %w( B E I R T U )
48
+ }.inject({}) do |map, (type, codes)|
49
+ codes.each { |code| map[code] = type }
50
+ map
51
+ end
52
+
53
+ # Map vendor's AVS result code to a street match code
54
+ STREET_MATCH_CODE = {
55
+ 'Y' => %w( A B D H J M O Q T V X Y ),
56
+ 'N' => %w( C K L N P W Z ),
57
+ 'X' => %w( G S ),
58
+ nil => %w( E F I R U )
59
+ }.inject({}) do |map, (type, codes)|
60
+ codes.each { |code| map[code] = type }
61
+ map
62
+ end
63
+
64
+ attr_reader :code, :message, :street_match, :postal_match
65
+
66
+ def self.messages
67
+ MESSAGES
68
+ end
69
+
70
+ def initialize(attrs)
71
+ attrs ||= {}
72
+
73
+ @code = attrs[:code].upcase unless attrs[:code].blank?
74
+ @message = self.class.messages[code]
75
+
76
+ if attrs[:street_match].blank?
77
+ @street_match = STREET_MATCH_CODE[code]
78
+ else
79
+ @street_match = attrs[:street_match].upcase
80
+ end
81
+
82
+ if attrs[:postal_match].blank?
83
+ @postal_match = POSTAL_MATCH_CODE[code]
84
+ else
85
+ @postal_match = attrs[:postal_match].upcase
86
+ end
87
+ end
88
+
89
+ def to_hash
90
+ { 'code' => code,
91
+ 'message' => message,
92
+ 'street_match' => street_match,
93
+ 'postal_match' => postal_match
94
+ }
95
+ end
96
+ end
97
+ end
98
+ end
@@ -0,0 +1,57 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ module Base
4
+ # Set ActiveMerchant gateways in test mode.
5
+ #
6
+ # ActiveMerchant::Billing::Base.gateway_mode = :test
7
+ mattr_accessor :gateway_mode
8
+
9
+ # Set ActiveMerchant integrations in test mode.
10
+ #
11
+ # ActiveMerchant::Billing::Base.integration_mode = :test
12
+ mattr_accessor :integration_mode
13
+
14
+ # Set both the mode of both the gateways and integrations
15
+ # at once
16
+ mattr_reader :mode
17
+
18
+ def self.mode=(mode)
19
+ @@mode = mode
20
+ self.gateway_mode = mode
21
+ self.integration_mode = mode
22
+ end
23
+
24
+ self.mode = :production
25
+
26
+ # Return the matching gateway for the provider
27
+ # * <tt>bogus</tt>: BogusGateway - Does nothing (for testing)
28
+ # * <tt>moneris</tt>: MonerisGateway
29
+ # * <tt>authorize_net</tt>: AuthorizeNetGateway
30
+ # * <tt>trust_commerce</tt>: TrustCommerceGateway
31
+ #
32
+ # ActiveMerchant::Billing::Base.gateway('moneris').new
33
+ def self.gateway(name)
34
+ Billing.const_get("#{name.to_s.downcase}_gateway".camelize)
35
+ end
36
+
37
+
38
+ # Return the matching integration module
39
+ # You can then get the notification from the module
40
+ # * <tt>bogus</tt>: Bogus - Does nothing (for testing)
41
+ # * <tt>chronopay</tt>: Chronopay - Does nothing (for testing)
42
+ # * <tt>paypal</tt>: Chronopay - Does nothing (for testing)
43
+ #
44
+ # chronopay = ActiveMerchant::Billing::Base.integration('chronopay')
45
+ # notification = chronopay.notification(raw_post)
46
+ #
47
+ def self.integration(name)
48
+ Billing::Integrations.const_get("#{name.to_s.downcase}".camelize)
49
+ end
50
+
51
+ # A check to see if we're in test mode
52
+ def self.test?
53
+ self.gateway_mode == :test
54
+ end
55
+ end
56
+ end
57
+ end
@@ -0,0 +1,68 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ # The Check object is a plain old Ruby object, similar to CreditCard. It supports validation
4
+ # of necessary attributes such as checkholder's name, routing and account numbers, but it is
5
+ # not backed by any database.
6
+ #
7
+ # You may use Check in place of CreditCard with any gateway that supports it. Currently, only
8
+ # +BraintreeGateway+ supports the Check object.
9
+ class Check
10
+ include Validateable
11
+
12
+ attr_accessor :first_name, :last_name, :routing_number, :account_number, :account_holder_type, :account_type, :number
13
+
14
+ # Used for Canadian bank accounts
15
+ attr_accessor :institution_number, :transit_number
16
+
17
+ def name
18
+ @name ||= "#{@first_name} #{@last_name}".strip
19
+ end
20
+
21
+ def name=(value)
22
+ return if value.blank?
23
+
24
+ @name = value
25
+ segments = value.split(' ')
26
+ @last_name = segments.pop
27
+ @first_name = segments.join(' ')
28
+ end
29
+
30
+ def validate
31
+ [:name, :routing_number, :account_number].each do |attr|
32
+ errors.add(attr, "cannot be empty") if self.send(attr).blank?
33
+ end
34
+
35
+ errors.add(:routing_number, "is invalid") unless valid_routing_number?
36
+
37
+ errors.add(:account_holder_type, "must be personal or business") if
38
+ !account_holder_type.blank? && !%w[business personal].include?(account_holder_type.to_s)
39
+
40
+ errors.add(:account_type, "must be checking or savings") if
41
+ !account_type.blank? && !%w[checking savings].include?(account_type.to_s)
42
+ end
43
+
44
+ def type
45
+ 'check'
46
+ end
47
+
48
+ # Routing numbers may be validated by calculating a checksum and dividing it by 10. The
49
+ # formula is:
50
+ # (3(d1 + d4 + d7) + 7(d2 + d5 + d8) + 1(d3 + d6 + d9))mod 10 = 0
51
+ # See http://en.wikipedia.org/wiki/Routing_transit_number#Internal_checksums
52
+ def valid_routing_number?
53
+ d = routing_number.to_s.split('').map(&:to_i).select { |d| (0..9).include?(d) }
54
+ case d.size
55
+ when 9 then
56
+ checksum = ((3 * (d[0] + d[3] + d[6])) +
57
+ (7 * (d[1] + d[4] + d[7])) +
58
+ (d[2] + d[5] + d[8])) % 10
59
+ case checksum
60
+ when 0 then true
61
+ else false
62
+ end
63
+ else false
64
+ end
65
+ end
66
+ end
67
+ end
68
+ end
@@ -0,0 +1,159 @@
1
+ require 'time'
2
+ require 'date'
3
+ require 'active_merchant/billing/expiry_date'
4
+
5
+ module ActiveMerchant #:nodoc:
6
+ module Billing #:nodoc:
7
+ # == Description
8
+ # This credit card object can be used as a stand alone object. It acts just like an ActiveRecord object
9
+ # but doesn't support the .save method as its not backed by a database.
10
+ #
11
+ # For testing purposes, use the 'bogus' credit card type. This card skips the vast majority of
12
+ # validations. This allows you to focus on your core concerns until you're ready to be more concerned
13
+ # with the details of particular creditcards or your gateway.
14
+ #
15
+ # == Testing With CreditCard
16
+ # Often when testing we don't care about the particulars of a given card type. When using the 'test'
17
+ # mode in your Gateway, there are six different valid card numbers: 1, 2, 3, 'success', 'fail',
18
+ # and 'error'.
19
+ #
20
+ #--
21
+ # For details, see CreditCardMethods#valid_number?
22
+ #++
23
+ #
24
+ # == Example Usage
25
+ # cc = CreditCard.new(
26
+ # :first_name => 'Steve',
27
+ # :last_name => 'Smith',
28
+ # :month => '9',
29
+ # :year => '2010',
30
+ # :type => 'visa',
31
+ # :number => '4242424242424242'
32
+ # )
33
+ #
34
+ # cc.valid? # => true
35
+ # cc.display_number # => XXXX-XXXX-XXXX-4242
36
+ #
37
+ class CreditCard
38
+ include CreditCardMethods
39
+ include Validateable
40
+
41
+ ## Attributes
42
+
43
+ cattr_accessor :require_verification_value
44
+ self.require_verification_value = true
45
+
46
+ # Essential attributes for a valid, non-bogus creditcards
47
+ attr_accessor :number, :month, :year, :type, :first_name, :last_name
48
+
49
+ # Required for Switch / Solo cards
50
+ attr_accessor :start_month, :start_year, :issue_number
51
+
52
+ # Optional verification_value (CVV, CVV2 etc). Gateways will try their best to
53
+ # run validation on the passed in value if it is supplied
54
+ attr_accessor :verification_value
55
+
56
+ # Provides proxy access to an expiry date object
57
+ def expiry_date
58
+ ExpiryDate.new(@month, @year)
59
+ end
60
+
61
+ def expired?
62
+ expiry_date.expired?
63
+ end
64
+
65
+ def name?
66
+ first_name? && last_name?
67
+ end
68
+
69
+ def first_name?
70
+ !@first_name.blank?
71
+ end
72
+
73
+ def last_name?
74
+ !@last_name.blank?
75
+ end
76
+
77
+ def name
78
+ "#{@first_name} #{@last_name}"
79
+ end
80
+
81
+ def verification_value?
82
+ !@verification_value.blank?
83
+ end
84
+
85
+ # Show the card number, with all but last 4 numbers replace with "X". (XXXX-XXXX-XXXX-4338)
86
+ def display_number
87
+ self.class.mask(number)
88
+ end
89
+
90
+ def last_digits
91
+ self.class.last_digits(number)
92
+ end
93
+
94
+ def validate
95
+ validate_essential_attributes
96
+
97
+ # Bogus card is pretty much for testing purposes. Lets just skip these extra tests if its used
98
+ return if type == 'bogus'
99
+
100
+ validate_card_type
101
+ validate_card_number
102
+ validate_verification_value
103
+ validate_switch_or_solo_attributes
104
+ end
105
+
106
+ def self.requires_verification_value?
107
+ require_verification_value
108
+ end
109
+
110
+ private
111
+
112
+ def before_validate #:nodoc:
113
+ self.month = month.to_i
114
+ self.year = year.to_i
115
+ self.start_month = start_month.to_i unless start_month.nil?
116
+ self.start_year = start_year.to_i unless start_year.nil?
117
+ self.number = number.to_s.gsub(/[^\d]/, "")
118
+ self.type.downcase! if type.respond_to?(:downcase)
119
+ self.type = self.class.type?(number) if type.blank?
120
+ end
121
+
122
+ def validate_card_number #:nodoc:
123
+ errors.add :number, "is not a valid credit card number" unless CreditCard.valid_number?(number)
124
+ unless errors.on(:number) || errors.on(:type)
125
+ errors.add :type, "is not the correct card type" unless CreditCard.matching_type?(number, type)
126
+ end
127
+ end
128
+
129
+ def validate_card_type #:nodoc:
130
+ errors.add :type, "is required" if type.blank?
131
+ errors.add :type, "is invalid" unless CreditCard.card_companies.keys.include?(type)
132
+ end
133
+
134
+ def validate_essential_attributes #:nodoc:
135
+ errors.add :first_name, "cannot be empty" if @first_name.blank?
136
+ errors.add :last_name, "cannot be empty" if @last_name.blank?
137
+ errors.add :month, "is not a valid month" unless valid_month?(@month)
138
+ errors.add :year, "expired" if expired?
139
+ errors.add :year, "is not a valid year" unless valid_expiry_year?(@year)
140
+ end
141
+
142
+ def validate_switch_or_solo_attributes #:nodoc:
143
+ if %w[switch solo].include?(type)
144
+ unless valid_month?(@start_month) && valid_start_year?(@start_year) || valid_issue_number?(@issue_number)
145
+ errors.add :start_month, "is invalid" unless valid_month?(@start_month)
146
+ errors.add :start_year, "is invalid" unless valid_start_year?(@start_year)
147
+ errors.add :issue_number, "cannot be empty" unless valid_issue_number?(@issue_number)
148
+ end
149
+ end
150
+ end
151
+
152
+ def validate_verification_value #:nodoc:
153
+ if CreditCard.requires_verification_value?
154
+ errors.add :verification_value, "is required" unless verification_value?
155
+ end
156
+ end
157
+ end
158
+ end
159
+ end
@@ -0,0 +1,21 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ module CreditCardFormatting
4
+
5
+ # This method is used to format numerical information pertaining to credit cards.
6
+ #
7
+ # format(2005, :two_digits) # => "05"
8
+ # format(05, :four_digits) # => "0005"
9
+ def format(number, option)
10
+ return '' if number.blank?
11
+
12
+ case option
13
+ when :two_digits ; sprintf("%.2i", number)[-2..-1]
14
+ when :four_digits ; sprintf("%.4i", number)[-4..-1]
15
+ else number
16
+ end
17
+ end
18
+
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,125 @@
1
+ module ActiveMerchant #:nodoc:
2
+ module Billing #:nodoc:
3
+ # Convenience methods that can be included into a custom Credit Card object, such as an ActiveRecord based Credit Card object.
4
+ module CreditCardMethods
5
+ CARD_COMPANIES = {
6
+ 'visa' => /^4\d{12}(\d{3})?$/,
7
+ 'master' => /^(5[1-5]\d{4}|677189)\d{10}$/,
8
+ 'discover' => /^(6011|65\d{2})\d{12}$/,
9
+ 'american_express' => /^3[47]\d{13}$/,
10
+ 'diners_club' => /^3(0[0-5]|[68]\d)\d{11}$/,
11
+ 'jcb' => /^35(28|29|[3-8]\d)\d{12}$/,
12
+ 'switch' => /^6759\d{12}(\d{2,3})?$/,
13
+ 'solo' => /^6767\d{12}(\d{2,3})?$/,
14
+ 'dankort' => /^5019\d{12}$/,
15
+ 'maestro' => /^(5[06-8]|6\d)\d{10,17}$/,
16
+ 'forbrugsforeningen' => /^600722\d{10}$/,
17
+ 'laser' => /^(6304|6706|6771|6709)\d{8}(\d{4}|\d{6,7})?$/
18
+ }
19
+
20
+ def self.included(base)
21
+ base.extend(ClassMethods)
22
+ end
23
+
24
+ def valid_month?(month)
25
+ (1..12).include?(month)
26
+ end
27
+
28
+ def valid_expiry_year?(year)
29
+ (Time.now.year..Time.now.year + 20).include?(year)
30
+ end
31
+
32
+ def valid_start_year?(year)
33
+ year.to_s =~ /^\d{4}$/ && year.to_i > 1987
34
+ end
35
+
36
+ def valid_issue_number?(number)
37
+ number.to_s =~ /^\d{1,2}$/
38
+ end
39
+
40
+ module ClassMethods
41
+ # Returns true if it validates. Optionally, you can pass a card type as an argument and
42
+ # make sure it is of the correct type.
43
+ #
44
+ # References:
45
+ # - http://perl.about.com/compute/perl/library/nosearch/P073000.htm
46
+ # - http://www.beachnet.com/~hstiles/cardtype.html
47
+ def valid_number?(number)
48
+ valid_test_mode_card_number?(number) ||
49
+ valid_card_number_length?(number) &&
50
+ valid_checksum?(number)
51
+ end
52
+
53
+ # Regular expressions for the known card companies.
54
+ #
55
+ # References:
56
+ # - http://en.wikipedia.org/wiki/Credit_card_number
57
+ # - http://www.barclaycardbusiness.co.uk/information_zone/processing/bin_rules.html
58
+ def card_companies
59
+ CARD_COMPANIES
60
+ end
61
+
62
+ # Returns a string containing the type of card from the list of known information below.
63
+ # Need to check the cards in a particular order, as there is some overlap of the allowable ranges
64
+ #--
65
+ # TODO Refactor this method. We basically need to tighten up the Maestro Regexp.
66
+ #
67
+ # Right now the Maestro regexp overlaps with the MasterCard regexp (IIRC). If we can tighten
68
+ # things up, we can boil this whole thing down to something like...
69
+ #
70
+ # def type?(number)
71
+ # return 'visa' if valid_test_mode_card_number?(number)
72
+ # card_companies.find([nil]) { |type, regexp| number =~ regexp }.first.dup
73
+ # end
74
+ #
75
+ def type?(number)
76
+ return 'bogus' if valid_test_mode_card_number?(number)
77
+
78
+ card_companies.reject { |c,p| c == 'maestro' }.each do |company, pattern|
79
+ return company.dup if number =~ pattern
80
+ end
81
+
82
+ return 'maestro' if number =~ card_companies['maestro']
83
+
84
+ return nil
85
+ end
86
+
87
+ def last_digits(number)
88
+ number.to_s.length <= 4 ? number : number.to_s.slice(-4..-1)
89
+ end
90
+
91
+ def mask(number)
92
+ "XXXX-XXXX-XXXX-#{last_digits(number)}"
93
+ end
94
+
95
+ # Checks to see if the calculated type matches the specified type
96
+ def matching_type?(number, type)
97
+ type?(number) == type
98
+ end
99
+
100
+ private
101
+
102
+ def valid_card_number_length?(number) #:nodoc:
103
+ number.to_s.length >= 12
104
+ end
105
+
106
+ def valid_test_mode_card_number?(number) #:nodoc:
107
+ ActiveMerchant::Billing::Base.test? &&
108
+ %w[1 2 3 success failure error].include?(number.to_s)
109
+ end
110
+
111
+ # Checks the validity of a card number by use of the the Luhn Algorithm.
112
+ # Please see http://en.wikipedia.org/wiki/Luhn_algorithm for details.
113
+ def valid_checksum?(number) #:nodoc:
114
+ sum = 0
115
+ for i in 0..number.length
116
+ weight = number[-1 * (i + 2), 1].to_i * (2 - (i % 2))
117
+ sum += (weight < 10) ? weight : weight - 9
118
+ end
119
+
120
+ (number[-1,1].to_i == (10 - sum % 10) % 10)
121
+ end
122
+ end
123
+ end
124
+ end
125
+ end