activemerchant 1.26.0 → 1.27.0

data/lib/active_merchant/billing/integrations/action_view_helper.rb

@@ -39,16 +39,17 @@ module ActiveMerchant #:nodoc:
         #    <% service.cancel_return_url 'http://mystore.com' %>
         #  <% end %>
         #
-        def payment_service_for(order, account, options = {}, &proc)          
+        def payment_service_for(order, account, options = {}, &proc)
           raise ArgumentError, "Missing block" unless block_given?
 
           integration_module = ActiveMerchant::Billing::Integrations.const_get(options.delete(:service).to_s.camelize)
-
-          result = []
-          result << form_tag(integration_module.service_url, options.delete(:html) || {})
-          
           service_class = integration_module.const_get('Helper')
+
+          form_options = options.delete(:html) || {}
           service = service_class.new(order, account, options)
+          form_options[:method] = service.form_method
+          result = []
+          result << form_tag(integration_module.service_url, form_options)
 
           result << capture(service, &proc)
 

data/lib/active_merchant/billing/integrations/first_data.rb

@@ -0,0 +1,38 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module FirstData
+        autoload :Helper, 'active_merchant/billing/integrations/first_data/helper.rb'
+        autoload :Notification, 'active_merchant/billing/integrations/first_data/notification.rb'
+
+        # Overwrite this if you want to change the ANS test url
+        mattr_accessor :test_url
+        self.test_url = 'https://demo.globalgatewaye4.firstdata.com/payment'
+
+        # Overwrite this if you want to change the ANS production url
+        mattr_accessor :production_url
+        self.production_url = 'https://checkout.globalgatewaye4.firstdata.com/payment'
+
+        def self.service_url
+          mode = ActiveMerchant::Billing::Base.integration_mode
+          case mode
+          when :production
+            self.production_url
+          when :test
+            self.test_url
+          else
+            raise StandardError, "Integration mode set to an invalid value: #{mode}"
+          end
+        end
+
+        def self.notification(post)
+          Notification.new(post)
+        end
+
+        def self.return(query_string)
+          Return.new(query_string)
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/first_data/helper.rb

@@ -0,0 +1,63 @@
+require 'active_support/core_ext/float/rounding.rb' # Float#round(precision)
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module FirstData
+        # First Data payment pages emulates the Authorize.Net SIM API. See
+        # ActiveMerchant::Billing::Integrations::AuthorizeNetSim::Helper for
+        # more details.
+        #
+        # An example. Note the username as a parameter and transaction key you
+        # will want to use later.
+        #
+        #  payment_service_for('order_id', 'first_data_payment_page_id', :service => :first_data,  :amount => 157.0) do |service|
+        #
+        #    # You must call setup_hash and invoice
+        #
+        #    service.setup_hash :transaction_key => '8CP6zJ7uD875J6tY',
+        #        :order_timestamp => 1206836763
+        #    service.customer_id 8
+        #    service.customer :first_name => 'g',
+        #                       :last_name => 'g',
+        #                       :email => 'g@g.com',
+        #                       :phone => '3'
+        #   service.billing_address :zip => 'g',
+        #                   :country => 'United States of America',
+        #                   :address => 'g'
+        #
+        #   service.ship_to_address :first_name => 'g',
+        #                            :last_name => 'g',
+        #                            :city => '',
+        #                            :address => 'g',
+        #                            :address2 => '',
+        #                            :state => address.state,
+        #                            :country => 'United States of America',
+        #                            :zip => 'g'
+        #
+        #   service.invoice "516428355" # your invoice number
+        #   # The end-user is presented with the HTML produced by the notify_url
+        #   # (using the First Data Receipt Link feature).
+        #   service.return_url "http://mysite/first_data_receipt_generator_page"
+        #   service.payment_header 'My store name'
+        #   service.add_line_item :name => 'item name', :quantity => 1, :unit_price => 0
+        #   service.test_request 'true' # only if it's just a test
+        #   service.shipping '25.0'
+        #   # Tell it to display a "0" line item for shipping, with the price in
+        #   # the name, otherwise it isn't shown at all, leaving the end user to
+        #   # wonder why the total is different than the sum of the line items.
+        #   service.add_shipping_as_line_item
+        #   server.add_tax_as_line_item # same with tax
+        #   # See the helper.rb file for various custom fields
+        # end
+        class Helper < ActiveMerchant::Billing::Integrations::AuthorizeNetSim::Helper
+          # Configure notify_url to use the "Relay Response" feature
+          mapping :notify_url, 'x_relay_url'
+
+          # Configure return_url to use the "Receipt Link" feature
+          mapping :return_url, 'x_receipt_link_url'
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/first_data/notification.rb

@@ -0,0 +1,56 @@
+require 'net/http'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      # First Data payment pages emulates the Authorize.Net SIM API. See
+      # ActiveMerchant::Billing::Integrations::FirstData::Notification for
+      # more details.
+      #
+      # # Example:
+      # parser = FirstData::Notification.new(request.raw_post)
+      # passed = parser.complete?
+      #
+      # order = Order.find_by_order_number(parser.invoice_num)
+      #
+      # unless order
+      #   @message = 'Error--unable to find your transaction! Please contact us directly.'
+      #   return render :partial => 'first_data_payment_response'
+      # end
+      #
+      # if order.total != parser.gross.to_f
+      #   logger.error "First Data said they paid for #{parser.gross} and it should have been #{order.total}!"
+      #   passed = false
+      # end
+      #
+      # # Theoretically, First Data will *never* pass us the same transaction
+      # # ID twice, but we can double check that... by using
+      # # parser.transaction_id, and checking against previous orders' transaction
+      # # id's (which you can save when the order is completed)....
+      # unless parser.acknowledge FIRST_DATA_TRANSACTION_KEY, FIRST_DATA_RESPONSE_KEY
+      #  passed = false
+      #  logger.error "ALERT POSSIBLE FRAUD ATTEMPT"
+      # end
+      #
+      # unless parser.cavv_matches? and parser.avs_code_matches?
+      #   logger.error 'Warning--non matching CC!' + params.inspect
+      #   # Could fail them here, as well (recommended)...
+      # end
+      #
+      # if passed
+      #  # Set up your session, and render something that will redirect them to
+      #  # your site, most likely.
+      # else
+      #  # Render failure or redirect them to your site where you will render failure
+      # end
+
+      module FirstData
+        class Notification < ActiveMerchant::Billing::Integrations::AuthorizeNetSim::Notification
+          def acknowledge(response_key, payment_page_id)
+            Digest::MD5.hexdigest(response_key + payment_page_id + params['x_trans_id'] + sprintf('%.2f', gross)) == params['x_MD5_Hash'].downcase
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/helper.rb

@@ -71,6 +71,10 @@ module ActiveMerchant #:nodoc:
           @test_mode ||= ActiveMerchant::Billing::Base.integration_mode == :test || @test
         end
 
+        def form_method
+          "POST"
+        end
+
         private
         
         def add_address(key, params)

data/lib/active_merchant/billing/integrations/maksuturva.rb

@@ -0,0 +1,86 @@
+require File.dirname(__FILE__) + '/maksuturva/helper.rb'
+require File.dirname(__FILE__) + '/maksuturva/notification.rb'
+
+# USAGE:
+#
+# First define Maksuturva seller id and authcode in an initializer:
+#
+#   MAKSUTURVA_SELLERID = "testikauppias"
+#   MAKSUTURVA_AUTHCODE = "11223344556677889900"
+#
+# Then in view do something like this (use dynamic values for your app)
+#
+#   <% payment_service_for 2, MAKSUTURVA_SELLERID,
+#           :amount => "200,00", :currency => 'EUR', :credential2 => MAKSUTURVA_AUTHCODE,
+#           :service => :maksuturva do |service|
+#       service.pmt_reference = "134662"
+#       service.pmt_duedate = "24.06.2012"
+#       service.customer :phone => "0405051909",
+#           :email => "antti@example.com"
+#       service.billing_address :city => "Helsinki",
+#           :address1 => "Lorem street",
+#           :state => "-",
+#           :country => 'Finland',
+#           :zip => "00530"
+#       service.pmt_orderid = "2"
+#       service.pmt_buyername = "Antti Akonniemi"
+#       service.pmt_deliveryname = "Antti Akonniemi"
+#       service.pmt_deliveryaddress = "Köydenpunojankatu 13"
+#       service.pmt_deliverypostalcode = "00180"
+#       service.pmt_deliverycity = "Helsinki"
+#       service.pmt_deliverycountry = "FI"
+#       service.pmt_rows = 1
+#       service.pmt_row_name1 = "testi"
+#       service.pmt_row_desc1 = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
+#       service.pmt_row_articlenr1 = "1"
+#       service.pmt_row_quantity1 = "1"
+#       service.pmt_row_deliverydate1 = "26.6.2012"
+#       service.pmt_row_price_gross1 = "200,00"
+#       service.pmt_row_vat1= "23,00"
+#       service.pmt_row_discountpercentage1 = "0,00"
+#       service.pmt_row_type1 = "1"
+#       service.pmt_charset = "UTF-8"
+#       service.pmt_charsethttp = "UTF-8"
+#
+#       service.return_url "http://localhost:3000/process"
+#       service.cancel_return_url "http://example.com"
+#       service.pmt_errorreturn "http://example.com"
+#
+#       service.pmt_delayedpayreturn "http://example.com"
+#       service.pmt_escrow "N"
+#       service.pmt_escrowchangeallowed "N"
+#       service.pmt_sellercosts "0,00"
+#       service.pmt_keygeneration "001"
+#        %>
+#
+# Then in the controller handle the return with something like this
+#
+#   def ipn
+#     notify = ActiveMerchant::Billing::Integrations::Maksuturva::Notification.new(params)
+#
+#     if notify.acknowledge(MAKSUTURVA_AUTHCODE)
+#       # Process order
+#     else
+#       # Show error
+#     end
+#   end
+#
+# For full list of available parameters etc check the integration documents
+# here:
+#
+#   https://www.maksuturva.fi/services/vendor_services/integration_guidelines.html
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Maksuturva
+        mattr_accessor :service_url
+        self.service_url = 'https://www.maksuturva.fi/NewPaymentExtended.pmt'
+
+        def self.notification(post)
+          Notification.new(post)
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/maksuturva/helper.rb

@@ -0,0 +1,119 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Maksuturva
+        class Helper < ActiveMerchant::Billing::Integrations::Helper
+          def initialize(order, account, options = {})
+            md5secret options.delete(:credential2)
+            super
+            add_field("pmt_action", "NEW_PAYMENT_EXTENDED")
+            add_field("pmt_version", "0004")
+            add_field("pmt_sellerid", account)
+            add_field("pmt_hashversion", "MD5")
+          end
+
+          def md5secret(value)
+            @md5secret = value
+          end
+
+          def form_fields
+            @fields.merge("pmt_hash" => generate_md5string)
+          end
+
+          def generate_md5string
+            fields = [@fields["pmt_action"], @fields["pmt_version"]]
+            fields += [@fields["pmt_selleriban"]] unless @fields["pmt_selleriban"].nil?
+            fields += [@fields["pmt_id"], @fields["pmt_orderid"], @fields["pmt_reference"], @fields["pmt_duedate"],
+            @fields["pmt_amount"], @fields["pmt_currency"], @fields["pmt_okreturn"], @fields["pmt_errorreturn"], @fields["pmt_cancelreturn"],
+            @fields["pmt_delayedpayreturn"], @fields["pmt_escrow"], @fields["pmt_escrowchangeallowed"]]
+
+            fields += [@fields["pmt_invoicefromseller"]] unless @fields["pmt_invoicefromseller"].nil?
+            fields += [@fields["pmt_paymentmethod"]] unless @fields["pmt_paymentmethod"].nil?
+            fields += [@fields["pmt_buyeridentificationcode"]] unless @fields["pmt_buyeridentificationcode"].nil?
+
+
+            fields += [@fields["pmt_buyername"], @fields["pmt_buyeraddress"], @fields["pmt_buyerpostalcode"], @fields["pmt_buyercity"],
+            @fields["pmt_buyercountry"], @fields["pmt_deliveryname"], @fields["pmt_deliveryaddress"], @fields["pmt_deliverypostalcode"], @fields["pmt_deliverycity"],
+            @fields["pmt_deliverycountry"], @fields["pmt_sellercosts"]]
+
+            (1..@fields["pmt_rows"].to_i).each do |i|
+              fields += [@fields["pmt_row_name#{i}"], @fields["pmt_row_desc#{i}"], @fields["pmt_row_quantity#{i}"]]
+              fields += [@fields["pmt_row_articlenr#{i}"]] unless @fields["pmt_row_articlenr#{i}"].nil?
+              fields += [@fields["pmt_row_unit#{i}"]] unless @fields["pmt_row_unit#{i}"].nil?
+              fields += [@fields["pmt_row_deliverydate#{i}"]]
+              fields += [@fields["pmt_row_price_gross#{i}"]] unless @fields["pmt_row_price_gross#{i}"].nil?
+              fields += [@fields["pmt_row_price_net#{i}"]] unless @fields["pmt_row_price_net#{i}"].nil?
+              fields += [@fields["pmt_row_vat#{i}"], @fields["pmt_row_discountpercentage#{i}"], @fields["pmt_row_type#{i}"]]
+            end
+            fields += [@md5secret]
+            fields = fields.join("&") + "&"
+            Digest::MD5.hexdigest(fields).upcase
+          end
+
+          mapping :pmt_selleriban, "pmt_selleriban"
+          mapping :pmt_reference, "pmt_reference"
+          mapping :pmt_duedate, "pmt_duedate"
+          mapping :pmt_userlocale, "pmt_userlocale"
+          mapping :pmt_escrow, "pmt_escrow"
+          mapping :pmt_escrowchangeallowed, "pmt_escrowchangeallowed"
+          mapping :pmt_invoicefromseller, "pmt_invoicefromseller"
+          mapping :pmt_paymentmethod, "pmt_paymentmethod"
+          mapping :pmt_buyeridentificationcode, "pmt_buyeridentificationcode"
+          mapping :pmt_buyername, "pmt_buyername"
+
+          mapping :account, ''
+          mapping :currency, 'pmt_currency'
+          mapping :amount, 'pmt_amount'
+
+          mapping :order, 'pmt_id'
+          mapping :pmt_orderid, 'pmt_orderid'
+          mapping :pmt_deliveryname, "pmt_deliveryname"
+          mapping :pmt_deliveryaddress, "pmt_deliveryaddress"
+          mapping :pmt_deliverypostalcode, "pmt_deliverypostalcode"
+          mapping :pmt_deliverycity, "pmt_deliverycity"
+          mapping :pmt_deliverycountry, "pmt_deliverycountry"
+          mapping :pmt_sellercosts, "pmt_sellercosts"
+          mapping :pmt_rows, "pmt_rows"
+
+          (1..499.to_i).each do |i|
+            mapping "pmt_row_name#{i}".to_sym, "pmt_row_name#{i}"
+            mapping "pmt_row_desc#{i}".to_sym, "pmt_row_desc#{i}"
+            mapping "pmt_row_quantity#{i}".to_sym, "pmt_row_quantity#{i}"
+            mapping "pmt_row_articlenr#{i}".to_sym, "pmt_row_articlenr#{i}"
+            mapping "pmt_row_unit#{i}".to_sym, "pmt_row_unit#{i}"
+            mapping "pmt_row_deliverydate#{i}".to_sym, "pmt_row_deliverydate#{i}"
+            mapping "pmt_row_price_gross#{i}".to_sym, "pmt_row_price_gross#{i}"
+            mapping "pmt_row_price_net#{i}".to_sym, "pmt_row_price_net#{i}"
+            mapping "pmt_row_vat#{i}".to_sym, "pmt_row_vat#{i}"
+            mapping "pmt_row_discountpercentage#{i}".to_sym, "pmt_row_discountpercentage#{i}"
+            mapping "pmt_row_type#{i}".to_sym, "pmt_row_type#{i}"
+          end
+
+          mapping :pmt_charset, "pmt_charset"
+          mapping :pmt_charsethttp, "pmt_charsethttp"
+          mapping :pmt_hashversion, "pmt_hashversion"
+          mapping :pmt_keygeneration, "pmt_keygeneration"
+          mapping :customer, :email      => 'pmt_buyeremail',
+                             :phone      => 'pmt_buyerphone'
+
+          mapping :billing_address, :city     => 'pmt_buyercity',
+                                    :address1 => "pmt_buyeraddress",
+                                    :address2 => '',
+                                    :state    => '',
+                                    :zip      => "pmt_buyerpostalcode",
+                                    :country  => 'pmt_buyercountry'
+
+          mapping :notify_url, ''
+          mapping :return_url, 'pmt_okreturn'
+          mapping :pmt_errorreturn, 'pmt_errorreturn'
+          mapping :pmt_delayedpayreturn, 'pmt_delayedpayreturn'
+          mapping :cancel_return_url, 'pmt_cancelreturn'
+
+          mapping :description, ''
+          mapping :tax, ''
+          mapping :shipping, ''
+        end
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/integrations/maksuturva/notification.rb

@@ -0,0 +1,48 @@
+require "net/http"
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    module Integrations #:nodoc:
+      module Maksuturva
+        class Notification < ActiveMerchant::Billing::Integrations::Notification
+          def complete?
+            true
+          end
+
+          def transaction_id
+            params["pmt_id"]
+          end
+
+          def security_key
+            params["pmt_hash"]
+          end
+
+          def gross
+            params["pmt_amount"]
+          end
+
+          def currency
+            params["pmt_currency"]
+          end
+
+          def status
+            "PAID"
+          end
+
+          def acknowledge(authcode)
+            return_authcode = [params["pmt_action"], params["pmt_version"], params["pmt_id"], params["pmt_reference"], params["pmt_amount"], params["pmt_currency"], params["pmt_sellercosts"], params["pmt_paymentmethod"], params["pmt_escrow"], authcode].join("&")
+            (Digest::MD5.hexdigest(return_authcode + "&").upcase == params["pmt_hash"])
+          end
+
+          private
+
+          def parse(post)
+            post.each do |key, value|
+              params[key] = value
+            end
+          end
+        end
+      end
+    end
+  end
+end