swiss-crm-activemerchant 1.0.15 → 1.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4b25e1ce49fa6ae8a7f34cf69a6ef0e2833e8fbba7ac055c067a99b538a1a1a
-  data.tar.gz: 1ea976368a71e0c2491a0e1712d71d0bae8be93bd693075820724e82ef598dfc
+  metadata.gz: 689115a82a2c414cd14f55bdfb36605a971ac74105006e1eb97c627954d0248d
+  data.tar.gz: 18b84a790ab9b91f6c57df713e641f19281dab80fe16673787162768dd0e83a6
 SHA512:
-  metadata.gz: 2b98441c3a1a1394cc2e0db7f358a49e7af3bf6e07dbd5f9a7ae580eb73ced7644c4b40a9f30f58b2b00ba0ac5d3b660f72c4ca60529c4c3628b50d282489e01
-  data.tar.gz: dc47c37a5913a712b032b457e4ac7772f6a586215f8620324b14ea413bb1a5f60735b2920ca0384fba395cd3dc73d197de827fc05e92615ab7adb3fb879926fb
+  metadata.gz: 30c4373f1d2b64c1c32819b3b530053173ba6e6c1a82ef7d455f32881b574aa82c5093bc0d42941e414db771b0c0ffe226ed6f034199119b0c416625ae9300ff
+  data.tar.gz: ef8f011e4cf68dc6674257cb58e212d6cbcaef81fbe615dbb676790dd493e0df354ad0ab6e355748d1dc1e7523c6e815d5d4da74a58ca5b13ed4804d1f8521d2

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

@@ -0,0 +1,345 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FinixGateway < Gateway
+      include Empty
+
+      SUCCESS_CODES = [200, 201].freeze
+
+      SOFT_DECLINE_CODES = %w[
+        INSUFFICIENT_FUNDS
+        EXCEEDS_APPROVAL_LIMIT
+        CARD_VELOCITY_EXCEEDED
+        PROCESSOR_TIMEOUT
+        TRANSACTION_NOT_ALLOWED
+      ].freeze
+
+      COUNTRY_CODE  = { 'US' => 'USA', 'CA' => 'CAN' }.freeze
+
+      API_VERSION = '2018-01-01'.freeze
+      BASIC_AUTH_PREFIX = 'Basic '.freeze
+      CONTENT_TYPE = 'application/json'.freeze
+
+      self.test_url = 'https://finix.sandbox-payments-api.com'
+      self.live_url = 'https://www.finixpayments.com'
+      self.supported_countries = %w[US CA]
+      self.supported_cardtypes = %i[visa master american_express discover]
+      self.default_currency = 'USD'
+      self.money_format = :cents
+      self.homepage_url = 'https://finixpayments.com'
+      self.display_name = 'Finix'
+
+      def initialize(options = {})
+        requires!(options, :username, :password, :merchant_id)
+        super
+        @username = options[:username]
+        @password = options[:password]
+        @merchant_id = options[:merchant_id]
+      end
+
+      def purchase(amount, payment_source, options = {})
+        post = {}
+        add_invoice(post, amount, options)
+        add_payment_source(post, payment_source, options)
+        add_idempotency_id(post, options)
+
+        verification_data = options[:verification_data] || {}
+        commit('transaction', post, verification_data, options)
+      end
+
+      def refund(amount, authorization, options = {})
+        post = {}
+        add_refund_data(post, amount, authorization, options)
+
+        commit('reversals', post, options)
+      end
+
+      private
+
+      def add_payment_source(post, payment_source, options)
+        return attach_existing_instrument(post, payment_source, options) if existing_customer?(options)
+
+        identity = create_new_identity(options)
+        return identity unless identity.success?
+
+        attach_new_instrument(post, identity.authorization, payment_source, options)
+      end
+
+      def existing_customer?(options)
+        options[:customer_identity].present?
+      end
+
+      def attach_existing_instrument(post, payment_source, options)
+        instrument_id = payment_source[:finix_payment_instrument_id]
+
+        if instrument_id.present?
+          attach_existing_instrument_data(post, instrument_id, options)
+        else
+          create_and_attach_new_instrument(post, payment_source, options)
+        end
+      end
+
+      def attach_existing_instrument_data(post, instrument_id, options)
+        payment_instrument = fetch_payment_instrument(instrument_id)
+
+        options[:verification_data] = {
+          avs_result: payment_instrument.dig('address_verification'),
+          cvv_result: payment_instrument.dig('security_code_verification')
+        }
+
+        post[:instrument_id] = instrument_id
+      end
+
+      def create_and_attach_new_instrument(post, payment_source, options)
+        instrument = create_payment_instrument(options[:customer_identity], payment_source, options)
+
+        return instrument unless instrument.success?
+
+        post[:instrument_id] = instrument.params['id']
+      end
+
+      def create_new_identity(options)
+        identity = create_identity(options)
+        options[:identity_id] = identity.authorization if identity.success?
+        identity
+      end
+
+      def attach_new_instrument(post, identity_id, payment_source, options)
+        instrument = create_payment_instrument(identity_id, payment_source, options)
+        return instrument unless instrument.success?
+
+        options[:verification_data] = {
+          avs_result: instrument.params['address_verification'],
+          cvv_result: instrument.params['security_code_verification']
+        }
+
+        post[:instrument_id] = instrument.params['id']
+      end
+
+      def create_identity(options)
+        post = {}
+        add_identity_data(post, options)
+
+        commit('identities', post, nil, options)
+      end
+
+      def create_payment_instrument(identity_id, payment_source, options)
+        post = {}
+        post[:identity] = identity_id
+        add_payment_method(post, payment_source, options)
+        add_address(post, options)
+
+        commit('payment_instruments', post, nil, options)
+      end
+
+      def fetch_payment_instrument(payment_instrument_id)
+        raw_response = ssl_get("#{url}/payment_instruments/#{payment_instrument_id}", headers)
+        response = parse(raw_response)
+      end
+
+      def add_refund_data(post, amount, authorization, options)
+        post[:amount] = amount
+        post[:transaction_id] = authorization
+        add_idempotency_id(post, options) if options['idempotency_id'].present?
+      end
+
+      def add_idempotency_id(post, options)
+        post[:idempotency_id] = options['idempotency_id']
+      end
+
+      def add_identity_data(post, options)
+        billing               = options[:billing_address] || {}
+        first_name, last_name = split_names(billing[:name])
+
+        post[:type]           = 'BUSINESS'
+        post[:identity_roles] = ['BUYER']
+        post[:entity]         = {
+                                  first_name: first_name,
+                                  last_name: last_name,
+                                  email: options[:email],
+                                  phone: billing[:phone],
+                                  personal_address: build_address(billing)
+                                }
+      end
+
+      def add_payment_method(post, payment_source, options)
+        billing                 = options[:billing_address] || {}
+        post[:type]             = 'TOKEN'
+        post[:token]             = payment_source[:gateway_payment_profile_id]
+      end
+
+      def add_invoice(post, amount, options)
+        post[:amount]   = amount
+        post[:currency] = options[:currency] || default_currency
+        post[:merchant] = @merchant_id
+        post[:tags] = {
+            purpose: 'sale',
+            order_id: options[:order_id],
+            customer_id: options[:customer_id]
+          }.compact
+      end
+
+      def add_address(post, options)
+        billing        = options[:billing_address] || {}
+        post[:address] = build_address(billing)
+      end
+
+      def add_reference(post, authorization)
+        post[:transaction_id] = authorization
+      end
+
+      def build_address(data)
+        {
+          line1: data[:address1],
+          city: data[:city],
+          region: data[:state],
+          postal_code: data[:zip].to_s.gsub(/\s+/, ''),
+          country: COUNTRY_CODE[data[:country]] || data[:country]
+        }
+      end
+
+      def commit(action, params, verification_data = nil, options = {})
+        request_url  = build_request_url(action, params)
+        payload      = build_payload(action, params)
+        raw_response = ssl_post(request_url, payload.to_json, headers)
+        response     = parse(raw_response).merge('customer_identity' => options[:identity_id]).compact
+        succeeded    = ['identities', 'payment_instruments'].include?(action) ?
+                        profile_created_successful?(response) :
+                        success_from(response)
+
+        Response.new(
+          succeeded,
+          message_from(succeeded, response),
+          response,
+          error_code: error_code_from(succeeded, response),
+          authorization: authorization_from(response),
+          avs_result: AVSResult.new(code: verification_data&.dig(:avs_result)),
+          cvv_result: CVVResult.new(verification_data&.dig(:cvv_result)),
+          test: test?,
+          response_type: response_type(response['state']),
+          response_http_code: @response_http_code,
+          request_endpoint: request_url,
+          request_method: :post,
+          request_body: payload
+        )
+      end
+
+      def build_request_url(action, params)
+        case action
+        when 'identities'
+          "#{url}/identities"
+        when 'payment_instruments'
+          "#{url}/payment_instruments"
+        when 'transaction'
+          "#{url}/transfers"
+        when 'reversals'
+          "#{url}/transfers/#{params[:transaction_id]}/reversals"
+        end
+      end
+
+      def build_payload(action, params)
+        case action
+        when 'reversals'
+          {
+            amount: params[:amount],
+            idempotency_id: params[:idempotency_id],
+            tags: params[:tags]
+          }
+        when 'transaction'
+          {
+            amount: params[:amount],
+            currency: params[:currency] || default_currency,
+            merchant: @merchant_id,
+            source: params[:instrument_id],
+            idempotency_id: params[:idempotency_id],
+            tags: params[:tags]
+          }
+        else
+          params
+        end
+      end
+
+      def headers
+        {
+          'Content-Type'  => CONTENT_TYPE,
+          'Authorization' => basic_auth_header,
+          'Finix-Version' => API_VERSION
+        }
+      end
+
+      def basic_auth_header
+        BASIC_AUTH_PREFIX + Base64.strict_encode64("#{@username}:#{@password}")
+      end
+
+      def url
+        test? ? test_url : live_url
+      end
+
+      def parse(body)
+        JSON.parse(body)
+      end
+
+      def success_from(response)
+        response['state'] == 'SUCCEEDED'
+      end
+
+      def profile_created_successful?(response)
+        return true if response['id'].present?
+
+        errors = response.dig('_embedded', 'errors')
+        if errors.present?
+          return false
+        end
+
+        false
+      end
+
+      def message_from(succeeded, response)
+        state = response["state"]
+
+        case state
+        when "FAILED"
+          response['failure_message']
+        when "PENDING", "SUCCEEDED", "CANCELED"
+          state.capitalize
+        else
+          response.dig('_embedded', 'errors', 0, 'message')
+        end
+      end
+
+      def error_code_from(succeeded, response)
+        return nil if succeeded
+
+        if response['_embedded'] && response['_embedded']['errors']
+          response['_embedded']['errors'].first['code']
+        else
+          response['failure_code']
+        end
+      end
+
+      def authorization_from(response)
+        response['id']
+      end
+
+      def response_type(state)
+        case state
+        when 'SUCCEEDED'            then 0
+        when 'FAILED'               then 2
+        when 'CANCELED', 'DECLINED' then 1
+        else 1
+        end
+      end
+
+      def split_names(name)
+        name_parts = name.to_s.split
+        first_name = name_parts.first || ''
+        last_name  = name_parts[1..]&.join(' ') || ''
+        [first_name, last_name]
+      end
+
+      def handle_response(response)
+        @response_http_code = response.code.to_i
+        response.body
+      end
+    end
+  end
+end

data/lib/active_merchant/version.rb

@@ -1,3 +1,3 @@
 module ActiveMerchant
-  VERSION = '1.0.15'
+  VERSION = '1.0.16'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: swiss-crm-activemerchant
 version: !ruby/object:Gem::Version
-  version: 1.0.15
+  version: 1.0.16
 platform: ruby
 authors:
 - Tobias Luetke
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-01-31 00:00:00.000000000 Z
+date: 2025-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -284,6 +284,7 @@ files:
 - lib/active_merchant/billing/gateways/fat_zebra.rb
 - lib/active_merchant/billing/gateways/federated_canada.rb
 - lib/active_merchant/billing/gateways/finansbank.rb
+- lib/active_merchant/billing/gateways/finix.rb
 - lib/active_merchant/billing/gateways/first_giving.rb
 - lib/active_merchant/billing/gateways/first_pay.rb
 - lib/active_merchant/billing/gateways/firstdata_e4.rb
@@ -484,7 +485,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -499,8 +500,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.2.3
+signing_key: 
 specification_version: 4
 summary: Framework and tools for dealing with credit card transactions.
 test_files: []