LG-13005: use TransactionStatus to determine if document passed TrueID

app/presenters/image_upload_response_presenter.rb

@@ -51,7 +51,7 @@ def as_json(*)
       end
       json[:hints] = true if show_hints?
       json[:ocr_pii] = ocr_pii
-      json[:result_failed] = doc_auth_result_failed?
+      json[:result_failed] = doc_auth_failed?
       json[:result_code_invalid] = result_code_invalid?
       json[:doc_type_supported] = doc_type_supported?
       json[:selfie_status] = selfie_status if show_selfie_failures?
@@ -73,8 +73,8 @@ def result_code_invalid?
       !attention_with_barcode?
   end
 
-  def doc_auth_result_failed?
-    @form_response.to_h[:doc_auth_result] == DocAuth::LexisNexis::ResultCodes::FAILED.name
+  def doc_auth_failed?
+    @form_response.to_h[:transaction_status] == 'failed'
   end
 
   def show_hints?

app/services/doc_auth/error_generator.rb

@@ -127,7 +127,7 @@ def get_doc_auth_errors(response_info, known_error_count)
     def get_doc_auth_error_messages(response_info)
       errors = Hash.new { |hash, key| hash[key] = Set.new }
 
-      if response_info[:doc_auth_result] != LexisNexis::ResultCodes::PASSED.name
+      if response_info[:transaction_status] != 'passed'
         response_info[:processed_alerts][:failed]&.each do |alert|
           alert_msg_hash = ErrorGenerator::ALERT_MESSAGES[alert[:name].to_sym]
 
@@ -370,28 +370,10 @@ def scan_for_unknown_alerts(response_info)
       unknown_fail_count
     end
 
-    # This method replicates TrueIdResponse::attention_with_barcode? and
-    # should be removed/updated when that is.
-    def attention_with_barcode_result(doc_auth_result, processed_alerts)
-      attention_result_name = LexisNexis::ResultCodes::ATTENTION.name
-      barcode_alerts = processed_alerts[:failed]&.count.to_i == 1 &&
-                       processed_alerts.dig(:failed, 0, :name) == '2D Barcode Read' &&
-                       processed_alerts.dig(:failed, 0, :result) == 'Attention'
-
-      doc_auth_result == attention_result_name && barcode_alerts
-    end
-
-    def doc_auth_passed_or_attn_with_barcode(response_info)
-      doc_auth_result = response_info[:doc_auth_result]
-      processed_alerts = response_info[:processed_alerts]
-
-      doc_auth_result_passed = doc_auth_result == LexisNexis::ResultCodes::PASSED.name
-      doc_auth_result_passed || attention_with_barcode_result(doc_auth_result, processed_alerts)
-    end
-
     def doc_auth_error_count(response_info)
-      doc_auth_passed_or_attn_with_barcode(response_info) ?
-        0 : response_info[:alert_failure_count]
+      return 0 if response_info[:transaction_status] == 'passed'
+
+      response_info[:alert_failure_count]
     end
   end
 end

app/services/doc_auth/lexis_nexis/responses/true_id_response.rb

@@ -39,8 +39,6 @@ def initialize(http_response, config, liveness_checking_enabled = false,
 
         ## returns full check success status, considering all checks:
         #    vendor (document and selfie if requested)
-        #    document type
-        #    bar code attention
         def successful_result?
           doc_auth_success? &&
             (@liveness_checking_enabled ? selfie_passed? : true)
@@ -49,16 +47,9 @@ def successful_result?
         # all checks from document perspectives, without considering selfie:
         #  vendor (document only)
         #  document_type
-        #  bar code attention
         def doc_auth_success?
           # really it's everything else excluding selfie
-          ((transaction_status_passed? &&
-            true_id_product.present? &&
-            product_status_passed? &&
-            doc_auth_result_passed?
-           ) ||
-            attention_with_barcode?
-          ) && id_type_supported?
+          transaction_status_passed? && id_type_supported?
         end
 
         def error_messages
@@ -93,9 +84,8 @@ def extra_attributes
         def attention_with_barcode?
           return false unless doc_auth_result_attention?
 
-          parsed_alerts[:failed]&.count.to_i == 1 &&
-            parsed_alerts.dig(:failed, 0, :name) == '2D Barcode Read' &&
-            parsed_alerts.dig(:failed, 0, :result) == 'Attention'
+          !!parsed_alerts[:failed]&.
+            any? { |alert| alert[:name] == '2D Barcode Read' && alert[:result] == 'Attention' }
         end
 
         def billed?

app/services/doc_auth/mock/result_response.rb

@@ -22,6 +22,7 @@ def initialize(uploaded_file, config, selfie_required = false)
           selfie_quality_good: selfie_quality_good?,
           selfie_status: selfie_status,
           extra: {
+            transaction_status: transaction_status,
             doc_auth_result: doc_auth_result,
             portrait_match_results: portrait_match_results,
             billed: true,
@@ -39,6 +40,7 @@ def errors
           if file_data.blank?
             {}
           else
+            transaction_status = file_data.dig('transaction_status')
             doc_auth_result = file_data.dig('doc_auth_result')
             image_metrics = file_data.dig('image_metrics')
             failed = file_data.dig('failed_alerts')&.dup
@@ -47,6 +49,7 @@ def errors
             classification_info = file_data.dig('classification_info')
             # Pass and doc type is ok
             has_fields = [
+              transaction_status,
               doc_auth_result,
               image_metrics,
               failed,
@@ -59,10 +62,11 @@ def errors
               # Error generator is not to be called when it's not failure
               # allows us to test successful results
               return {} if all_doc_capture_values_passing?(
-                doc_auth_result, id_type_supported?
+                transaction_status, id_type_supported?
               )
 
               mock_args = {}
+              mock_args[:transaction_status] = transaction_status if transaction_status.present?
               mock_args[:doc_auth_result] = doc_auth_result if doc_auth_result.present?
               mock_args[:image_metrics] = image_metrics.symbolize_keys if image_metrics.present?
               mock_args[:failed] = failed.map!(&:symbolize_keys) unless failed.nil?
@@ -91,7 +95,8 @@ def success?
       end
 
       def attention_with_barcode?
-        parsed_alerts == [ATTENTION_WITH_BARCODE_ALERT]
+        !!parsed_alerts&.
+          any? { |alert| alert['name'] == '2D Barcode Read' && alert['result'] == 'Attention' }
       end
 
       def self.create_network_error_response
@@ -105,10 +110,14 @@ def self.create_network_error_response
       end
 
       def doc_auth_success?
-        (doc_auth_result_from_uploaded_file == 'Passed' ||
+        return false unless id_type_supported?
+        return false if transaction_status_from_uploaded_file == 'failed'
+        return true if transaction_status_from_uploaded_file == 'passed'
+        return false if doc_auth_result_from_uploaded_file == 'Failed'
+
+        doc_auth_result_from_uploaded_file == 'Passed' ||
           errors.blank? ||
-          attention_with_barcode?
-        ) && id_type_supported?
+          (attention_with_barcode? && parsed_alerts.length == 1)
       end
 
       def selfie_status
@@ -154,6 +163,14 @@ def doc_auth_result_from_uploaded_file
         parsed_data_from_uploaded_file&.[]('doc_auth_result')
       end
 
+      def transaction_status
+        transaction_status_from_uploaded_file || transaction_status_from_success
+      end
+
+      def transaction_status_from_uploaded_file
+        parsed_data_from_uploaded_file&.[]('transaction_status')
+      end
+
       def portrait_match_results
         parsed_data_from_uploaded_file.dig('portrait_match_results')&.
           transform_keys! { |key| key.to_s.camelize }&.
@@ -166,15 +183,23 @@ def classification_info
       end
 
       def doc_auth_result_from_success
-        if success?
+        if doc_auth_success?
           DocAuth::LexisNexis::ResultCodes::PASSED.name
         else
           DocAuth::LexisNexis::ResultCodes::CAUTION.name
         end
       end
 
-      def all_doc_capture_values_passing?(doc_auth_result, id_type_supported)
-        doc_auth_result == 'Passed' &&
+      def transaction_status_from_success
+        if doc_auth_success?
+          'passed'
+        else
+          'failed'
+        end
+      end
+
+      def all_doc_capture_values_passing?(transaction_status, id_type_supported)
+        transaction_status == 'passed' &&
           id_type_supported &&
           (selfie_check_performed? ? selfie_passed? : true)
       end
@@ -194,7 +219,6 @@ def parse_uri
         # no-op, allows falling through to YAML parsing
       end
 
-      ATTENTION_WITH_BARCODE_ALERT = { 'name' => '2D Barcode Read', 'result' => 'Attention' }.freeze
       DEFAULT_FAILED_ALERTS = [{ name: '2D Barcode Read', result: 'Failed' }].freeze
       DEFAULT_IMAGE_METRICS = {
         front: {
@@ -212,6 +236,7 @@ def parse_uri
       }.freeze
 
       def create_response_info(
+        transaction_status: 'failed',
         doc_auth_result: 'Failed',
         passed: [],
         failed: DEFAULT_FAILED_ALERTS,
@@ -222,6 +247,7 @@ def create_response_info(
         merged_image_metrics = DEFAULT_IMAGE_METRICS.deep_merge(image_metrics)
         {
           vendor: 'Mock',
+          transaction_status: transaction_status,
           doc_auth_result: doc_auth_result,
           processed_alerts: {
             passed: passed,

spec/controllers/idv/image_uploads_controller_spec.rb

@@ -458,7 +458,7 @@
           product_status: nil,
           reference: nil,
           transaction_reason_code: nil,
-          transaction_status: nil,
+          transaction_status: 'passed',
           vendor: nil,
           workflow: an_instance_of(String),
           birth_year: 1938,
@@ -1190,7 +1190,7 @@
           product_status: nil,
           reference: nil,
           transaction_reason_code: nil,
-          transaction_status: nil,
+          transaction_status: 'failed',
           vendor: nil,
           workflow: an_instance_of(String),
           birth_year: nil,

spec/fixtures/ial2_test_credential_back_fail_doc_auth_face_match_errors.yml

@@ -1,3 +1,4 @@
+transaction_status: failed
 portrait_match_results:
   FaceMatchResult: Fail
   FaceErrorMessage: 'Successful. Liveness: Live'

spec/fixtures/ial2_test_credential_back_fail_doc_auth_liveness_errors.yml

@@ -1,3 +1,4 @@
+transaction_status: failed
 portrait_match_results:
   FaceMatchResult: Fail
   FaceErrorMessage: 'Liveness: NotLive'

spec/fixtures/ial2_test_credential_barcode_attention_liveness_fail.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 portrait_match_results:
   # returns the portrait match result
   FaceMatchResult: Fail

spec/fixtures/ial2_test_credential_classification_info_no_name.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 document:
   address1: 1800 F Street
   address2: Apt 3

spec/fixtures/ial2_test_credential_doc_auth_attention_face_match_fail.yml

@@ -1,3 +1,4 @@
+transaction_status: failed
 failed_alerts:
   - name: unexpected attention alert
     result: Attention

spec/fixtures/ial2_test_credential_doc_auth_fail_and_no_liveness.yml

@@ -1,3 +1,4 @@
+transaction_status: failed
 portrait_match_results:
   # returns the portrait match result
   FaceMatchResult: Fail

spec/fixtures/ial2_test_credential_doc_auth_fail_face_match_fail.yml

@@ -1,3 +1,4 @@
+transaction_status: failed
 failed_alerts: []
 portrait_match_results:
   FaceMatchResult: Fail

spec/fixtures/ial2_test_credential_doc_auth_fail_selfie_pass.yml

@@ -1,3 +1,4 @@
+transaction_status: failed
 failed_alerts: []
 portrait_match_results:
   FaceMatchResult: Pass

spec/fixtures/ial2_test_credential_doc_auth_selfie_pass_pii_fail.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 document:
   first_name: Jane
   last_name: Doe

spec/fixtures/ial2_test_credential_face_match_fail_and_pii_fail.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 document:
   first_name: Jane
   last_name: Doe

spec/fixtures/ial2_test_credential_liveness_fail_face_match_fail.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 document:
   first_name: 'John'
   last_name: 'Doe'

spec/fixtures/ial2_test_credential_no_liveness.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 portrait_match_results:
   # returns the portrait match result
   FaceMatchResult: Fail

spec/fixtures/ial2_test_credential_poor_quality.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 portrait_match_results:
   # returns the portrait match result
   FaceMatchResult: Fail

spec/fixtures/ial2_test_portrait_match_success.yml

@@ -1,3 +1,4 @@
+transaction_status: passed
 document:
   address1: '1 FAKE RD'
   city: 'GREAT FALLS'

spec/fixtures/proofing/lexis_nexis/true_id/true_id_response_attention_barcode.json

@@ -327,7 +327,7 @@
         "Name": "Alert_1_AuthenticationResult",
         "Values": [
           {
-            "Value": "Passed",
+            "Value": "Failed",
             "Detail": "Verified the presence of a pattern on the visible image."
           }
         ]

spec/fixtures/proofing/lexis_nexis/true_id/true_id_response_failure_no_liveness.json

@@ -15,7 +15,7 @@
       "ProductType": "TrueID",
       "ExecutedStepName": "True_ID_Step",
       "ProductConfigurationName": "AndreV3_TrueID_Flow",
-      "ProductStatus": "pass",
+      "ProductStatus": "fail",
       "ParameterDetails": [
         {
           "Group": "AUTHENTICATION_RESULT",

spec/fixtures/proofing/lexis_nexis/true_id/true_id_response_failure_no_liveness_low_dpi.json

@@ -15,7 +15,7 @@
       "ProductType": "TrueID",
       "ExecutedStepName": "True_ID_Step",
       "ProductConfigurationName": "AndreV3_TrueID_Flow",
-      "ProductStatus": "pass",
+      "ProductStatus": "fail",
       "ParameterDetails": [
         {
           "Group": "AUTHENTICATION_RESULT",

spec/fixtures/proofing/lexis_nexis/true_id/true_id_response_failure_with_all_failures.json

@@ -15,7 +15,7 @@
       "ProductType": "TrueID",
       "ExecutedStepName": "True_ID_Step",
       "ProductConfigurationName": "AndreV3_TrueID_Flow",
-      "ProductStatus": "pass",
+      "ProductStatus": "fail",
       "ParameterDetails": [
         {
           "Group": "AUTHENTICATION_RESULT",

spec/fixtures/proofing/lexis_nexis/true_id/true_id_response_failure_with_face_match_pass.json

@@ -15,7 +15,7 @@
       "ProductType": "TrueID",
       "ExecutedStepName": "True_ID_Step",
       "ProductConfigurationName": "AndreV3_TrueID_Flow",
-      "ProductStatus": "pass",
+      "ProductStatus": "fail",
       "ParameterDetails": [
         {
           "Group": "AUTHENTICATION_RESULT",

spec/fixtures/proofing/lexis_nexis/true_id/true_id_response_failure_with_liveness.json

@@ -15,7 +15,7 @@
       "ProductType": "TrueID",
       "ExecutedStepName": "True_ID_Step",
       "ProductConfigurationName": "AndreV3_TrueID_Flow",
-      "ProductStatus": "pass",
+      "ProductStatus": "fail",
       "ParameterDetails": [
         {
           "Group": "AUTHENTICATION_RESULT",

spec/forms/idv/api_image_upload_form_spec.rb

@@ -253,7 +253,7 @@
           doc_auth_success: boolean,
           selfie_status: anything,
           vendor: nil,
-          transaction_status: nil,
+          transaction_status: 'passed',
           transaction_reason_code: nil,
           workflow: 'test_non_liveness_workflow',
           birth_year: 1938,
@@ -373,7 +373,7 @@
             doc_auth_success: boolean,
             selfie_status: :success,
             vendor: nil,
-            transaction_status: nil,
+            transaction_status: 'passed',
             transaction_reason_code: nil,
             workflow: 'test_liveness_workflow',
             birth_year: 1938,

spec/presenters/image_upload_response_presenter_spec.rb

@@ -198,7 +198,7 @@
               front: t('doc_auth.errors.not_a_file'),
               hints: true,
             },
-            extra: { doc_auth_result: 'Failed', remaining_submit_attempts: 3 },
+            extra: { transaction_status: 'failed', remaining_submit_attempts: 3 },
           )
         end