activemerchant 1.38.0 → 1.78.0

data/lib/active_merchant/billing/gateways/be2bill.rb

@@ -0,0 +1,131 @@
+require "digest/sha2"
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class Be2billGateway < Gateway
+      self.test_url = 'https://secure-test.be2bill.com/front/service/rest/process.php'
+      self.live_url = 'https://secure-magenta1.be2bill.com/front/service/rest/process.php'
+
+      self.display_name = 'Be2Bill'
+      self.homepage_url = 'http://www.be2bill.com/'
+      self.supported_countries = ['FR']
+      self.supported_cardtypes = [:visa, :master, :american_express]
+      self.default_currency = 'EUR'
+      self.money_format = :cents
+
+      # These options are mandatory on be2bill (cf. tests) :
+      #
+      # options = { :order_id    => order.id,
+      #             :customer_id => user.id,
+      #             :description => "Some description",
+      #             :referrer    => request.env['HTTP_REFERER'],
+      #             :user_agent  => request.env['HTTP_USER_AGENT'],
+      #             :ip          => request.remote_ip,
+      #             :email       => user.email }
+
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        super
+      end
+
+      def authorize(money, creditcard, options = {})
+        post = {}
+        add_invoice(post, options)
+        add_creditcard(post, creditcard)
+        add_customer_data(post, options)
+
+        commit('authorization', money, post)
+      end
+
+      def purchase(money, creditcard, options = {})
+        post = {}
+        add_invoice(post, options)
+        add_creditcard(post, creditcard)
+        add_customer_data(post, options)
+
+        commit('payment', money, post)
+      end
+
+      def capture(money, authorization, options = {})
+        post = {}
+        add_invoice(post, options)
+        post[:TRANSACTIONID] = authorization
+
+        commit('capture', money, post)
+      end
+
+      private
+
+      def add_customer_data(post, options)
+        post[:CLIENTREFERRER]  = options[:referrer]
+        post[:CLIENTUSERAGENT] = options[:user_agent]
+        post[:CLIENTIP]        = options[:ip]
+        post[:CLIENTEMAIL]     = options[:email]
+        post[:CLIENTIDENT]     = options[:customer_id]
+      end
+
+      def add_invoice(post, options)
+        post[:ORDERID]     = options[:order_id]
+        post[:DESCRIPTION] = options[:description]
+      end
+
+      def add_creditcard(post, creditcard)
+        post[:CARDFULLNAME]     = creditcard ? creditcard.name : ''
+        post[:CARDCODE]         = creditcard ? creditcard.number : ''
+        post[:CARDVALIDITYDATE] = creditcard ? "%02d-%02s" % [creditcard.month, creditcard.year.to_s[-2..-1]] : ''
+        post[:CARDCVV]          = creditcard ? creditcard.verification_value : ''
+      end
+
+      def parse(response)
+        ActiveSupport::JSON.decode(response)
+      end
+
+      def commit(action, money, parameters)
+        parameters[:IDENTIFIER] = @options[:login]
+        parameters[:AMOUNT]     = amount(money)
+        parameters[:VERSION]    = '2.0'
+
+        url = (test? ? self.test_url : self.live_url)
+        response = parse(ssl_post(url, post_data(action, parameters)))
+
+        Response.new(
+          successful?(response),
+          message_from(response),
+          response,
+          :authorization => response['TRANSACTIONID'],
+          :test          => test?
+        )
+      end
+
+      def successful?(response)
+        %w(0000 0001).include?(response['EXECCODE'])
+      end
+
+      def message_from(response)
+        if successful?(response)
+          "Approved : #{response['MESSAGE']}"
+        else
+          "Declined (#{response['EXECCODE']} - #{response['MESSAGE']}"
+        end
+      end
+
+      def post_data(action, parameters = {})
+        {
+          :method => action,
+          :params => parameters.merge(HASH: signature(parameters, action))
+        }.to_query
+      end
+
+      def signature(parameters, action)
+        parameters[:OPERATIONTYPE] = action unless parameters[:OPERATIONTYPE]
+
+        signature = @options[:password]
+        parameters.sort.each do |key, value|
+          signature += ("#{key.upcase}=#{value}" + @options[:password])
+        end
+
+        Digest::SHA256.hexdigest(signature)
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/gateways/beanstream/beanstream_core.rb

@@ -1,6 +1,8 @@
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
     module BeanstreamCore
+      include Empty
+
       RECURRING_URL = 'https://www.beanstream.com/scripts/recurring_billing.asp'
       SECURE_PROFILE_URL = 'https://www.beanstream.com/scripts/payment_profile.asp'
 
@@ -59,18 +61,84 @@ module ActiveMerchant #:nodoc:
         :cancel => 'C'
       }
 
+      STATES = {
+        "ALBERTA" => "AB",
+        "BRITISH COLUMBIA" => "BC",
+        "MANITOBA" => "MB",
+        "NEW BRUNSWICK" => "NB",
+        "NEWFOUNDLAND AND LABRADOR" => "NL",
+        "NOVA SCOTIA" => "NS",
+        "ONTARIO" => "ON",
+        "PRINCE EDWARD ISLAND" => "PE",
+        "QUEBEC" => "QC",
+        "SASKATCHEWAN" => "SK",
+        "NORTHWEST TERRITORIES" => "NT",
+        "NUNAVUT" => "NU",
+        "YUKON" => "YT",
+        "ALABAMA" => "AL",
+        "ALASKA" => "AK",
+        "ARIZONA" => "AZ",
+        "ARKANSAS" => "AR",
+        "CALIFORNIA" => "CA",
+        "COLORADO" => "CO",
+        "CONNECTICUT" => "CT",
+        "DELAWARE" => "DE",
+        "FLORIDA" => "FL",
+        "GEORGIA" => "GA",
+        "HAWAII" => "HI",
+        "IDAHO" => "ID",
+        "ILLINOIS" => "IL",
+        "INDIANA" => "IN",
+        "IOWA" => "IA",
+        "KANSAS" => "KS",
+        "KENTUCKY" => "KY",
+        "LOUISIANA" => "LA",
+        "MAINE" => "ME",
+        "MARYLAND" => "MD",
+        "MASSACHUSETTS" => "MA",
+        "MICHIGAN" => "MI",
+        "MINNESOTA" => "MN",
+        "MISSISSIPPI" => "MS",
+        "MISSOURI" => "MO",
+        "MONTANA" => "MT",
+        "NEBRASKA" => "NE",
+        "NEVADA" => "NV",
+        "NEW HAMPSHIRE" => "NH",
+        "NEW JERSEY" => "NJ",
+        "NEW MEXICO" => "NM",
+        "NEW YORK" => "NY",
+        "NORTH CAROLINA" => "NC",
+        "NORTH DAKOTA" => "ND",
+        "OHIO" => "OH",
+        "OKLAHOMA" => "OK",
+        "OREGON" => "OR",
+        "PENNSYLVANIA" => "PA",
+        "RHODE ISLAND" => "RI",
+        "SOUTH CAROLINA" => "SC",
+        "SOUTH DAKOTA" => "SD",
+        "TENNESSEE" => "TN",
+        "TEXAS" => "TX",
+        "UTAH" => "UT",
+        "VERMONT" => "VT",
+        "VIRGINIA" => "VA",
+        "WASHINGTON" => "WA",
+        "WEST VIRGINIA" => "WV",
+        "WISCONSIN" => "WI",
+        "WYOMING" => "WY"
+      }
+
       def self.included(base)
         base.default_currency = 'CAD'
 
         # The countries the gateway supports merchants from as 2 digit ISO country codes
-        base.supported_countries = ['CA']
+        base.supported_countries = ['CA', 'US']
 
         # The card types supported by the payment gateway
         base.supported_cardtypes = [:visa, :master, :american_express, :discover, :diners_club, :jcb]
 
         # The homepage URL of the gateway
         base.homepage_url = 'http://www.beanstream.com/'
-        base.live_url = 'https://www.beanstream.com/scripts/process_transaction.asp'
+        base.live_url = 'https://api.na.bambora.com/scripts/process_transaction.asp'
 
         # The name of the gateway
         base.display_name = 'Beanstream.com'
@@ -87,18 +155,19 @@ module ActiveMerchant #:nodoc:
       end
 
       def capture(money, authorization, options = {})
-        reference, amount, type = split_auth(authorization)
+        reference, _, _ = split_auth(authorization)
 
         post = {}
         add_amount(post, money)
         add_reference(post, reference)
         add_transaction_type(post, :capture)
+        add_recurring_payment(post, options)
         commit(post)
       end
 
       def refund(money, source, options = {})
         post = {}
-        reference, amount, type = split_auth(source)
+        reference, _, type = split_auth(source)
         add_reference(post, reference)
         add_transaction_type(post, refund_action(type))
         add_amount(post, money)
@@ -106,11 +175,12 @@ module ActiveMerchant #:nodoc:
       end
 
       def credit(money, source, options = {})
-        deprecated Gateway::CREDIT_DEPRECATION_MESSAGE
+        ActiveMerchant.deprecated Gateway::CREDIT_DEPRECATION_MESSAGE
         refund(money, source, options)
       end
 
       private
+
       def purchase_action(source)
         if source.is_a?(Check)
           :check_purchase
@@ -120,7 +190,7 @@ module ActiveMerchant #:nodoc:
       end
 
       def add_customer_ip(post, options)
-        post[:customerIP] = options[:ip] if options[:ip]
+        post[:customerIp] = options[:ip] if options[:ip]
       end
 
       def void_action(original_transaction_type)
@@ -152,27 +222,29 @@ module ActiveMerchant #:nodoc:
       end
 
       def add_address(post, options)
+        post[:ordEmailAddress]  = options[:email] if options[:email]
+        post[:shipEmailAddress] = options[:shipping_email] || options[:email] if options[:email]
+
         prepare_address_for_non_american_countries(options)
 
         if billing_address = options[:billing_address] || options[:address]
           post[:ordName]          = billing_address[:name]
-          post[:ordEmailAddress]  = options[:email]
           post[:ordPhoneNumber]   = billing_address[:phone]
           post[:ordAddress1]      = billing_address[:address1]
           post[:ordAddress2]      = billing_address[:address2]
           post[:ordCity]          = billing_address[:city]
-          post[:ordProvince]      = billing_address[:state]
+          post[:ordProvince]      = state_for(billing_address)
           post[:ordPostalCode]    = billing_address[:zip]
           post[:ordCountry]       = billing_address[:country]
         end
+
         if shipping_address = options[:shipping_address]
           post[:shipName]         = shipping_address[:name]
-          post[:shipEmailAddress] = options[:email]
           post[:shipPhoneNumber]  = shipping_address[:phone]
           post[:shipAddress1]     = shipping_address[:address1]
           post[:shipAddress2]     = shipping_address[:address2]
           post[:shipCity]         = shipping_address[:city]
-          post[:shipProvince]     = shipping_address[:state]
+          post[:shipProvince]     = state_for(shipping_address)
           post[:shipPostalCode]   = shipping_address[:zip]
           post[:shipCountry]      = shipping_address[:country]
           post[:shippingMethod]   = shipping_address[:shipping_method]
@@ -180,8 +252,13 @@ module ActiveMerchant #:nodoc:
         end
       end
 
+      def state_for(address)
+        STATES[address[:state].upcase] || address[:state] if address[:state]
+      end
+
       def prepare_address_for_non_american_countries(options)
         [ options[:billing_address], options[:shipping_address] ].compact.each do |address|
+          next if empty?(address[:country])
           unless ['US', 'CA'].include?(address[:country])
             address[:state] = '--'
             address[:zip]   = '000000' unless address[:zip]
@@ -189,6 +266,10 @@ module ActiveMerchant #:nodoc:
         end
       end
 
+      def add_recurring_payment(post, options)
+        post[:recurringPayment] = true if options[:recurring].to_s == 'true'
+      end
+
       def add_invoice(post, options)
         post[:trnOrderNumber]   = options[:order_id]
         post[:trnComments]      = options[:description]
@@ -206,6 +287,11 @@ module ActiveMerchant #:nodoc:
           post[:trnExpMonth] = format(credit_card.month, :two_digits)
           post[:trnExpYear] = format(credit_card.year, :two_digits)
           post[:trnCardCvd] = credit_card.verification_value
+          if credit_card.is_a?(NetworkTokenizationCreditCard)
+            post[:"3DSecureXID"] = credit_card.transaction_id
+            post[:"3DSecureECI"] = credit_card.eci
+            post[:"3DSecureCAVV"] = credit_card.payment_cryptogram
+          end
         end
       end
 
@@ -351,10 +437,6 @@ module ActiveMerchant #:nodoc:
         response[:message]
       end
 
-      def success?(response)
-        response[:responseType] == 'R' || response[:trnApproved] == '1' || response[:responseCode] == '1'
-      end
-
       def recurring_success?(response)
         response[:code] == '1'
       end
@@ -390,4 +472,3 @@ module ActiveMerchant #:nodoc:
     end
   end
 end
-

data/lib/active_merchant/billing/gateways/beanstream.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/beanstream/beanstream_core'
+require 'active_merchant/billing/gateways/beanstream/beanstream_core'
 
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
@@ -16,7 +16,10 @@ module ActiveMerchant #:nodoc:
     # BeanStream supports payment profiles (vaults). This allows you to store cc information with BeanStream and process subsequent transactions with a customer id.
     # Secure Payment Profiles must be enabled on your account (must be done over the phone).
     # Your API Access Passcode must be set in Administration => account settings => order settings.
-    # To learn more about storing credit cards with the Beanstream gateway, please read the BEAN_Payment_Profiles.pdf (I had to phone BeanStream to request it.)
+    # To learn more about storing credit cards with the Beanstream gateway, documentation can be found at http://developer.beanstream.com/documentation/classic-apis
+    #
+    # To store a credit card using Beanstream's Legato Javascript Library (http://developer.beanstream.com/documentation/legato) you must pass the singleUseToken in
+    # the store method's option parameter. Example: @gateway.store("gt6-0c78c25b-3637-4ba0-90e2-26105287f198")
     #
     # == Notes
     # * Adding of order products information is not implemented.
@@ -72,6 +75,7 @@ module ActiveMerchant #:nodoc:
         add_address(post, options)
         add_transaction_type(post, :authorization)
         add_customer_ip(post, options)
+        add_recurring_payment(post, options)
         commit(post)
       end
 
@@ -83,6 +87,7 @@ module ActiveMerchant #:nodoc:
         add_address(post, options)
         add_transaction_type(post, purchase_action(source))
         add_customer_ip(post, options)
+        add_recurring_payment(post, options)
         commit(post)
       end
 
@@ -96,7 +101,20 @@ module ActiveMerchant #:nodoc:
         commit(post)
       end
 
+      def verify(source, options={})
+        MultiResponse.run(:use_first_response) do |r|
+          r.process { authorize(100, source, options) }
+          r.process(:ignore_result) { void(r.authorization, options) }
+        end
+      end
+
+      def success?(response)
+        response[:trnApproved] == '1' || response[:responseCode] == '1'
+      end
+
       def recurring(money, source, options = {})
+        ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE
+
         post = {}
         add_amount(post, money)
         add_invoice(post, options)
@@ -108,6 +126,8 @@ module ActiveMerchant #:nodoc:
       end
 
       def update_recurring(amount, source, options = {})
+        ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE
+
         post = {}
         add_recurring_amount(post, amount)
         add_recurring_invoice(post, options)
@@ -119,6 +139,8 @@ module ActiveMerchant #:nodoc:
       end
 
       def cancel_recurring(options = {})
+        ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE
+
         post = {}
         add_recurring_operation_type(post, :cancel)
         add_recurring_service(post, options)
@@ -131,15 +153,21 @@ module ActiveMerchant #:nodoc:
 
       # To match the other stored-value gateways, like TrustCommerce,
       # store and unstore need to be defined
-      def store(credit_card, options = {})
+      def store(payment_method, options = {})
         post = {}
         add_address(post, options)
-        add_credit_card(post, credit_card)
-        add_secure_profile_variables(post,options)
+
+        if payment_method.respond_to?(:number)
+          add_credit_card(post, payment_method)
+        else
+          post[:singleUseToken] = payment_method
+        end
+        add_secure_profile_variables(post, options)
+
         commit(post, true)
       end
 
-      #can't actually delete a secure profile with the supplicaed API. This function sets the status of the profile to closed (C).
+      #can't actually delete a secure profile with the supplicated API. This function sets the status of the profile to closed (C).
       #Closed profiles will have to removed manually.
       def delete(vault_id)
         update(vault_id, false, {:status => "C"})
@@ -150,15 +178,31 @@ module ActiveMerchant #:nodoc:
       # Update the values (such as CC expiration) stored at
       # the gateway.  The CC number must be supplied in the
       # CreditCard object.
-      def update(vault_id, credit_card, options = {})
+      def update(vault_id, payment_method, options = {})
         post = {}
         add_address(post, options)
-        add_credit_card(post, credit_card)
+        if payment_method.respond_to?(:number)
+          add_credit_card(post, payment_method)
+        else
+          post[:singleUseToken] = payment_method
+        end
         options.merge!({:vault_id => vault_id, :operation => secure_profile_action(:modify)})
         add_secure_profile_variables(post,options)
         commit(post, true)
       end
 
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r((Authorization: Basic )\w+), '\1[FILTERED]').
+          gsub(/(&?password=)[^&\s]*(&?)/, '\1[FILTERED]\2').
+          gsub(/(&?trnCardCvd=)\d*(&?)/, '\1[FILTERED]\2').
+          gsub(/(&?trnCardNumber=)\d*(&?)/, '\1[FILTERED]\2')
+      end
+
       private
       def build_response(*args)
         Response.new(*args)
@@ -166,4 +210,3 @@ module ActiveMerchant #:nodoc:
     end
   end
 end
-

data/lib/active_merchant/billing/gateways/beanstream_interac.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/beanstream/beanstream_core'
+require 'active_merchant/billing/gateways/beanstream/beanstream_core'
 
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
@@ -7,21 +7,21 @@ module ActiveMerchant #:nodoc:
         params['pageContents']
       end
     end
-    
+
     class BeanstreamInteracGateway < Gateway
       include BeanstreamCore
 
       # Confirm a transaction posted back from the bank to Beanstream.
       # Confirming a transaction does not require any credentials,
       # and in an application with many merchants sharing a funded
-      # URL the application may not yet know which merchant the 
+      # URL the application may not yet know which merchant the
       # post back is for until the response of the confirmation is
       # received, which contains the order number.
       def self.confirm(transaction)
         gateway = new(:login => '')
         gateway.confirm(transaction)
       end
-      
+
       def purchase(money, options = {})
         post = {}
         add_amount(post, money)
@@ -31,20 +31,24 @@ module ActiveMerchant #:nodoc:
         add_transaction_type(post, :purchase)
         commit(post)
       end
-      
+
+      def success?(response)
+        response[:responseType] == 'R' || response[:trnApproved] == '1' || response[:responseCode] == '1'
+      end
+
       # Confirm a transaction posted back from the bank to Beanstream.
       def confirm(transaction)
         post(transaction)
       end
-      
+
       private
-      
+
       def add_interac_details(post, options)
         address = options[:billing_address] || options[:address] || {}
         post[:trnCardOwner] = address[:name]
         post[:paymentMethod] = 'IO'
       end
-      
+
       def build_response(*args)
         BeanstreamInteracResponse.new(*args)
       end