swiss-activemerchant 1.0.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/CHANGELOG +4033 -0
- data/CONTRIBUTORS +568 -0
- data/MIT-LICENSE +20 -0
- data/README.md +249 -0
- data/lib/active_merchant/billing/apple_pay_payment_token.rb +22 -0
- data/lib/active_merchant/billing/avs_result.rb +95 -0
- data/lib/active_merchant/billing/base.rb +48 -0
- data/lib/active_merchant/billing/check.rb +112 -0
- data/lib/active_merchant/billing/compatibility.rb +118 -0
- data/lib/active_merchant/billing/credit_card.rb +451 -0
- data/lib/active_merchant/billing/credit_card_formatting.rb +24 -0
- data/lib/active_merchant/billing/credit_card_methods.rb +512 -0
- data/lib/active_merchant/billing/cvv_result.rb +37 -0
- data/lib/active_merchant/billing/gateway.rb +332 -0
- data/lib/active_merchant/billing/gateways/adyen.rb +774 -0
- data/lib/active_merchant/billing/gateways/airwallex.rb +370 -0
- data/lib/active_merchant/billing/gateways/alelo.rb +256 -0
- data/lib/active_merchant/billing/gateways/allied_wallet.rb +205 -0
- data/lib/active_merchant/billing/gateways/authorize_net.rb +1125 -0
- data/lib/active_merchant/billing/gateways/authorize_net_arb.rb +424 -0
- data/lib/active_merchant/billing/gateways/authorize_net_cim.rb +977 -0
- data/lib/active_merchant/billing/gateways/axcessms.rb +243 -0
- data/lib/active_merchant/billing/gateways/balanced.rb +263 -0
- data/lib/active_merchant/billing/gateways/bambora_apac.rb +222 -0
- data/lib/active_merchant/billing/gateways/bank_frick.rb +225 -0
- data/lib/active_merchant/billing/gateways/banwire.rb +116 -0
- data/lib/active_merchant/billing/gateways/barclaycard_smartpay.rb +397 -0
- data/lib/active_merchant/billing/gateways/barclays_epdq_extra_plus.rb +15 -0
- data/lib/active_merchant/billing/gateways/be2bill.rb +131 -0
- data/lib/active_merchant/billing/gateways/beanstream/beanstream_core.rb +474 -0
- data/lib/active_merchant/billing/gateways/beanstream.rb +238 -0
- data/lib/active_merchant/billing/gateways/beanstream_interac.rb +57 -0
- data/lib/active_merchant/billing/gateways/blue_pay.rb +549 -0
- data/lib/active_merchant/billing/gateways/blue_snap.rb +644 -0
- data/lib/active_merchant/billing/gateways/bogus.rb +190 -0
- data/lib/active_merchant/billing/gateways/borgun.rb +272 -0
- data/lib/active_merchant/billing/gateways/bpoint.rb +277 -0
- data/lib/active_merchant/billing/gateways/braintree/braintree_common.rb +28 -0
- data/lib/active_merchant/billing/gateways/braintree/token_nonce.rb +113 -0
- data/lib/active_merchant/billing/gateways/braintree.rb +19 -0
- data/lib/active_merchant/billing/gateways/braintree_blue.rb +952 -0
- data/lib/active_merchant/billing/gateways/braintree_orange.rb +19 -0
- data/lib/active_merchant/billing/gateways/bridge_pay.rb +244 -0
- data/lib/active_merchant/billing/gateways/cams.rb +230 -0
- data/lib/active_merchant/billing/gateways/card_connect.rb +338 -0
- data/lib/active_merchant/billing/gateways/card_save.rb +21 -0
- data/lib/active_merchant/billing/gateways/card_stream.rb +394 -0
- data/lib/active_merchant/billing/gateways/cardknox.rb +327 -0
- data/lib/active_merchant/billing/gateways/cardprocess.rb +256 -0
- data/lib/active_merchant/billing/gateways/cashnet.rb +235 -0
- data/lib/active_merchant/billing/gateways/cc5.rb +198 -0
- data/lib/active_merchant/billing/gateways/cecabank.rb +249 -0
- data/lib/active_merchant/billing/gateways/cenpos.rb +328 -0
- data/lib/active_merchant/billing/gateways/checkout.rb +212 -0
- data/lib/active_merchant/billing/gateways/checkout_v2.rb +587 -0
- data/lib/active_merchant/billing/gateways/citrus_pay.rb +21 -0
- data/lib/active_merchant/billing/gateways/clearhaus.rb +219 -0
- data/lib/active_merchant/billing/gateways/commerce_hub.rb +366 -0
- data/lib/active_merchant/billing/gateways/commercegate.rb +142 -0
- data/lib/active_merchant/billing/gateways/conekta.rb +230 -0
- data/lib/active_merchant/billing/gateways/creditcall.rb +272 -0
- data/lib/active_merchant/billing/gateways/credorax.rb +526 -0
- data/lib/active_merchant/billing/gateways/ct_payment.rb +269 -0
- data/lib/active_merchant/billing/gateways/culqi.rb +279 -0
- data/lib/active_merchant/billing/gateways/cyber_source/cyber_source_common.rb +36 -0
- data/lib/active_merchant/billing/gateways/cyber_source.rb +1148 -0
- data/lib/active_merchant/billing/gateways/cyber_source_rest.rb +454 -0
- data/lib/active_merchant/billing/gateways/d_local.rb +343 -0
- data/lib/active_merchant/billing/gateways/data_cash.rb +302 -0
- data/lib/active_merchant/billing/gateways/decidir.rb +358 -0
- data/lib/active_merchant/billing/gateways/decidir_plus.rb +344 -0
- data/lib/active_merchant/billing/gateways/dibs.rb +199 -0
- data/lib/active_merchant/billing/gateways/digitzs.rb +295 -0
- data/lib/active_merchant/billing/gateways/ebanx.rb +346 -0
- data/lib/active_merchant/billing/gateways/efsnet.rb +215 -0
- data/lib/active_merchant/billing/gateways/elavon.rb +475 -0
- data/lib/active_merchant/billing/gateways/element.rb +406 -0
- data/lib/active_merchant/billing/gateways/epay.rb +296 -0
- data/lib/active_merchant/billing/gateways/evo_ca.rb +307 -0
- data/lib/active_merchant/billing/gateways/eway.rb +226 -0
- data/lib/active_merchant/billing/gateways/eway_managed.rb +289 -0
- data/lib/active_merchant/billing/gateways/eway_rapid.rb +578 -0
- data/lib/active_merchant/billing/gateways/exact.rb +219 -0
- data/lib/active_merchant/billing/gateways/ezic.rb +195 -0
- data/lib/active_merchant/billing/gateways/fat_zebra.rb +223 -0
- data/lib/active_merchant/billing/gateways/federated_canada.rb +158 -0
- data/lib/active_merchant/billing/gateways/finansbank.rb +22 -0
- data/lib/active_merchant/billing/gateways/first_giving.rb +143 -0
- data/lib/active_merchant/billing/gateways/first_pay.rb +182 -0
- data/lib/active_merchant/billing/gateways/firstdata_e4.rb +452 -0
- data/lib/active_merchant/billing/gateways/firstdata_e4_v27.rb +505 -0
- data/lib/active_merchant/billing/gateways/flo2cash.rb +215 -0
- data/lib/active_merchant/billing/gateways/flo2cash_simple.rb +20 -0
- data/lib/active_merchant/billing/gateways/fluidpay.rb +275 -0
- data/lib/active_merchant/billing/gateways/forte.rb +286 -0
- data/lib/active_merchant/billing/gateways/garanti.rb +256 -0
- data/lib/active_merchant/billing/gateways/global_collect.rb +580 -0
- data/lib/active_merchant/billing/gateways/global_transport.rb +193 -0
- data/lib/active_merchant/billing/gateways/hdfc.rb +205 -0
- data/lib/active_merchant/billing/gateways/hps.rb +472 -0
- data/lib/active_merchant/billing/gateways/iats_payments.rb +312 -0
- data/lib/active_merchant/billing/gateways/in_context_paypal_express.rb +15 -0
- data/lib/active_merchant/billing/gateways/inspire.rb +213 -0
- data/lib/active_merchant/billing/gateways/instapay.rb +159 -0
- data/lib/active_merchant/billing/gateways/ipg.rb +420 -0
- data/lib/active_merchant/billing/gateways/ipp.rb +176 -0
- data/lib/active_merchant/billing/gateways/iridium.rb +467 -0
- data/lib/active_merchant/billing/gateways/itransact.rb +448 -0
- data/lib/active_merchant/billing/gateways/iveri.rb +290 -0
- data/lib/active_merchant/billing/gateways/ixopay.rb +320 -0
- data/lib/active_merchant/billing/gateways/jetpay.rb +395 -0
- data/lib/active_merchant/billing/gateways/jetpay_v2.rb +432 -0
- data/lib/active_merchant/billing/gateways/klarna.rb +317 -0
- data/lib/active_merchant/billing/gateways/komoju.rb +115 -0
- data/lib/active_merchant/billing/gateways/kushki.rb +297 -0
- data/lib/active_merchant/billing/gateways/latitude19.rb +412 -0
- data/lib/active_merchant/billing/gateways/linkpoint.rb +448 -0
- data/lib/active_merchant/billing/gateways/litle.rb +643 -0
- data/lib/active_merchant/billing/gateways/mastercard.rb +286 -0
- data/lib/active_merchant/billing/gateways/maxipago.rb +220 -0
- data/lib/active_merchant/billing/gateways/mercado_pago.rb +348 -0
- data/lib/active_merchant/billing/gateways/merchant_e_solutions.rb +228 -0
- data/lib/active_merchant/billing/gateways/merchant_one.rb +110 -0
- data/lib/active_merchant/billing/gateways/merchant_partners.rb +245 -0
- data/lib/active_merchant/billing/gateways/merchant_ware.rb +313 -0
- data/lib/active_merchant/billing/gateways/merchant_ware_version_four.rb +284 -0
- data/lib/active_merchant/billing/gateways/merchant_warrior.rb +248 -0
- data/lib/active_merchant/billing/gateways/mercury.rb +352 -0
- data/lib/active_merchant/billing/gateways/metrics_global.rb +293 -0
- data/lib/active_merchant/billing/gateways/micropayment.rb +182 -0
- data/lib/active_merchant/billing/gateways/migs/migs_codes.rb +100 -0
- data/lib/active_merchant/billing/gateways/migs.rb +329 -0
- data/lib/active_merchant/billing/gateways/mit.rb +260 -0
- data/lib/active_merchant/billing/gateways/modern_payments.rb +37 -0
- data/lib/active_merchant/billing/gateways/modern_payments_cim.rb +215 -0
- data/lib/active_merchant/billing/gateways/moka.rb +290 -0
- data/lib/active_merchant/billing/gateways/monei.rb +424 -0
- data/lib/active_merchant/billing/gateways/moneris.rb +488 -0
- data/lib/active_merchant/billing/gateways/money_movers.rb +150 -0
- data/lib/active_merchant/billing/gateways/mundipagg.rb +366 -0
- data/lib/active_merchant/billing/gateways/nab_transact.rb +299 -0
- data/lib/active_merchant/billing/gateways/ncr_secure_pay.rb +163 -0
- data/lib/active_merchant/billing/gateways/net_registry.rb +198 -0
- data/lib/active_merchant/billing/gateways/netaxept.rb +180 -0
- data/lib/active_merchant/billing/gateways/netbanx.rb +376 -0
- data/lib/active_merchant/billing/gateways/netbilling.rb +229 -0
- data/lib/active_merchant/billing/gateways/netpay.rb +223 -0
- data/lib/active_merchant/billing/gateways/network_merchants.rb +238 -0
- data/lib/active_merchant/billing/gateways/nmi.rb +396 -0
- data/lib/active_merchant/billing/gateways/ogone.rb +509 -0
- data/lib/active_merchant/billing/gateways/omise.rb +323 -0
- data/lib/active_merchant/billing/gateways/openpay.rb +246 -0
- data/lib/active_merchant/billing/gateways/opp.rb +394 -0
- data/lib/active_merchant/billing/gateways/optimal_payment.rb +331 -0
- data/lib/active_merchant/billing/gateways/orbital/orbital_soft_descriptors.rb +45 -0
- data/lib/active_merchant/billing/gateways/orbital.rb +1267 -0
- data/lib/active_merchant/billing/gateways/pac_net_raven.rb +206 -0
- data/lib/active_merchant/billing/gateways/pagarme.rb +239 -0
- data/lib/active_merchant/billing/gateways/pago_facil.rb +120 -0
- data/lib/active_merchant/billing/gateways/pay_arc.rb +392 -0
- data/lib/active_merchant/billing/gateways/pay_conex.rb +245 -0
- data/lib/active_merchant/billing/gateways/pay_gate_xml.rb +277 -0
- data/lib/active_merchant/billing/gateways/pay_hub.rb +213 -0
- data/lib/active_merchant/billing/gateways/pay_junction.rb +390 -0
- data/lib/active_merchant/billing/gateways/pay_junction_v2.rb +206 -0
- data/lib/active_merchant/billing/gateways/pay_secure.rb +110 -0
- data/lib/active_merchant/billing/gateways/pay_trace.rb +450 -0
- data/lib/active_merchant/billing/gateways/paybox_direct.rb +224 -0
- data/lib/active_merchant/billing/gateways/payeezy.rb +513 -0
- data/lib/active_merchant/billing/gateways/payex.rb +409 -0
- data/lib/active_merchant/billing/gateways/payflow/payflow_common_api.rb +235 -0
- data/lib/active_merchant/billing/gateways/payflow/payflow_express_response.rb +42 -0
- data/lib/active_merchant/billing/gateways/payflow/payflow_response.rb +13 -0
- data/lib/active_merchant/billing/gateways/payflow.rb +473 -0
- data/lib/active_merchant/billing/gateways/payflow_express.rb +220 -0
- data/lib/active_merchant/billing/gateways/payflow_express_uk.rb +14 -0
- data/lib/active_merchant/billing/gateways/payflow_uk.rb +20 -0
- data/lib/active_merchant/billing/gateways/payment_express.rb +373 -0
- data/lib/active_merchant/billing/gateways/paymentez.rb +365 -0
- data/lib/active_merchant/billing/gateways/paymill.rb +369 -0
- data/lib/active_merchant/billing/gateways/paynetworx.rb +227 -0
- data/lib/active_merchant/billing/gateways/paypal/paypal_common_api.rb +718 -0
- data/lib/active_merchant/billing/gateways/paypal/paypal_express_response.rb +69 -0
- data/lib/active_merchant/billing/gateways/paypal/paypal_recurring_api.rb +262 -0
- data/lib/active_merchant/billing/gateways/paypal.rb +136 -0
- data/lib/active_merchant/billing/gateways/paypal_ca.rb +13 -0
- data/lib/active_merchant/billing/gateways/paypal_digital_goods.rb +44 -0
- data/lib/active_merchant/billing/gateways/paypal_express.rb +272 -0
- data/lib/active_merchant/billing/gateways/paypal_express_common.rb +30 -0
- data/lib/active_merchant/billing/gateways/paypal_standard.rb +281 -0
- data/lib/active_merchant/billing/gateways/paysafe.rb +420 -0
- data/lib/active_merchant/billing/gateways/payscout.rb +159 -0
- data/lib/active_merchant/billing/gateways/paystation.rb +204 -0
- data/lib/active_merchant/billing/gateways/payu_in.rb +249 -0
- data/lib/active_merchant/billing/gateways/payu_latam.rb +482 -0
- data/lib/active_merchant/billing/gateways/payway.rb +207 -0
- data/lib/active_merchant/billing/gateways/payway_dot_com.rb +253 -0
- data/lib/active_merchant/billing/gateways/pin.rb +273 -0
- data/lib/active_merchant/billing/gateways/pixxels.rb +263 -0
- data/lib/active_merchant/billing/gateways/plexo.rb +308 -0
- data/lib/active_merchant/billing/gateways/plugnpay.rb +283 -0
- data/lib/active_merchant/billing/gateways/priority.rb +392 -0
- data/lib/active_merchant/billing/gateways/pro_pay.rb +325 -0
- data/lib/active_merchant/billing/gateways/psigate.rb +227 -0
- data/lib/active_merchant/billing/gateways/psl_card.rb +295 -0
- data/lib/active_merchant/billing/gateways/qbms.rb +302 -0
- data/lib/active_merchant/billing/gateways/quantum.rb +274 -0
- data/lib/active_merchant/billing/gateways/quickbooks.rb +377 -0
- data/lib/active_merchant/billing/gateways/quickpay/quickpay_common.rb +184 -0
- data/lib/active_merchant/billing/gateways/quickpay/quickpay_v10.rb +297 -0
- data/lib/active_merchant/billing/gateways/quickpay/quickpay_v4to7.rb +226 -0
- data/lib/active_merchant/billing/gateways/quickpay.rb +24 -0
- data/lib/active_merchant/billing/gateways/qvalent.rb +305 -0
- data/lib/active_merchant/billing/gateways/rapyd.rb +319 -0
- data/lib/active_merchant/billing/gateways/reach.rb +277 -0
- data/lib/active_merchant/billing/gateways/realex.rb +400 -0
- data/lib/active_merchant/billing/gateways/redsys.rb +723 -0
- data/lib/active_merchant/billing/gateways/s5.rb +247 -0
- data/lib/active_merchant/billing/gateways/safe_charge.rb +298 -0
- data/lib/active_merchant/billing/gateways/sage.rb +446 -0
- data/lib/active_merchant/billing/gateways/sage_pay.rb +434 -0
- data/lib/active_merchant/billing/gateways/sallie_mae.rb +141 -0
- data/lib/active_merchant/billing/gateways/secure_net.rb +260 -0
- data/lib/active_merchant/billing/gateways/secure_pay.rb +191 -0
- data/lib/active_merchant/billing/gateways/secure_pay_au.rb +290 -0
- data/lib/active_merchant/billing/gateways/secure_pay_tech.rb +103 -0
- data/lib/active_merchant/billing/gateways/securion_pay.rb +305 -0
- data/lib/active_merchant/billing/gateways/shift4.rb +345 -0
- data/lib/active_merchant/billing/gateways/simetrik.rb +368 -0
- data/lib/active_merchant/billing/gateways/skip_jack.rb +450 -0
- data/lib/active_merchant/billing/gateways/smart_ps.rb +274 -0
- data/lib/active_merchant/billing/gateways/so_easy_pay.rb +194 -0
- data/lib/active_merchant/billing/gateways/spreedly_core.rb +312 -0
- data/lib/active_merchant/billing/gateways/stripe.rb +866 -0
- data/lib/active_merchant/billing/gateways/stripe_payment_intents.rb +602 -0
- data/lib/active_merchant/billing/gateways/swipe_checkout.rb +151 -0
- data/lib/active_merchant/billing/gateways/telr.rb +273 -0
- data/lib/active_merchant/billing/gateways/tns.rb +23 -0
- data/lib/active_merchant/billing/gateways/trans_first.rb +240 -0
- data/lib/active_merchant/billing/gateways/trans_first_transaction_express.rb +612 -0
- data/lib/active_merchant/billing/gateways/transact_pro.rb +222 -0
- data/lib/active_merchant/billing/gateways/transax.rb +21 -0
- data/lib/active_merchant/billing/gateways/transnational.rb +9 -0
- data/lib/active_merchant/billing/gateways/trexle.rb +221 -0
- data/lib/active_merchant/billing/gateways/trust_commerce.rb +500 -0
- data/lib/active_merchant/billing/gateways/usa_epay.rb +24 -0
- data/lib/active_merchant/billing/gateways/usa_epay_advanced.rb +1612 -0
- data/lib/active_merchant/billing/gateways/usa_epay_transaction.rb +367 -0
- data/lib/active_merchant/billing/gateways/vanco.rb +303 -0
- data/lib/active_merchant/billing/gateways/verifi.rb +224 -0
- data/lib/active_merchant/billing/gateways/viaklix.rb +171 -0
- data/lib/active_merchant/billing/gateways/visanet_peru.rb +250 -0
- data/lib/active_merchant/billing/gateways/vpos.rb +223 -0
- data/lib/active_merchant/billing/gateways/webpay.rb +97 -0
- data/lib/active_merchant/billing/gateways/wepay.rb +235 -0
- data/lib/active_merchant/billing/gateways/wirecard.rb +430 -0
- data/lib/active_merchant/billing/gateways/wompi.rb +197 -0
- data/lib/active_merchant/billing/gateways/world_net.rb +345 -0
- data/lib/active_merchant/billing/gateways/worldpay.rb +1050 -0
- data/lib/active_merchant/billing/gateways/worldpay_online_payments.rb +208 -0
- data/lib/active_merchant/billing/gateways/worldpay_us.rb +221 -0
- data/lib/active_merchant/billing/gateways.rb +14 -0
- data/lib/active_merchant/billing/model.rb +30 -0
- data/lib/active_merchant/billing/network_tokenization_credit_card.rb +39 -0
- data/lib/active_merchant/billing/payment_token.rb +21 -0
- data/lib/active_merchant/billing/rails.rb +3 -0
- data/lib/active_merchant/billing/response.rb +120 -0
- data/lib/active_merchant/billing/three_d_secure_eci_mapper.rb +27 -0
- data/lib/active_merchant/billing.rb +16 -0
- data/lib/active_merchant/connection.rb +194 -0
- data/lib/active_merchant/country.rb +338 -0
- data/lib/active_merchant/empty.rb +20 -0
- data/lib/active_merchant/errors.rb +38 -0
- data/lib/active_merchant/net_http_ssl_connection.rb +11 -0
- data/lib/active_merchant/network_connection_retries.rb +78 -0
- data/lib/active_merchant/post_data.rb +26 -0
- data/lib/active_merchant/posts_data.rb +92 -0
- data/lib/active_merchant/version.rb +3 -0
- data/lib/active_merchant.rb +63 -0
- data/lib/activemerchant.rb +1 -0
- data/lib/certs/cacert.pem +3214 -0
- data/lib/support/gateway_support.rb +69 -0
- data/lib/support/outbound_hosts.rb +28 -0
- data/lib/support/ssl_verify.rb +88 -0
- data/lib/support/ssl_version.rb +86 -0
- metadata +506 -0
@@ -0,0 +1,332 @@
|
|
1
|
+
require 'net/http'
|
2
|
+
require 'net/https'
|
3
|
+
require 'active_merchant/billing/response'
|
4
|
+
|
5
|
+
module ActiveMerchant #:nodoc:
|
6
|
+
module Billing #:nodoc:
|
7
|
+
#
|
8
|
+
# == Description
|
9
|
+
# The Gateway class is the base class for all ActiveMerchant gateway implementations.
|
10
|
+
#
|
11
|
+
# The standard list of gateway functions that most concrete gateway subclasses implement is:
|
12
|
+
#
|
13
|
+
# * <tt>purchase(money, credit_card, options = {})</tt>
|
14
|
+
# * <tt>authorize(money, credit_card, options = {})</tt>
|
15
|
+
# * <tt>capture(money, authorization, options = {})</tt>
|
16
|
+
# * <tt>void(identification, options = {})</tt>
|
17
|
+
# * <tt>refund(money, identification, options = {})</tt>
|
18
|
+
# * <tt>verify(credit_card, options = {})</tt>
|
19
|
+
#
|
20
|
+
# Some gateways also support features for storing credit cards:
|
21
|
+
#
|
22
|
+
# * <tt>store(credit_card, options = {})</tt>
|
23
|
+
# * <tt>unstore(identification, options = {})</tt>
|
24
|
+
#
|
25
|
+
# === Gateway Options
|
26
|
+
# The options hash consists of the following options:
|
27
|
+
#
|
28
|
+
# * <tt>:order_id</tt> - The order number
|
29
|
+
# * <tt>:ip</tt> - The IP address of the customer making the purchase
|
30
|
+
# * <tt>:customer</tt> - The name, customer number, or other information that identifies the customer
|
31
|
+
# * <tt>:invoice</tt> - The invoice number
|
32
|
+
# * <tt>:merchant</tt> - The name or description of the merchant offering the product
|
33
|
+
# * <tt>:description</tt> - A description of the transaction
|
34
|
+
# * <tt>:email</tt> - The email address of the customer
|
35
|
+
# * <tt>:currency</tt> - The currency of the transaction. Only important when you are using a currency that is not the default with a gateway that supports multiple currencies.
|
36
|
+
# * <tt>:billing_address</tt> - A hash containing the billing address of the customer.
|
37
|
+
# * <tt>:shipping_address</tt> - A hash containing the shipping address of the customer.
|
38
|
+
#
|
39
|
+
# The <tt>:billing_address</tt>, and <tt>:shipping_address</tt> hashes can have the following keys:
|
40
|
+
#
|
41
|
+
# * <tt>:name</tt> - The full name of the customer.
|
42
|
+
# * <tt>:company</tt> - The company name of the customer.
|
43
|
+
# * <tt>:address1</tt> - The primary street address of the customer.
|
44
|
+
# * <tt>:address2</tt> - Additional line of address information.
|
45
|
+
# * <tt>:city</tt> - The city of the customer.
|
46
|
+
# * <tt>:state</tt> - The state of the customer. The 2 digit code for US and Canadian addresses. The full name of the state or province for foreign addresses.
|
47
|
+
# * <tt>:country</tt> - The [ISO 3166-1-alpha-2 code](http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm) for the customer.
|
48
|
+
# * <tt>:zip</tt> - The zip or postal code of the customer.
|
49
|
+
# * <tt>:phone</tt> - The phone number of the customer.
|
50
|
+
#
|
51
|
+
# == Implementing new gateways
|
52
|
+
#
|
53
|
+
# See the {ActiveMerchant Guide to Contributing}[https://github.com/activemerchant/active_merchant/wiki/Contributing]
|
54
|
+
#
|
55
|
+
class Gateway
|
56
|
+
include PostsData
|
57
|
+
include CreditCardFormatting
|
58
|
+
|
59
|
+
CREDIT_DEPRECATION_MESSAGE = 'Support for using credit to refund existing transactions is deprecated and will be removed from a future release of ActiveMerchant. Please use the refund method instead.'
|
60
|
+
RECURRING_DEPRECATION_MESSAGE = 'Recurring functionality in ActiveMerchant is deprecated and will be removed in a future version. Please contact the ActiveMerchant maintainers if you have an interest in taking ownership of a separate gem that continues support for it.'
|
61
|
+
|
62
|
+
# == Standardized Error Codes
|
63
|
+
#
|
64
|
+
# :incorrect_number - Card number does not comply with ISO/IEC 7812 numbering standard
|
65
|
+
# :invalid_number - Card number was not matched by processor
|
66
|
+
# :invalid_expiry_date - Expiry date does not match correct formatting
|
67
|
+
# :invalid_cvc - Security codes does not match correct format (3-4 digits)
|
68
|
+
# :expired_card - Card number is expired
|
69
|
+
# :incorrect_cvc - Security code was not matched by the processor
|
70
|
+
# :incorrect_zip - Zip code is not in correct format
|
71
|
+
# :incorrect_address - Billing address info was not matched by the processor
|
72
|
+
# :incorrect_pin - Card PIN is incorrect
|
73
|
+
# :card_declined - Card number declined by processor
|
74
|
+
# :processing_error - Processor error
|
75
|
+
# :call_issuer - Transaction requires voice authentication, call issuer
|
76
|
+
# :pickup_card - Issuer requests that you pickup the card from merchant
|
77
|
+
# :test_mode_live_card - Card was declined. Request was in test mode, but used a non test card.
|
78
|
+
# :unsupported_feature - Transaction failed due to gateway or merchant
|
79
|
+
# configuration not supporting a feature used, such
|
80
|
+
# as network tokenization.
|
81
|
+
|
82
|
+
STANDARD_ERROR_CODE = {
|
83
|
+
incorrect_number: 'incorrect_number',
|
84
|
+
invalid_number: 'invalid_number',
|
85
|
+
invalid_expiry_date: 'invalid_expiry_date',
|
86
|
+
invalid_cvc: 'invalid_cvc',
|
87
|
+
expired_card: 'expired_card',
|
88
|
+
incorrect_cvc: 'incorrect_cvc',
|
89
|
+
incorrect_zip: 'incorrect_zip',
|
90
|
+
incorrect_address: 'incorrect_address',
|
91
|
+
incorrect_pin: 'incorrect_pin',
|
92
|
+
card_declined: 'card_declined',
|
93
|
+
processing_error: 'processing_error',
|
94
|
+
call_issuer: 'call_issuer',
|
95
|
+
pickup_card: 'pick_up_card',
|
96
|
+
config_error: 'config_error',
|
97
|
+
test_mode_live_card: 'test_mode_live_card',
|
98
|
+
unsupported_feature: 'unsupported_feature',
|
99
|
+
invalid_amount: 'invalid_amount'
|
100
|
+
}
|
101
|
+
|
102
|
+
cattr_reader :implementations
|
103
|
+
@@implementations = []
|
104
|
+
|
105
|
+
def self.inherited(subclass)
|
106
|
+
super
|
107
|
+
@@implementations << subclass
|
108
|
+
end
|
109
|
+
|
110
|
+
def generate_unique_id
|
111
|
+
SecureRandom.hex(16)
|
112
|
+
end
|
113
|
+
|
114
|
+
# The format of the amounts used by the gateway
|
115
|
+
# :dollars => '12.50'
|
116
|
+
# :cents => '1250'
|
117
|
+
class_attribute :money_format
|
118
|
+
self.money_format = :dollars
|
119
|
+
|
120
|
+
# The default currency for the transactions if no currency is provided
|
121
|
+
class_attribute :default_currency
|
122
|
+
|
123
|
+
# The supported card types for the gateway
|
124
|
+
class_attribute :supported_cardtypes
|
125
|
+
self.supported_cardtypes = []
|
126
|
+
|
127
|
+
# This default list of currencies without fractions are from https://en.wikipedia.org/wiki/ISO_4217
|
128
|
+
class_attribute :currencies_without_fractions, :currencies_with_three_decimal_places
|
129
|
+
self.currencies_without_fractions = %w(BIF BYR CLP CVE DJF GNF ISK JPY KMF KRW PYG RWF UGX UYI VND VUV XAF XOF XPF)
|
130
|
+
self.currencies_with_three_decimal_places = %w()
|
131
|
+
|
132
|
+
class_attribute :homepage_url
|
133
|
+
class_attribute :display_name
|
134
|
+
|
135
|
+
class_attribute :test_url, :live_url
|
136
|
+
|
137
|
+
class_attribute :abstract_class
|
138
|
+
|
139
|
+
self.abstract_class = false
|
140
|
+
|
141
|
+
# The application making the calls to the gateway
|
142
|
+
# Useful for things like the PayPal build notation (BN) id fields
|
143
|
+
class_attribute :application_id, instance_writer: false
|
144
|
+
self.application_id = nil
|
145
|
+
|
146
|
+
attr_reader :options
|
147
|
+
|
148
|
+
# Use this method to check if your gateway of interest supports a credit card of some type
|
149
|
+
def self.supports?(card_type)
|
150
|
+
supported_cardtypes.include?(card_type.to_sym)
|
151
|
+
end
|
152
|
+
|
153
|
+
def self.card_brand(source)
|
154
|
+
result = source.respond_to?(:brand) ? source.brand : source.type
|
155
|
+
result.to_s.downcase
|
156
|
+
end
|
157
|
+
|
158
|
+
def self.supported_countries=(country_codes)
|
159
|
+
country_codes.each do |country_code|
|
160
|
+
raise ActiveMerchant::InvalidCountryCodeError, "No country could be found for the country #{country_code}" unless ActiveMerchant::Country.find(country_code)
|
161
|
+
end
|
162
|
+
@supported_countries = country_codes.dup
|
163
|
+
end
|
164
|
+
|
165
|
+
def self.supported_countries
|
166
|
+
@supported_countries ||= (self.superclass.supported_countries || [])
|
167
|
+
end
|
168
|
+
|
169
|
+
def supported_countries
|
170
|
+
self.class.supported_countries
|
171
|
+
end
|
172
|
+
|
173
|
+
def card_brand(source)
|
174
|
+
self.class.card_brand(source)
|
175
|
+
end
|
176
|
+
|
177
|
+
# Initialize a new gateway.
|
178
|
+
#
|
179
|
+
# See the documentation for the gateway you will be using to make sure there are no other
|
180
|
+
# required options.
|
181
|
+
def initialize(options = {})
|
182
|
+
@options = options
|
183
|
+
end
|
184
|
+
|
185
|
+
# Are we running in test mode?
|
186
|
+
def test?
|
187
|
+
(@options.has_key?(:test) ? @options[:test] : Base.test?)
|
188
|
+
end
|
189
|
+
|
190
|
+
# Does this gateway know how to scrub sensitive information out of HTTP transcripts?
|
191
|
+
def supports_scrubbing?
|
192
|
+
false
|
193
|
+
end
|
194
|
+
|
195
|
+
def scrub(transcript)
|
196
|
+
raise 'This gateway does not support scrubbing.'
|
197
|
+
end
|
198
|
+
|
199
|
+
def supports_network_tokenization?
|
200
|
+
false
|
201
|
+
end
|
202
|
+
|
203
|
+
def add_fields_to_post_if_present(post, options, fields)
|
204
|
+
fields.each do |field|
|
205
|
+
add_field_to_post_if_present(post, options, field)
|
206
|
+
end
|
207
|
+
end
|
208
|
+
|
209
|
+
def add_field_to_post_if_present(post, options, field)
|
210
|
+
post[field] = options[field] if options[field]
|
211
|
+
end
|
212
|
+
|
213
|
+
protected # :nodoc: all
|
214
|
+
|
215
|
+
def normalize(field)
|
216
|
+
case field
|
217
|
+
when 'true' then true
|
218
|
+
when 'false' then false
|
219
|
+
when '' then nil
|
220
|
+
when 'null' then nil
|
221
|
+
else field
|
222
|
+
end
|
223
|
+
end
|
224
|
+
|
225
|
+
def user_agent
|
226
|
+
@@ua ||= JSON.dump({
|
227
|
+
bindings_version: ActiveMerchant::VERSION,
|
228
|
+
lang: 'ruby',
|
229
|
+
lang_version: "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})",
|
230
|
+
platform: RUBY_PLATFORM,
|
231
|
+
publisher: 'active_merchant'
|
232
|
+
})
|
233
|
+
end
|
234
|
+
|
235
|
+
def strip_invalid_xml_chars(xml)
|
236
|
+
begin
|
237
|
+
REXML::Document.new(xml)
|
238
|
+
rescue REXML::ParseException
|
239
|
+
xml = xml.gsub(/&(?!(?:[a-z]+|#[0-9]+|x[a-zA-Z0-9]+);)/, '&')
|
240
|
+
end
|
241
|
+
|
242
|
+
xml
|
243
|
+
end
|
244
|
+
|
245
|
+
private # :nodoc: all
|
246
|
+
|
247
|
+
def name
|
248
|
+
self.class.name.scan(/\:\:(\w+)Gateway/).flatten.first
|
249
|
+
end
|
250
|
+
|
251
|
+
def amount(money)
|
252
|
+
return nil if money.nil?
|
253
|
+
|
254
|
+
cents =
|
255
|
+
if money.respond_to?(:cents)
|
256
|
+
ActiveMerchant.deprecated 'Support for Money objects is deprecated and will be removed from a future release of ActiveMerchant. Please use an Integer value in cents'
|
257
|
+
money.cents
|
258
|
+
else
|
259
|
+
money
|
260
|
+
end
|
261
|
+
|
262
|
+
raise ArgumentError, 'money amount must be a positive Integer in cents.' if money.is_a?(String)
|
263
|
+
|
264
|
+
if self.money_format == :cents
|
265
|
+
cents.to_s
|
266
|
+
else
|
267
|
+
sprintf('%.2f', cents.to_f / 100)
|
268
|
+
end
|
269
|
+
end
|
270
|
+
|
271
|
+
def non_fractional_currency?(currency)
|
272
|
+
self.currencies_without_fractions.include?(currency.to_s)
|
273
|
+
end
|
274
|
+
|
275
|
+
def three_decimal_currency?(currency)
|
276
|
+
self.currencies_with_three_decimal_places.include?(currency.to_s)
|
277
|
+
end
|
278
|
+
|
279
|
+
def localized_amount(money, currency)
|
280
|
+
amount = amount(money)
|
281
|
+
|
282
|
+
return amount unless non_fractional_currency?(currency) || three_decimal_currency?(currency)
|
283
|
+
|
284
|
+
if non_fractional_currency?(currency)
|
285
|
+
if self.money_format == :cents
|
286
|
+
sprintf('%.0f', amount.to_f / 100)
|
287
|
+
else
|
288
|
+
amount.split('.').first
|
289
|
+
end
|
290
|
+
elsif three_decimal_currency?(currency)
|
291
|
+
if self.money_format == :cents
|
292
|
+
amount.to_s
|
293
|
+
else
|
294
|
+
sprintf('%.3f', (amount.to_f / 10))
|
295
|
+
end
|
296
|
+
end
|
297
|
+
end
|
298
|
+
|
299
|
+
def currency(money)
|
300
|
+
money.respond_to?(:currency) ? money.currency : self.default_currency
|
301
|
+
end
|
302
|
+
|
303
|
+
def truncate(value, max_size)
|
304
|
+
return nil unless value
|
305
|
+
|
306
|
+
value.to_s[0, max_size]
|
307
|
+
end
|
308
|
+
|
309
|
+
def split_names(full_name)
|
310
|
+
names = (full_name || '').split
|
311
|
+
return [nil, nil] if names.size == 0
|
312
|
+
|
313
|
+
last_name = names.pop
|
314
|
+
first_name = names.join(' ')
|
315
|
+
[first_name, last_name]
|
316
|
+
end
|
317
|
+
|
318
|
+
def requires!(hash, *params)
|
319
|
+
params.each do |param|
|
320
|
+
if param.is_a?(Array)
|
321
|
+
raise ArgumentError.new("Missing required parameter: #{param.first}") unless hash.has_key?(param.first)
|
322
|
+
|
323
|
+
valid_options = param[1..-1]
|
324
|
+
raise ArgumentError.new("Parameter: #{param.first} must be one of #{valid_options.to_sentence(words_connector: 'or')}") unless valid_options.include?(hash[param.first])
|
325
|
+
else
|
326
|
+
raise ArgumentError.new("Missing required parameter: #{param}") unless hash.has_key?(param)
|
327
|
+
end
|
328
|
+
end
|
329
|
+
end
|
330
|
+
end
|
331
|
+
end
|
332
|
+
end
|