activemerchant 1.4.2 → 1.5.0

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

@@ -0,0 +1,164 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class InstapayGateway < Gateway
+      GATEWAY_URL = 'https://trans.instapaygateway.com/cgi-bin/process.cgi'
+
+      # The countries the gateway supports merchants from as 2 digit ISO country codes
+      self.supported_countries = ['US']
+      self.money_format = :dollars
+      self.default_currency = 'USD'
+      # The card types supported by the payment gateway
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+
+      # The homepage URL of the gateway
+      self.homepage_url = 'http://www.instapayllc.com'
+
+      # The name of the gateway
+      self.display_name = 'InstaPay'
+      
+      SUCCESS         = "Accepted"
+      SUCCESS_MESSAGE = "The transaction has been approved"
+
+      def initialize(options = {})
+        requires!(options, :login)
+        @options = options
+        super
+      end
+
+      def authorize(money, creditcard, options = {})
+        post = {}
+        post[:authonly] = 1
+        add_amount(post, money)
+        add_invoice(post, options)
+        add_creditcard(post, creditcard)
+        add_address(post, options)
+        add_customer_data(post, options)
+
+        commit('ns_quicksale_cc', post)
+      end
+
+      def purchase(money, creditcard, options = {})
+        post = {}
+        add_amount(post, money)
+        add_invoice(post, options)
+        add_creditcard(post, creditcard)
+        add_address(post, options)
+        add_customer_data(post, options)
+
+        commit('ns_quicksale_cc', post)
+      end
+      
+      def capture(money, authorization, options = {})
+        post = {}
+        add_amount(post, money)
+        add_reference(post, authorization)        
+        commit('ns_quicksale_cc', post)
+      end
+
+      private
+      
+      def add_amount(post, money)
+        post[:amount] = amount(money)
+      end
+      
+      def add_reference(post, reference)
+        post[:postonly] = reference
+      end
+        
+      def add_customer_data(post, options)
+        post[:ci_email]       = options[:email]
+        post["ci_IP Address"] = options[:ip]
+      end
+
+      def add_address(post, options)
+        if address = options[:billing_address] || options[:address]
+          post[:ci_billaddr1]   = address[:address1]
+          post[:ci_billaddr2]   = address[:address2]
+          post[:ci_billcity]    = address[:city]
+          post[:ci_billstate]   = address[:state]
+          post[:ci_billzip]     = address[:zip]
+          post[:ci_billcountry] = address[:country]
+          post[:ci_phone]       = address[:phone]
+        end
+
+        if address = options[:shipping_address]
+          post[:ci_shipaddr1]   = address[:address1]
+          post[:ci_shipaddr2]   = address[:address2]
+          post[:ci_shipcity]    = address[:city]
+          post[:ci_shipstate]   = address[:state]
+          post[:ci_shipzip]     = address[:zip]
+          post[:ci_shipcountry] = address[:country]  
+        end
+      end
+
+      def add_invoice(post, options)
+        post[:merchantordernumber] = options[:order_id]
+        post[:ci_memo]             = options[:description]
+        post[:pocustomerrefid]     = options[:invoice]
+      end
+
+      def add_creditcard(post, creditcard)
+        post[:ccnum]   = creditcard.number
+        post[:expmon]  = format(creditcard.month, :two_digits)
+        post[:cvv2]    = creditcard.verification_value if creditcard.verification_value?
+        post[:expyear] = creditcard.year
+        post[:ccname]  = creditcard.name
+      end
+
+      def parse(body)
+        results = {}
+        fields = body.split("\r\n")
+        
+        response = fields[1].split('=')        
+        response_data = response[1].split(':')
+        
+        if response[0] == SUCCESS
+          results[:success] = true
+          results[:message] = SUCCESS_MESSAGE
+          results[:transaction_type] = response_data[0]
+          results[:authorization_code] = response_data[1]
+          results[:reference_number] = response_data[2]
+          results[:batch_number] = response_data[3]
+          results[:transaction_id] = response_data[4]
+          results[:avs_result] = response_data[5]
+          results[:authorize_net] = response_data[6]
+          results[:cvv_result] = response_data[7]
+        else
+          results[:success] = false
+          results[:result] = response_data[0]
+          results[:response_code] = response_data[1]
+          results[:message] = response_data[2]
+        end
+
+        fields[1..-1].each do |pair|
+          key, value = pair.split('=')
+          results[key] = value
+        end
+        results
+      end
+
+      def commit(action, parameters)
+        data = ssl_post GATEWAY_URL , post_data(action, parameters)
+        response = parse(data)
+
+        Response.new(response[:success] , response[:message], response,
+          :authorization => response[:transaction_id],
+          :avs_result => { :code => response[:avs_result] },
+          :cvv_result => response[:cvv_result]
+        )
+      end
+
+      def post_data(action, parameters = {})
+        post = {}
+        post[:acctid] = @options[:login]
+        if(@options[:password])
+          post[:merchantpin] = @options[:password]
+        end
+        post[:action] = action
+        request = post.merge(parameters).collect { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join("&")
+        request
+      end
+    end
+  end
+end
+

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

@@ -0,0 +1,270 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class JetpayGateway < Gateway
+      TEST_URL = 'https://test1.jetpay.com/jetpay'
+      LIVE_URL = 'https://gateway17.jetpay.com/jetpay'
+      
+      # The countries the gateway supports merchants from as 2 digit ISO country codes
+      self.supported_countries = ['US']
+      
+      # The card types supported by the payment gateway
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+      
+      # The homepage URL of the gateway
+      self.homepage_url = 'http://www.jetpay.com/'
+      
+      # The name of the gateway
+      self.display_name = 'JetPay'
+      
+      # all transactions are in cents
+      self.money_format = :cents
+      
+      ACTION_CODE_MESSAGES = {
+        "001" =>  "Refer to card issuer.",
+        "002" =>  "Refer to card issuer, special condition.",
+        "003" =>  "Pick up card.",
+        "200" =>  "Deny - Pick up card.",
+        "005" =>  "Do not honor.",
+        "100" =>  "Deny.",
+        "006" =>  "Error.",
+        "181" =>  "Format error.",
+        "007" =>  "Pickup card, special condition.",
+        "104" =>  "Deny - New card issued.",
+        "110" =>  "Invalid amount.",
+        "014" =>  "Invalid account number (no such number).",
+        "111" =>  "Invalid account.",
+        "015" =>  "No such issuer.",
+        "103" =>  "Deny - Invalid manual Entry 4DBC.",
+        "182" =>  "Please wait.",
+        "109" =>  "Invalid merchant.",
+        "041" =>  "Pick up card (lost card).",
+        "043" =>  "Pick up card (stolen card).",
+        "051" =>  "Insufficient funds.",
+        "052" =>  "No checking account.",
+        "105" =>  "Deny - Account Cancelled.",
+        "054" =>  "Expired Card.",
+        "101" =>  "Expired Card.",
+        "183" =>  "Invalid currency code.",
+        "057" =>  "Transaction not permitted to cardholder.",
+        "115" =>  "Service not permitted.",
+        "062" =>  "Restricted card.",
+        "189" =>  "Deny - Cancelled or Closed Merchant/SE.",
+        "188" =>  "Deny - Expiration date required.",
+        "125" =>  "Invalid effective date.",
+        "122" =>  "Invalid card (CID) security code.",
+        "400" =>  "Reversal accepted.",
+        "992" =>  "DECLINE/TIMEOUT.",
+        "107" =>  "Please Call Issuer.",
+        "025" =>  "Transaction Not Found.",
+        "981" =>  "AVS Error.",
+        "913" =>  "Invalid Card Type.",
+        "996" =>  "Terminal ID Not Found."
+      }
+      
+      def initialize(options = {})
+        requires!(options, :login)
+        @options = options
+        super
+      end  
+      
+      def purchase(money, credit_card, options = {})
+        commit(money, build_sale_request(money, credit_card, options))
+      end
+      
+      def authorize(money, credit_card, options = {})
+        commit(money, build_authonly_request(money, credit_card, options))
+      end
+      
+      def capture(money, reference, options = {})
+        commit(money, build_capture_request('CAPT', reference.split(";").first))
+      end
+      
+      def void(reference, options = {})
+        transaction_id, approval, amount = reference.split(";")
+        commit(amount.to_i, build_void_request(amount.to_i, transaction_id, approval))
+      end
+
+      def credit(money, transaction_id_or_card, options = {})
+        
+        if transaction_id_or_card.is_a?(String)
+          transaction_id = transaction_id_or_card.split(";").first
+          credit_card = options[:credit_card]
+        else
+          transaction_id = nil
+          credit_card = transaction_id_or_card
+        end
+
+        commit(money, build_credit_request('CREDIT', money, transaction_id, credit_card))
+      end
+      
+      private
+      
+      def build_xml_request(transaction_type, transaction_id = nil, &block)
+        xml = Builder::XmlMarkup.new
+        xml.tag! 'JetPay' do
+          # The basic values needed for any request
+          xml.tag! 'TerminalID', @options[:login]
+          xml.tag! 'TransactionType', transaction_type
+          xml.tag! 'TransactionID', transaction_id.nil? ? generate_unique_id.slice(0, 18) : transaction_id
+          
+          if block_given?
+            yield xml
+          else 
+            xml.target!
+          end
+        end
+      end
+      
+      def build_sale_request(money, credit_card, options)
+        build_xml_request('SALE') do |xml|
+          add_credit_card(xml, credit_card)
+          add_addresses(xml, options)
+          add_customer_data(xml, options)
+          add_invoice_data(xml, options)
+          xml.tag! 'TotalAmount', amount(money)
+          
+          xml.target!
+        end
+      end
+      
+      def build_authonly_request(money, credit_card, options)
+        build_xml_request('AUTHONLY') do |xml|
+          add_credit_card(xml, credit_card)
+          add_addresses(xml, options)
+          add_customer_data(xml, options)
+          add_invoice_data(xml, options)
+          xml.tag! 'TotalAmount', amount(money)
+          
+          xml.target!
+        end
+      end
+      
+      def build_capture_request(transaction_type, transaction_id)
+        build_xml_request(transaction_type, transaction_id)
+      end
+      
+      def build_void_request(money, transaction_id, approval)
+        build_xml_request('VOID', transaction_id) do |xml|
+          xml.tag! 'Approval', approval
+          xml.tag! 'TotalAmount', amount(money)
+          
+          xml.target!
+        end        
+      end
+
+      # `transaction_id` may be nil for unlinked credit transactions.
+      def build_credit_request(transaction_type, money, transaction_id, card)
+        build_xml_request(transaction_type, transaction_id) do |xml|
+          add_credit_card(xml, card) if card
+          xml.tag! 'TotalAmount', amount(money)
+          
+          xml.target!
+        end
+      end
+      
+      def commit(money, request)
+        response = parse(ssl_post(test? ? TEST_URL : LIVE_URL, request))
+        
+        success = success?(response)
+        Response.new(success, 
+          success ? 'APPROVED' : message_from(response), 
+          response, 
+          :test => test?, 
+          :authorization => authorization_from(response, money),
+          :avs_result => { :code => response[:avs] },
+          :cvv_result => response[:cvv2]
+        )
+      end
+      
+      def parse(body)
+        xml = REXML::Document.new(body)
+        
+        response = {}
+        xml.root.elements.to_a.each do |node|
+          parse_element(response, node)
+        end
+        response
+      end
+      
+      def parse_element(response, node)
+        if node.has_elements?
+          node.elements.each{|element| parse_element(response, element) }
+        else
+          response[node.name.underscore.to_sym] = node.text
+        end
+      end
+      
+      def format_exp(value)
+        format(value, :two_digits)
+      end
+      
+      def success?(response)
+        response[:action_code] == "000"
+      end
+      
+      def message_from(response)
+        ACTION_CODE_MESSAGES[response[:action_code]]
+      end
+      
+      def authorization_from(response, money)
+        original_amount = amount(money) if money
+        [ response[:transaction_id], response[:approval], original_amount ].join(";")
+      end
+      
+      def add_credit_card(xml, credit_card)
+        xml.tag! 'CardNum', credit_card.number
+        xml.tag! 'CardExpMonth', format_exp(credit_card.month)
+        xml.tag! 'CardExpYear', format_exp(credit_card.year)
+
+        if credit_card.first_name || credit_card.last_name
+          xml.tag! 'CardName', [credit_card.first_name,credit_card.last_name].compact.join(' ')
+        end
+
+        unless credit_card.verification_value.nil? || (credit_card.verification_value.length == 0)
+          xml.tag! 'CVV2', credit_card.verification_value
+        end
+      end
+      
+      def add_addresses(xml, options)
+        if billing_address = options[:billing_address] || options[:address]
+          xml.tag! 'BillingAddress', [billing_address[:address1], billing_address[:address2]].compact.join(" ")
+          xml.tag! 'BillingCity', billing_address[:city]
+          xml.tag! 'BillingStateProv', billing_address[:state]
+          xml.tag! 'BillingPostalCode', billing_address[:zip]
+          xml.tag! 'BillingCountry', lookup_country_code(billing_address[:country])
+          xml.tag! 'BillingPhone', billing_address[:phone]
+        end
+        
+        if shipping_address = options[:shipping_address]
+          xml.tag! 'ShippingInfo' do
+            xml.tag! 'ShippingName', shipping_address[:name]
+            
+            xml.tag! 'ShippingAddr' do
+              xml.tag! 'Address', [shipping_address[:address1], shipping_address[:address2]].compact.join(" ")
+              xml.tag! 'City', shipping_address[:city]
+              xml.tag! 'StateProv', shipping_address[:state]
+              xml.tag! 'PostalCode', shipping_address[:zip]
+              xml.tag! 'Country', lookup_country_code(shipping_address[:country])
+            end
+          end
+        end
+      end
+
+      def add_customer_data(xml, options)
+        xml.tag! 'Email', options[:email] if options[:email]
+        xml.tag! 'UserIPAddress', options[:ip] if options[:ip]
+      end
+      
+      def add_invoice_data(xml, options)
+        xml.tag! 'OrderNumber', options[:order_id] if options[:order_id]
+        xml.tag! 'TaxAmount', amount(options[:tax]) if options[:tax]
+      end
+      
+      def lookup_country_code(code)
+        country = Country.find(code) rescue nil        
+        country && country.code(:alpha3)
+      end
+    end
+  end
+end
+

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

@@ -82,12 +82,41 @@ module ActiveMerchant #:nodoc:
     #    :transactiondetails => [:transactionorigin, :oid, :ponumber, :taxexempt, :terminaltype, :ip, :reference_number, :recurring, :tdate],
     #    :periodic => [:action, :installments, :threshold, :startdate, :periodicity, :comments],
     #    :notes => [:comments, :referred]
+    #    :items => [:item => [:price, :quantity, :description, :id, :options => [:option => [:name, :value]]]]
     #  }
     #
-    #
-    # IMPORTANT NOTICE: 
     # 
-    # LinkPoint's Items entity is not yet supported in this module.
+    # LinkPoint's Items entity is an optional entity that can be attached to orders.
+    # It is entered as :line_items to be consistent with the CyberSource implementation
+    #
+    # The line_item hash goes in the options hash and should look like
+    #
+    #         :line_items => [
+    #           {
+    #             :id => '123456',
+    #             :description => 'Logo T-Shirt',
+    #             :price => '12.00',
+    #             :quantity => '1',
+    #             :options => [
+    #               {
+    #                 :name => 'Color',
+    #                 :value => 'Red'
+    #               },
+    #               {
+    #                 :name => 'Size',
+    #                 :value => 'XL'
+    #               }
+    #             ]
+    #           },
+    #           {
+    #             :id => '111',
+    #             :description => 'keychain',
+    #             :price => '3.00',
+    #             :quantity => '1'
+    #           }
+    #         ]
+    # This functionality is only supported by this particular gateway may
+    # be changed at any time
     # 
     class LinkpointGateway < Gateway     
       # Your global PEM file. This will be assigned to you by linkpoint
@@ -247,16 +276,38 @@ module ActiveMerchant #:nodoc:
         # Loop over the params hash to construct the XML string
         for key, value in params
           elem = order.add_element(key.to_s)
-          for k, v in params[key]
-            elem.add_element(k.to_s).text = params[key][k].to_s if params[key][k]
+          if key == :items
+            build_items(elem, value)
+          else
+            for k, v in params[key]
+              elem.add_element(k.to_s).text = params[key][k].to_s if params[key][k]
+            end
           end
           # Linkpoint doesn't understand empty elements: 
           order.delete(elem) if elem.size == 0
         end
-        
         return xml.to_s
       end
-            
+
+      # adds LinkPoint's Items entity to the XML.  Called from post_data
+      def build_items(element, items)
+        for item in items
+          item_element = element.add_element("item")
+          for key, value in item
+            if key == :options
+              options_element = item_element.add_element("options")
+              for option in value
+                opt_element = options_element.add_element("option")
+                opt_element.add_element("name").text =  option[:name]   unless option[:name].blank?
+                opt_element.add_element("value").text =  option[:value]   unless option[:value].blank?
+              end
+            else
+              item_element.add_element(key.to_s).text =  item[key].to_s unless item[key].blank?
+            end
+          end
+        end
+      end
+
       # Set up the parameters hash just once so we don't have to do it
       # for every action. 
       def parameters(money, creditcard, options = {})
@@ -307,10 +358,10 @@ module ActiveMerchant #:nodoc:
       
         if creditcard
           params[:creditcard] = {
-             :cardnumber => creditcard.number,
-             :cardexpmonth => creditcard.month,
-             :cardexpyear => format_creditcard_expiry_year(creditcard.year),
-             :track => nil
+            :cardnumber => creditcard.number,
+            :cardexpmonth => creditcard.month,
+            :cardexpyear => format_creditcard_expiry_year(creditcard.year),
+            :track => nil
           }
           
           if creditcard.verification_value?
@@ -324,7 +375,7 @@ module ActiveMerchant #:nodoc:
         if billing_address = options[:billing_address] || options[:address]          
           
           params[:billing] = {}        
-          params[:billing][:name]      = billing_address[:name] || creditcard ? creditcard.name : nil
+          params[:billing][:name]      = billing_address[:name] || (creditcard ? creditcard.name : nil)
           params[:billing][:address1]  = billing_address[:address1] unless billing_address[:address1].blank?
           params[:billing][:address2]  = billing_address[:address2] unless billing_address[:address2].blank?
           params[:billing][:city]      = billing_address[:city]     unless billing_address[:city].blank?
@@ -348,6 +399,8 @@ module ActiveMerchant #:nodoc:
           params[:shipping][:country]   = shipping_address[:country]  unless shipping_address[:country].blank?
         end        
 
+        params[:items] = options[:line_items] if options[:line_items]
+        
         return params
       end