yetanothernguyen-activemerchant 1.16.0 → 1.21.0

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

@@ -41,6 +41,12 @@ module ActiveMerchant #:nodoc:
         commit 'DoExpressCheckoutPayment', build_sale_or_authorization_request('Sale', money, options)
       end
 
+      def reference_transaction(money, options = {})
+        requires!(options, :reference_id, :payment_type, :invoice_id, :description, :ip)
+
+        commit 'DoReferenceTransaction', build_reference_transaction_request('Sale', money, options)
+      end
+
       private
       def build_get_details_request(token)
         xml = Builder::XmlMarkup.new :indent => 2
@@ -80,6 +86,8 @@ module ActiveMerchant #:nodoc:
                 xml.tag! 'n2:ButtonSource', application_id.to_s.slice(0,32) unless application_id.blank?
                 xml.tag! 'n2:InvoiceID', options[:order_id]
                 xml.tag! 'n2:OrderDescription', options[:description]
+
+                add_items_xml(xml, options, currency_code) if options[:items]
               end
             end
           end
@@ -96,12 +104,40 @@ module ActiveMerchant #:nodoc:
           xml.tag! 'SetExpressCheckoutRequest', 'xmlns:n2' => EBAY_NAMESPACE do
             xml.tag! 'n2:Version', API_VERSION
             xml.tag! 'n2:SetExpressCheckoutRequestDetails' do
+              xml.tag! 'n2:ReturnURL', options[:return_url]
+              xml.tag! 'n2:CancelURL', options[:cancel_return_url]
               if options[:max_amount]
                 xml.tag! 'n2:MaxAmount', localized_amount(options[:max_amount], currency_code), 'currencyID' => currency_code
               end
+              xml.tag! 'n2:NoShipping', options[:no_shipping] ? '1' : '0'
+              xml.tag! 'n2:AddressOverride', options[:address_override] ? '1' : '0'
+              xml.tag! 'n2:LocaleCode', options[:locale] unless options[:locale].blank?
+              xml.tag! 'n2:BrandName', options[:brand_name] unless options[:brand_name].blank?
+              # Customization of the payment page
+              xml.tag! 'n2:PageStyle', options[:page_style] unless options[:page_style].blank?
+              xml.tag! 'n2:cpp-header-image', options[:header_image] unless options[:header_image].blank?
+              xml.tag! 'n2:cpp-header-border-color', options[:header_border_color] unless options[:header_border_color].blank?
+              xml.tag! 'n2:cpp-header-back-color', options[:header_background_color] unless options[:header_background_color].blank?
+              xml.tag! 'n2:cpp-payflow-color', options[:background_color] unless options[:background_color].blank?
+              if options[:allow_guest_checkout]
+                xml.tag! 'n2:SolutionType', 'Sole'
+                xml.tag! 'n2:LandingPage', 'Billing'
+              end
+              xml.tag! 'n2:BuyerEmail', options[:email] unless options[:email].blank?
+
+              if options[:billing_agreement]
+                xml.tag! 'n2:BillingAgreementDetails' do
+                  xml.tag! 'n2:BillingType', options[:billing_agreement][:type]
+                  xml.tag! 'n2:BillingAgreementDescription', options[:billing_agreement][:description]
+                  xml.tag! 'n2:PaymentType', options[:billing_agreement][:payment_type] || 'InstantOnly'
+                end
+              end
+
               if !options[:allow_note].nil?
                 xml.tag! 'n2:AllowNote', options[:allow_note] ? '1' : '0'
               end
+              xml.tag! 'n2:CallbackURL', options[:callback_url] unless options[:callback_url].blank?
+
               xml.tag! 'n2:PaymentDetails' do
                 xml.tag! 'n2:OrderTotal', amount(money).to_f.zero? ? localized_amount(100, currency_code) : localized_amount(money, currency_code), 'currencyID' => currency_code
                 # All of the values must be included together and add up to the order total
@@ -115,53 +151,26 @@ module ActiveMerchant #:nodoc:
                 xml.tag! 'n2:OrderDescription', options[:description]
                 xml.tag! 'n2:InvoiceID', options[:order_id]
 
-                if options[:items]
-                  options[:items].each do |item|
-                    xml.tag! 'n2:PaymentDetailsItem' do
-                      xml.tag! 'n2:Name', item[:name]
-                      xml.tag! 'n2:Number', item[:number]
-                      xml.tag! 'n2:Quantity', item[:quantity]
-                      if item[:amount]
-                        xml.tag! 'n2:Amount', localized_amount(item[:amount], currency_code), 'currencyID' => currency_code
-                      end
-                      xml.tag! 'n2:Description', item[:description]
-                      xml.tag! 'n2:ItemURL', item[:url]
-                    end
-                  end
-                end
                 add_address(xml, 'n2:ShipToAddress', options[:shipping_address] || options[:address])
 
+                add_items_xml(xml, options, currency_code) if options[:items]
+
                 xml.tag! 'n2:PaymentAction', action
+                xml.tag! 'n2:Custom', options[:custom] unless options[:custom].blank?
               end
 
-              xml.tag! 'n2:AddressOverride', options[:address_override] ? '1' : '0'
-              xml.tag! 'n2:NoShipping', options[:no_shipping] ? '1' : '0'
-              xml.tag! 'n2:ReturnURL', options[:return_url]
-              xml.tag! 'n2:CancelURL', options[:cancel_return_url]
-              xml.tag! 'n2:IPAddress', options[:ip] unless options[:ip].blank?
-              xml.tag! 'n2:BuyerEmail', options[:email] unless options[:email].blank?
-              
-              if options[:billing_agreement]
-                xml.tag! 'n2:BillingAgreementDetails' do
-                  xml.tag! 'n2:BillingType', options[:billing_agreement][:type]
-                  xml.tag! 'n2:BillingAgreementDescription', options[:billing_agreement][:description]
-                  xml.tag! 'n2:PaymentType', options[:billing_agreement][:payment_type] || 'InstantOnly'
+              if options[:shipping_options]
+                options[:shipping_options].each do |shipping_option|
+                  xml.tag! 'n2:FlatRateShippingOptions' do
+                    xml.tag! 'n2:ShippingOptionIsDefault', shipping_option[:default]
+                    xml.tag! 'n2:ShippingOptionAmount', localized_amount(shipping_option[:amount], currency_code), 'currencyID' => currency_code
+                    xml.tag! 'n2:ShippingOptionName', shipping_option[:name]
+                  end
                 end
               end
-        
-              # Customization of the payment page
-              xml.tag! 'n2:PageStyle', options[:page_style] unless options[:page_style].blank?
-              xml.tag! 'n2:cpp-header-image', options[:header_image] unless options[:header_image].blank?
-              xml.tag! 'n2:cpp-header-back-color', options[:header_background_color] unless options[:header_background_color].blank?
-              xml.tag! 'n2:cpp-header-border-color', options[:header_border_color] unless options[:header_border_color].blank?
-              xml.tag! 'n2:cpp-payflow-color', options[:background_color] unless options[:background_color].blank?
-              
-              if options[:allow_guest_checkout]
-                xml.tag! 'n2:SolutionType', 'Sole'
-                xml.tag! 'n2:LandingPage', 'Billing'
-              end
-              
-              xml.tag! 'n2:LocaleCode', options[:locale] unless options[:locale].blank?
+
+              xml.tag! 'n2:CallbackTimeout', options[:callback_timeout] unless options[:callback_timeout].blank?
+              xml.tag! 'n2:CallbackVersion', options[:callback_version] unless options[:callback_version].blank?
             end
           end
         end
@@ -169,9 +178,53 @@ module ActiveMerchant #:nodoc:
         xml.target!
       end
       
+      def build_reference_transaction_request(action, money, options)
+        currency_code = options[:currency] || currency(money)
+
+        xml = Builder::XmlMarkup.new :indent => 2
+        xml.tag! 'DoReferenceTransactionReq', 'xmlns' => PAYPAL_NAMESPACE do
+          xml.tag! 'DoReferenceTransactionRequest', 'xmlns:n2' => EBAY_NAMESPACE do
+            xml.tag! 'n2:Version', API_VERSION
+            xml.tag! 'n2:DoReferenceTransactionRequestDetails' do
+              xml.tag! 'n2:ReferenceID', options[:reference_id]
+              xml.tag! 'n2:PaymentAction', action
+              xml.tag! 'n2:PaymentType', options[:payment_type] || 'Any'
+              xml.tag! 'n2:PaymentDetails' do
+                xml.tag! 'n2:OrderTotal', amount(money).to_f.zero? ? localized_amount(100, currency_code) : localized_amount(money, currency_code), 'currencyID' => currency_code
+                xml.tag! 'n2:OrderDescription', options[:description]
+                xml.tag! 'n2:InvoiceID', options[:invoice_id]
+                xml.tag! 'n2:ButtonSource', 'ActiveMerchant'
+                xml.tag! 'n2:NotifyURL', ''
+              end
+              xml.tag! 'n2:IPAddress', options[:ip]
+            end
+          end
+        end
+
+        xml.target!
+      end
+
       def build_response(success, message, response, options = {})
         PaypalExpressResponse.new(success, message, response, options)
       end
+
+      private
+
+      def add_items_xml(xml, options, currency_code)
+        options[:items].each do |item|
+          xml.tag! 'n2:PaymentDetailsItem' do
+            xml.tag! 'n2:Name', item[:name]
+            xml.tag! 'n2:Number', item[:number]
+            xml.tag! 'n2:Quantity', item[:quantity]
+            if item[:amount]
+              xml.tag! 'n2:Amount', localized_amount(item[:amount], currency_code), 'currencyID' => currency_code
+            end
+            xml.tag! 'n2:Description', item[:description]
+            xml.tag! 'n2:ItemURL', item[:url]
+            xml.tag! 'n2:ItemCategory', item[:category] if item[:category]
+          end
+        end
+      end
     end
   end
 end

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

@@ -2,8 +2,13 @@ module ActiveMerchant
   module Billing
     module PaypalExpressCommon
       def self.included(base)
-        base.cattr_accessor :test_redirect_url
-        base.cattr_accessor :live_redirect_url
+        if base.respond_to?(:class_attribute)
+          base.class_attribute :test_redirect_url
+          base.class_attribute :live_redirect_url
+        else
+          base.class_inheritable_accessor :test_redirect_url
+          base.class_inheritable_accessor :live_redirect_url
+        end
         base.live_redirect_url = 'https://www.paypal.com/cgibin/webscr'
       end
       
@@ -22,4 +27,4 @@ module ActiveMerchant
       end
     end
   end
-end
+end

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

@@ -115,6 +115,10 @@ module ActiveMerchant #:nodoc:
         commit(:query, nil, {})
       end
 
+      def test?
+        @options[:test] || super  
+      end
+
       private
 
       def hosted?

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

@@ -8,30 +8,91 @@ module ActiveMerchant #:nodoc:
 
       self.default_currency = 'DKK'
       self.money_format = :cents
-      self.supported_cardtypes = [ :dankort, :forbrugsforeningen, :visa, :master, :american_express, :diners_club, :jcb, :maestro ]
+      self.supported_cardtypes = [:dankort, :forbrugsforeningen, :visa, :master, :american_express, :diners_club, :jcb, :maestro]
       self.supported_countries = ['DK', 'SE']
       self.homepage_url = 'http://quickpay.dk/'
       self.display_name = 'Quickpay'
 
-      PROTOCOL = 3
-
       MD5_CHECK_FIELDS = {
-        :authorize => [:protocol, :msgtype, :merchant, :ordernumber, :amount, :currency, :autocapture, :cardnumber, :expirationdate, :cvd, :cardtypelock, :testmode],
-        :capture   => [:protocol, :msgtype, :merchant, :amount, :transaction],
-        :cancel    => [:protocol, :msgtype, :merchant, :transaction],
-        :refund    => [:protocol, :msgtype, :merchant, :amount, :transaction],
-        :subscribe => [:protocol, :msgtype, :merchant, :ordernumber, :cardnumber, :expirationdate, :cvd, :cardtypelock, :description, :testmode],
-        :recurring => [:protocol, :msgtype, :merchant, :ordernumber, :amount, :currency, :autocapture, :transaction],
-        :status    => [:protocol, :msgtype, :merchant, :transaction],
-        :chstatus  => [:protocol, :msgtype, :merchant],
+        3 => {
+          :authorize => %w(protocol msgtype merchant ordernumber amount
+                           currency autocapture cardnumber expirationdate
+                           cvd cardtypelock testmode),
+
+          :capture   => %w(protocol msgtype merchant amount transaction),
+
+          :cancel    => %w(protocol msgtype merchant transaction),
+
+          :refund    => %w(protocol msgtype merchant amount transaction),
+
+          :subscribe => %w(protocol msgtype merchant ordernumber cardnumber
+                           expirationdate cvd cardtypelock description testmode),
+
+          :recurring => %w(protocol msgtype merchant ordernumber amount
+                           currency autocapture transaction),
+
+          :status    => %w(protocol msgtype merchant transaction),
+
+          :chstatus  => %w(protocol msgtype merchant)
+        },
+
+        4 => {
+          :authorize => %w(protocol msgtype merchant ordernumber amount
+                           currency autocapture cardnumber expirationdate cvd
+                           cardtypelock testmode fraud_remote_addr
+                           fraud_http_accept fraud_http_accept_language
+                           fraud_http_accept_encoding fraud_http_accept_charset
+                           fraud_http_referer fraud_http_user_agent apikey),
+
+          :capture   => %w(protocol msgtype merchant amount transaction
+                           fraud_remote_addr fraud_http_accept
+                           fraud_http_accept_language fraud_http_accept_encoding
+                           fraud_http_accept_charset fraud_http_referer
+                           fraud_http_user_agent apikey),
+
+          :cancel    => %w(protocol msgtype merchant transaction fraud_remote_addr
+                           fraud_http_accept fraud_http_accept_language
+                           fraud_http_accept_encoding fraud_http_accept_charset
+                           fraud_http_referer fraud_http_user_agent apikey),
+
+          :refund    => %w(protocol msgtype merchant amount transaction
+                           fraud_remote_addr fraud_http_accept fraud_http_accept_language
+                           fraud_http_accept_encoding fraud_http_accept_charset
+                           fraud_http_referer fraud_http_user_agent apikey),
+
+          :subscribe => %w(protocol msgtype merchant ordernumber cardnumber
+                           expirationdate cvd cardtypelock description testmode
+                           fraud_remote_addr fraud_http_accept fraud_http_accept_language
+                           fraud_http_accept_encoding fraud_http_accept_charset
+                           fraud_http_referer fraud_http_user_agent apikey),
+
+          :recurring => %w(protocol msgtype merchant ordernumber amount currency
+                           autocapture transaction fraud_remote_addr fraud_http_accept
+                           fraud_http_accept_language fraud_http_accept_encoding
+                           fraud_http_accept_charset fraud_http_referer
+                           fraud_http_user_agent apikey),
+
+          :status    => %w(protocol msgtype merchant transaction fraud_remote_addr
+                           fraud_http_accept fraud_http_accept_language
+                           fraud_http_accept_encoding fraud_http_accept_charset
+                           fraud_http_referer fraud_http_user_agent apikey),
+
+          :chstatus  => %w(protocol msgtype merchant fraud_remote_addr fraud_http_accept
+                           fraud_http_accept_language fraud_http_accept_encoding
+                           fraud_http_accept_charset fraud_http_referer
+                           fraud_http_user_agent apikey)
+        }
       }
 
       APPROVED = '000'
 
       # The login is the QuickpayId
-      # The password is the md5checkword from the Quickpay admin interface
+      # The password is the md5checkword from the Quickpay manager
+      # To use the API-key from the Quickpay manager, specify :api-key
+      # Using the API-key, requires that you use version 4. Specify :version => 4 in options.
       def initialize(options = {})
         requires!(options, :login, :password)
+        @protocol = options.delete(:version) || 3 # default to protocol version 3
         @options = options
         super
       end
@@ -43,6 +104,7 @@ module ActiveMerchant #:nodoc:
         add_invoice(post, options)
         add_creditcard_or_reference(post, credit_card_or_reference, options)
         add_autocapture(post, false)
+        add_fraud_parameters(post, options)
         add_testmode(post)
 
         commit(recurring_or_authorize(credit_card_or_reference), post)
@@ -54,6 +116,7 @@ module ActiveMerchant #:nodoc:
         add_amount(post, money, options)
         add_creditcard_or_reference(post, credit_card_or_reference, options)
         add_invoice(post, options)
+        add_fraud_parameters(post, options)
         add_autocapture(post, true)
 
         commit(recurring_or_authorize(credit_card_or_reference), post)
@@ -64,6 +127,7 @@ module ActiveMerchant #:nodoc:
 
         add_reference(post, authorization)
         add_amount_without_currency(post, money)
+        add_fraud_parameters(post, options)
 
         commit(:capture, post)
       end
@@ -72,6 +136,7 @@ module ActiveMerchant #:nodoc:
         post = {}
 
         add_reference(post, identification)
+        add_fraud_parameters(post, options)
 
         commit(:cancel, post)
       end
@@ -81,6 +146,7 @@ module ActiveMerchant #:nodoc:
 
         add_amount_without_currency(post, money)
         add_reference(post, identification)
+        add_fraud_parameters(post, options)
 
         commit(:refund, post)
       end
@@ -96,6 +162,7 @@ module ActiveMerchant #:nodoc:
         add_creditcard(post, creditcard, options)
         add_invoice(post, options)
         add_description(post, options)
+        add_fraud_parameters(post, options)
         add_testmode(post)
 
         commit(:subscribe, post)
@@ -148,8 +215,21 @@ module ActiveMerchant #:nodoc:
       end
 
       def add_testmode(post)
+        return if post[:transaction].present? 
         post[:testmode] = test? ? '1' : '0'
       end
+      
+      def add_fraud_parameters(post, options)
+        if @protocol == 4
+          post[:fraud_remote_addr] = options[:fraud_remote_addr] if options[:fraud_remote_addr]
+          post[:fraud_http_accept] = options[:fraud_http_accept] if options[:fraud_http_accept]
+          post[:fraud_http_accept_language] = options[:fraud_http_accept_language] if options[:fraud_http_accept_language]
+          post[:fraud_http_accept_encoding] = options[:fraud_http_accept_encoding] if options[:fraud_http_accept_encoding]
+          post[:fraud_http_accept_charset] = options[:fraud_http_accept_charset] if options[:fraud_http_accept_charset]
+          post[:fraud_http_referer] = options[:fraud_http_referer] if options[:fraud_http_referer]
+          post[:fraud_http_user_agent] = options[:fraud_http_user_agent] if options[:fraud_http_user_agent]
+        end
+      end
 
       def commit(action, params)
         response = parse(ssl_post(URL, post_data(action, params)))
@@ -177,27 +257,22 @@ module ActiveMerchant #:nodoc:
       end
 
       def message_from(response)
-        case response[:qpstat]
-        when '008'   # Error in request data
-          response[:qpstatmsg].to_s
-          #.scan(/[A-Z][a-z0-9 \/]+/).to_sentence
-        else
-          response[:qpstatmsg].to_s
-        end
+        response[:qpstatmsg].to_s
       end
 
       def post_data(action, params = {})
-        params[:protocol] = PROTOCOL
+        params[:protocol] = @protocol
         params[:msgtype]  = action.to_s
         params[:merchant] = @options[:login]
+        params[:apikey] = @options[:apikey] if @options[:apikey]
         params[:md5check] = generate_check_hash(action, params)
 
         params.collect { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join("&")
       end
 
       def generate_check_hash(action, params)
-        string = MD5_CHECK_FIELDS[action].collect do |key|
-          params[key]
+        string = MD5_CHECK_FIELDS[@protocol][action].collect do |key|
+          params[key.to_sym]
         end.join('')
 
         # Add the md5checkword

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

@@ -197,7 +197,7 @@ module ActiveMerchant
 
           if shipping_address
             xml.tag! 'address', 'type' => 'shipping' do
-              xml.tag! 'code', shipping_address[:zip]
+              xml.tag! 'code', format_shipping_zip_code(shipping_address[:zip])
               xml.tag! 'country', shipping_address[:country]
             end
           end
@@ -247,6 +247,10 @@ module ActiveMerchant
         address.values_at(:zip, :address1).map{ |v| extract_digits(v) }.join('|')
       end
 
+      def format_shipping_zip_code(zip)
+        zip.to_s.gsub(/\W/, '')
+      end
+
       def extract_digits(string)
         return "" if string.nil?
         string.gsub(/[\D]/,'')

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

@@ -0,0 +1,121 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class SamuraiGateway < Gateway
+
+      self.homepage_url = 'https://samurai.feefighters.com'
+      self.display_name = 'Samurai'
+      self.supported_countries = ['US']
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover, :jcb, :diners_club]
+      self.default_currency = 'USD'
+      self.money_format = :dollars
+
+      def initialize(options = {})
+        begin
+          require 'samurai'
+        rescue LoadError
+          raise "Could not load the samurai gem (>= 0.2.25).  Use `gem install samurai` to install it."
+        end
+
+        requires!(options, :login, :password, :processor_token)
+        @options = options
+        Samurai.options = {
+          :merchant_key       => options[:login],
+          :merchant_password  => options[:password],
+          :processor_token    => options[:processor_token]
+        }
+      end
+
+      def test?
+        @options[:test] || super
+      end
+
+      def authorize(money, credit_card_or_vault_id, options = {})
+        token = payment_method_token(credit_card_or_vault_id, options)
+        return token if token.is_a?(Response)
+
+        authorize = Samurai::Processor.authorize(token, amount(money), processor_options(options))
+        handle_result(authorize)
+      end
+
+      def purchase(money, credit_card_or_vault_id, options = {})
+        token = payment_method_token(credit_card_or_vault_id, options)
+        return token if token.is_a?(Response)
+
+        purchase = Samurai::Processor.purchase(token, amount(money), processor_options(options))
+        handle_result(purchase)
+      end
+
+      def capture(money, authorization_id, options = {})
+        transaction = Samurai::Transaction.find(authorization_id)
+        handle_result(transaction.capture(amount(money)))
+      end
+
+      def refund(money, transaction_id, options = {})
+        transaction = Samurai::Transaction.find(transaction_id)
+        handle_result(transaction.credit(amount(money)))
+      end
+
+      def void(transaction_id, options = {})
+        transaction = Samurai::Transaction.find(transaction_id)
+        handle_result(transaction.void)
+      end
+
+      def store(creditcard, options = {})
+        address = options[:billing_address] || options[:address] || {}
+
+        result = Samurai::PaymentMethod.create({
+          :card_number  => creditcard.number,
+          :expiry_month => creditcard.month.to_s.rjust(2, "0"),
+          :expiry_year  => creditcard.year.to_s,
+          :cvv          => creditcard.verification_value,
+          :first_name   => creditcard.first_name,
+          :last_name    => creditcard.last_name,
+          :address_1    => address[:address1],
+          :address_2    => address[:address2],
+          :city         => address[:city],
+          :zip          => address[:zip],
+          :sandbox      => test?
+        })
+        result.retain if options[:retain] && result.is_sensitive_data_valid && result.payment_method_token
+
+        Response.new(result.is_sensitive_data_valid,
+                     message_from_result(result),
+                     { :payment_method_token => result.is_sensitive_data_valid && result.payment_method_token })
+      end
+
+      private
+
+      def payment_method_token(credit_card_or_vault_id, options)
+        return credit_card_or_vault_id if credit_card_or_vault_id.is_a?(String)
+        store_result = store(credit_card_or_vault_id, options)
+        store_result.success? ? store_result.params["payment_method_token"] : store_result
+      end
+
+      def handle_result(result)
+        response_params, response_options = {}, {}
+        if result.success?
+          response_options[:test] = test?
+          response_options[:authorization] = result.reference_id
+          response_params[:reference_id] = result.reference_id
+          response_params[:transaction_token] = result.transaction_token
+          response_params[:payment_method_token] = result.payment_method.payment_method_token
+        end
+
+        response_options[:avs_result] = { :code => result.processor_response && result.processor_response.avs_result_code }
+        response_options[:cvv_result] = result.processor_response && result.processor_response.cvv_result_code
+
+        message = message_from_result(result)
+        Response.new(result.success?, message, response_params, response_options)
+      end
+
+      def message_from_result(result)
+        return "OK" if result.success?
+        result.errors.map {|_, messages| messages }.join(" ")
+      end
+
+      def processor_options(options)
+        options.slice(:billing_reference, :customer_reference, :custom, :descriptor)
+      end
+    end
+  end
+end