giact_verification 0.1.0

data/lib/giact_verification/requests/request_coordinator.rb

@@ -0,0 +1,30 @@
+module GiactVerification
+  class RequestCoordinator
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @body      = args[:body]
+      @requester = args[:requester] || GiactVerification::RequesterFactory.call
+      @parser    = args[:parser]    || GiactVerification::ResponseParser
+    end
+
+    def call
+      response = requester.call(body: body)
+
+      parsed_response = parser.call(response: response)
+
+      GiactVerification::Response.new(
+        raw_request:     body,
+        raw_response:    response.body,
+        success:         parsed_response.success,
+        parsed_response: parsed_response.body
+      )
+    end
+
+    private
+    attr_reader :body, :parser, :requester
+  end
+end

data/lib/giact_verification/requests/requester_factory.rb

@@ -0,0 +1,25 @@
+module GiactVerification
+  class RequesterFactory
+    def self.call
+      new.call
+    end
+
+    def initialize
+      @endpoint_set_to = GiactVerification.giact_endpoint
+    end
+
+    def call
+      case endpoint_set_to
+      when :production
+        GiactVerification::ProductionRequester
+      when :sandbox
+        GiactVerification::SandboxRequester
+      when :stubbed
+        GiactVerification::StubbedRequester
+      end
+    end
+
+    private
+    attr_reader :endpoint_set_to
+  end
+end

data/lib/giact_verification/requests/sandbox_requester.rb

@@ -0,0 +1,28 @@
+require 'uri'
+require 'net/http'
+
+module GiactVerification
+  class SandboxRequester
+
+    SANDBOX_URI = URI.parse('https://sandbox.api.giact.com/verificationservices/v5/InquiriesWS-5-8.asmx').freeze
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @endpointable = SANDBOX_URI
+      @body         = args[:body]
+    end
+
+    def call
+      http = Net::HTTP.new(endpointable.host, endpointable.port)
+      http.use_ssl = true
+
+      response = http.post(endpointable.path, body, 'Content-Type' => 'text/xml')
+    end
+
+    private
+    attr_reader :endpointable, :body
+  end
+end

data/lib/giact_verification/requests/stubbed_requester.rb

@@ -0,0 +1,38 @@
+require 'ostruct'
+
+module GiactVerification
+  class StubbedRequester
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @body = args[:body]
+    end
+
+    def call
+      hashed_request_body = XmlToHash.call(xml: body)
+
+      response_body = response_for(hashed_request_body)
+
+      response = OpenStruct.new({code: '200', body: response_body})
+    end
+
+    private
+    attr_reader :body
+
+    def response_for(hashed_body)
+      last_name = hashed_body.dig(:'soap:envelope', :'soap:body', :post_inquiry, :inquiry, :customer, :last_name)
+
+      case last_name
+      when 'GiactDeclined'
+        File.read(File.join(GiactVerification.root, 'lib', 'giact_verification', 'requests', 'support', 'declined_response.xml'))
+      when 'GiactError'
+        File.read(File.join(GiactVerification.root, 'lib', 'giact_verification', 'requests', 'support', 'error_response.xml'))
+      else
+        File.read(File.join(GiactVerification.root, 'lib', 'giact_verification', 'requests', 'support', 'pass_response.xml'))
+      end
+    end
+  end
+end

data/lib/giact_verification/requests/support/declined_response.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+  <soap:Body>
+    <PostInquiryResponse xmlns="http://api.giact.com/verificationservices/v5">
+      <PostInquiryResult>
+        <ItemReferenceId>5000001888</ItemReferenceId>
+        <CreatedDate>2017-02-03T11:35:43.242182-06:00</CreatedDate>
+        <VerificationResponse>Declined</VerificationResponse>
+        <AccountResponseCode>GN05</AccountResponseCode>
+        <AccountClosedDate xsi:nil="true" />
+        <FundsConfirmationResult xsi:nil="true" />
+        <CustomerResponseCode>CA01</CustomerResponseCode>
+      </PostInquiryResult>
+    </PostInquiryResponse>
+  </soap:Body>
+</soap:Envelope>

data/lib/giact_verification/requests/support/error_response.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+  <soap:Body>
+    <PostInquiryResponse xmlns="http://api.giact.com/verificationservices/v5">
+      <PostInquiryResult>
+        <ItemReferenceId>218958</ItemReferenceId>
+        <CreatedDate>2018-01-31T14:22:25.6344486-06:00</CreatedDate>
+        <ErrorMessage>If gAuthenticate, gIdentify, CustomerID, OFAC List Scanning, or gMobile is enabled, then either both FirstName and LastName or BusinessName is required.</ErrorMessage>
+        <VerificationResponse>Error</VerificationResponse>
+        <AccountResponseCode xsi:nil="true" />
+        <AccountAddedDate xsi:nil="true" />
+        <AccountLastUpdatedDate xsi:nil="true" />
+        <AccountClosedDate xsi:nil="true" />
+        <FundsConfirmationResult xsi:nil="true" />
+        <CustomerResponseCode xsi:nil="true" />
+      </PostInquiryResult>
+    </PostInquiryResponse>
+  </soap:Body>
+</soap:Envelope>

data/lib/giact_verification/requests/support/pass_response.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+  <soap:Body>
+    <PostInquiryResponse xmlns="http://api.giact.com/verificationservices/v5">
+      <PostInquiryResult>
+        <ItemReferenceId>5000001888</ItemReferenceId>
+        <CreatedDate>2017-02-03T11:35:43.242182-06:00</CreatedDate>
+        <VerificationResponse>Pass</VerificationResponse>
+        <AccountResponseCode>_1111</AccountResponseCode>
+        <BankName>WELLS FARGO BANK NA (ARIZONA)</BankName>
+        <AccountAddedDate>2008-04-09T00:00:00</AccountAddedDate>
+        <AccountLastUpdatedDate>2010-06-23T00:00:00</AccountLastUpdatedDate>
+        <AccountClosedDate xsi:nil="true" />
+        <FundsConfirmationResult xsi:nil="true" />
+        <CustomerResponseCode>CA11</CustomerResponseCode>
+      </PostInquiryResult>
+    </PostInquiryResponse>
+  </soap:Body>
+</soap:Envelope>

data/lib/giact_verification/response.rb

@@ -0,0 +1,16 @@
+module GiactVerification
+  class Response
+    attr_reader :raw_request, :raw_response, :parsed_response, :success
+
+    def initialize(args)
+      @raw_request     = args[:raw_request]
+      @raw_response    = args[:raw_response]
+      @parsed_response = args[:parsed_response]
+      @success         = args[:success]
+    end
+
+    def success?
+      success
+    end
+  end
+end

data/lib/giact_verification/response_parser.rb

@@ -0,0 +1,35 @@
+require 'ostruct'
+
+module GiactVerification
+  class ResponseParser
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @response  = args[:response]
+    end
+
+    def call
+      if successful_request?
+        OpenStruct.new({ body: giact_xml.inquiry_result, success: true })
+      else
+        OpenStruct.new({ body: {}, success: false })
+      end
+    end
+
+    private
+    attr_reader :response
+
+    def successful_request?
+      response.code == "200" && giact_xml.valid?
+    end
+
+    def giact_xml
+      @giact_xml ||= GiactVerification::GiactXml.new(xml: response.body)
+    end
+  end
+end
+
+

data/lib/giact_verification/templates/inquiry.xml.erb

@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+  <soap:Header>
+    <AuthenticationHeader xmlns="http://api.giact.com/verificationservices/v5">
+      <ApiUsername><%= GiactVerification.configuration.api_username %></ApiUsername>
+      <ApiPassword><%= GiactVerification.configuration.api_password %></ApiPassword>
+    </AuthenticationHeader>
+  </soap:Header>
+  <soap:Body>
+    <PostInquiry xmlns="http://api.giact.com/verificationservices/v5">
+      <Inquiry>
+        <% if @substitutions[:unique_id] %>
+          <UniqueId><%= @substitutions[:unique_id] %></UniqueId>
+        <% end %>
+        <% if @substitutions[:g_verify_enabled] %>
+          <GVerifyEnabled><%= @substitutions[:g_verify_enabled] %></GVerifyEnabled>
+        <% end %>
+        <% if @substitutions[:funds_confirmation_enabled] %>
+          <FundsConfirmationEnabled><%= @substitutions[:funds_confirmation_enabled] %></FundsConfirmationEnabled>
+        <% end %>
+        <% if @substitutions[:g_authenticate_enabled] %>
+          <GAuthenticateEnabled><%= @substitutions[:g_authenticate_enabled] %></GAuthenticateEnabled>
+        <% end %>
+        <% if @substitutions[:voided_check_image_enabled] %>
+          <VoidedCheckImageEnabled><%= @substitutions[:voided_check_image_enabled] %></VoidedCheckImageEnabled>
+        <% end %>
+        <% if @substitutions[:g_identify_enabled] %>
+          <GIdentifyEnabled><%= @substitutions[:g_identify_enabled] %></GIdentifyEnabled>
+        <% end %>
+        <% if @substitutions[:customer_id_enabled] %>
+          <CustomerIdEnabled><%= @substitutions[:customer_id_enabled] %></CustomerIdEnabled>
+        <% end %>
+        <% if @substitutions[:ofac_scan_enabled] %>
+          <OfacScanEnabled><%= @substitutions[:ofac_scan_enabled] %></OfacScanEnabled>
+        <% end %>
+        <% if @substitutions[:g_identify_esi_enabled] %>
+          <GIdentifyEsiEnabled><%= @substitutions[:g_identify_esi_enabled] %></GIdentifyEsiEnabled>
+        <% end %>
+        <% if @substitutions[:ip_address_information_enabled] %>
+          <IpAddressInformationEnabled><%= @substitutions[:ip_address_information_enabled] %></IpAddressInformationEnabled>
+        <% end %>
+        <% if @substitutions[:domain_whois_enabled] %>
+          <DomainWhoisEnabled><%= @substitutions[:domain_whois_enabled] %></DomainWhoisEnabled>
+        <% end %>
+        <% if @substitutions[:mobile_verify_enabled] %>
+          <MobileVerifyEnabled><%= @substitutions[:mobile_verify_enabled] %></MobileVerifyEnabled>
+        <% end %>
+        <% if @substitutions[:mobile_identify_enabled] %>
+          <MobileIdentifyEnabled><%= @substitutions[:mobile_identify_enabled] %></MobileIdentifyEnabled>
+        <% end %>
+        <% if @substitutions[:check] %>
+          <Check>
+            <% if @substitutions[:check][:routing_number] %>
+              <RoutingNumber><%= @substitutions[:check][:routing_number] %></RoutingNumber>
+            <% end %>
+            <% if @substitutions[:check][:account_number] %>
+              <AccountNumber><%= @substitutions[:check][:account_number] %></AccountNumber>
+            <% end %>
+            <% if @substitutions[:check][:account_type] %>
+              <AccountType><%= @substitutions[:check][:account_type] %></AccountType>
+            <% end %>
+            <% if @substitutions[:check][:check_number] %>
+              <CheckNumber><%= @substitutions[:check][:check_number] %></CheckNumber>
+            <% end %>
+            <% if @substitutions[:check][:check_amount] %>
+              <CheckAmount><%= @substitutions[:check][:check_amount] %></CheckAmount>
+            <% end %>
+          </Check>
+        <% end %>
+        <% if @substitutions[:customer] %>
+          <Customer>
+            <% if @substitutions[:customer][:name_prefix] %>
+              <NamePrefix><%= @substitutions[:customer][:name_prefix] %></NamePrefix>
+            <% end %>
+            <% if @substitutions[:customer][:first_name] %>
+              <FirstName><%= @substitutions[:customer][:first_name] %></FirstName>
+            <% end %>
+            <% if @substitutions[:customer][:middle_name] %>
+              <MiddleName><%= @substitutions[:customer][:middle_name] %></MiddleName>
+            <% end %>
+            <% if @substitutions[:customer][:last_name] %>
+              <LastName><%= @substitutions[:customer][:last_name] %></LastName>
+            <% end %>
+            <% if @substitutions[:customer][:name_suffix] %>
+              <NameSuffix><%= @substitutions[:customer][:name_suffix] %></NameSuffix>
+            <% end %>
+            <% if @substitutions[:customer][:address_line1] %>
+              <AddressLine1><%= @substitutions[:customer][:address_line1] %></AddressLine1>
+            <% end %>
+            <% if @substitutions[:customer][:address_line2] %>
+              <AddressLine2><%= @substitutions[:customer][:address_line2] %></AddressLine2>
+            <% end %>
+            <% if @substitutions[:customer][:city] %>
+              <City><%= @substitutions[:customer][:city] %></City>
+            <% end %>
+            <% if @substitutions[:customer][:state] %>
+              <State><%= @substitutions[:customer][:state] %></State>
+            <% end %>
+            <% if @substitutions[:customer][:zip_code] %>
+              <ZipCode><%= @substitutions[:customer][:zip_code] %></ZipCode>
+            <% end %>
+            <% if @substitutions[:customer][:country] %>
+              <Country><%= @substitutions[:customer][:country] %></Country>
+            <% end %>
+            <% if @substitutions[:customer][:phone_number] %>
+              <PhoneNumber><%= @substitutions[:customer][:phone_number] %></PhoneNumber>
+            <% end %>
+            <% if @substitutions[:customer][:tax_id] %>
+              <TaxId><%= @substitutions[:customer][:tax_id] %></TaxId>
+            <% end %>
+            <% if @substitutions[:customer][:date_of_birth] %>
+              <DateOfBirth><%= @substitutions[:customer][:date_of_birth] %></DateOfBirth>
+            <% end %>
+            <% if @substitutions[:customer][:drivers_license_number] %>
+              <DlNumber><%= @substitutions[:customer][:drivers_license_number] %></DlNumber>
+            <% end %>
+            <% if @substitutions[:customer][:drivers_license_state] %>
+              <DlState><%= @substitutions[:customer][:drivers_license_state] %></DlState>
+            <% end %>
+            <% if @substitutions[:customer][:email_address] %>
+              <EmailAddress><%= @substitutions[:customer][:email_address] %></EmailAddress>
+            <% end %>
+            <% if @substitutions[:customer][:current_ip_address] %>
+              <CurrentIpAddress><%= @substitutions[:customer][:current_ip_address] %></CurrentIpAddress>
+            <% end %>
+            <% if @substitutions[:customer][:mobile_consent_record_id] %>
+              <MobileConsentRecordId><%= @substitutions[:customer][:mobile_consent_record_id] %></MobileConsentRecordId>
+            <% end %>
+            <% if @substitutions[:customer][:alternative_id_type] %>
+              <AltIdType><%= @substitutions[:customer][:alternative_id_type] %></AltIdType>
+            <% end %>
+            <% if @substitutions[:customer][:alternative_id_issuer] %>
+              <AltIdIssuer><%= @substitutions[:customer][:alternative_id_issuer] %></AltIdIssuer>
+            <% end %>
+            <% if @substitutions[:customer][:alternative_id_number] %>
+              <AltIdNumber><%= @substitutions[:customer][:alternative_id_number] %></AltIdNumber>
+            <% end %>
+            <% if @substitutions[:customer][:domain] %>
+              <Domain><%= @substitutions[:customer][:domain] %></Domain>
+            <% end %>
+          </Customer>
+        <% end %>
+      </Inquiry>
+    </PostInquiry>
+  </soap:Body>
+</soap:Envelope>

data/lib/giact_verification/validators/check_validator.rb

@@ -0,0 +1,27 @@
+require 'dry-validation'
+
+CheckValidator = Dry::Validation.Schema do
+
+  configure do
+    config.messages_file = File.join(GiactVerification.config_directory, 'check_validator_errors.yml')
+
+    def valid_account_type?(account_type)
+      GiactVerification.valid_account_type?(account_type)
+    end
+
+    def routing_number_length?(routing_number)
+      routing_number.to_s.size == 9
+    end
+
+    def account_number_length?(account_number)
+      (4..17).include?(account_number.to_s.size)
+    end
+  end
+
+  required(:routing_number) { filled? & number? & routing_number_length? }
+  required(:account_number) { filled? & number? & account_number_length? }
+
+  optional(:check_number)   { none? | (filled? & number?) }
+  optional(:check_amount)   { none? | (filled? & number?) }
+  optional(:account_type)   { none? | (filled? & str? & valid_account_type? ) }
+end

data/lib/giact_verification/validators/customer_validator.rb

@@ -0,0 +1,77 @@
+require 'dry-validation'
+
+CustomerValidator = Dry::Validation.Schema do
+
+  configure do
+    config.messages_file = File.join(GiactVerification.config_directory, 'customer_validator_errors.yml')
+
+    def serviced_state?(state)
+      GiactVerification.servicing?(state.upcase)
+    end
+
+    def serviced_country?(country)
+      GiactVerification.servicing_country?(country.upcase)
+    end
+
+    def postal_code?(value)
+      [5, 7, 10].include?(value.to_s.length)
+    end
+
+    def phone_number_format?(value)
+      value.to_s =~ /[1-9][0-9]{9}/
+    end
+
+    def phone_number_length?(value)
+      value.to_s.length == 10
+    end
+
+    def last_four_ssn_length?(value)
+      value.to_s.length == 4
+    end
+
+    def ssn_or_ein_length?(value)
+      value.to_s.length == 9
+    end
+
+    def respond_to_strftime?(value)
+      value.respond_to?(:strftime)
+    end
+
+    def drivers_license_length?(value)
+      (1..28).include?(value.to_s.length)
+    end
+
+    def accepted_alternative_id?(id_type)
+      GiactVerification.accepts_id_type?(id_type)
+    end
+
+    def alternative_id_number_length?(alternative_id_number)
+      (1..50).include?(alternative_id_number.to_s.length)
+    end
+  end
+
+  optional(:name_prefix) { none?   | size?(1..4)  }
+  required(:first_name)  { filled? & size?(2..40) }
+  optional(:middle_name) { none?   | size?(1..40) }
+  required(:last_name)   { filled? & size?(2..40) }
+  optional(:name_suffix) { none?   | size?(1..4)  }
+
+  required(:address_line1)            { filled? & size?(2..40) }
+  optional(:address_line2)            { none?   | empty? | size?(1..40) }
+  required(:city)                     { filled? & size?(2..25) }
+  required(:state)                    { filled? & size?(2) & serviced_state? }
+  required(:zip_code)                 { filled? & number? & postal_code? }
+  optional(:country)                  { none? | (filled? & serviced_country?) }
+  optional(:phone_number)             { none? | (number? & phone_number_length? & phone_number_format?) }
+  required(:tax_id)                   { filled? & number? & (last_four_ssn_length? | ssn_or_ein_length?) }
+  required(:date_of_birth)            { filled? & (date? | date_time? | respond_to_strftime?) }
+  optional(:drivers_license_number)   { none? | drivers_license_length? }
+  optional(:drivers_license_state)    { none? | (filled? & serviced_state?) }
+  optional(:email_address)            { none? | size?(1..100) }
+  optional(:current_ip_address)       { none? | size?(1..15) }
+  optional(:mobile_consent_record_id) { none? | number? }
+  optional(:alternative_id_type)      { none? | accepted_alternative_id? }
+  optional(:alternative_id_issuer)    { none? | (str? & size?(1..50)) }
+  optional(:alternative_id_number)    { none? | (number? & alternative_id_number_length?) }
+  optional(:domain)                   { none? | (str? & size?(1..100)) }
+end