🧾Configure Document Scan Structure V1 / V3

📘 Overview

REL-ID’s IdvWebServer supports two different document scan data structures:

• V1 (Default): Basic document data extraction.
• V3 (Enhanced): Richer format with detailed field mappings, localization, and validation results.

The V3 structure is required for advanced document-specific validations and for enabling comprehensive identity verification flows.

⚙️ Steps to Enable V3 Scan Structure

To enable V3 document structure, perform the following steps in the GM Portal:

🔧 1. Login to GM Portal

🔧 2. Navigate to Module Config Management

🔧 3. Select the Module → BlaZe-Adapter

🔧 4. Search for the Config Key → sdk.app.settings

🔧 5. If the config is empty:

• Paste the provided samplesdk.app.settings (see below)

🔧 6. If config already exists:

• Change "version": "1.0" to "version": "3.0"

🔧 7. Click Save

🔁 8. Restart Modules:

• BlaZe-Adapter
• IdvWebServer

📦 Sample sdk.app.settings for V3

{
  "idv_sdk_app_config": {
    "version": "3.0",
    "supportedVersions": ["1.0", "3.0"],
    "nfcScanEnabled": true,
    "authenticityChecksEnabled": true,
    "hologramCheckEnabled": false,
    "saveDebugLogs": false,
    "saveCroppedImages": false,
    "nfcScanTimeOut": 45,
    "isRawDataRequired": false
  },
  "idv_sdk_docscan_config_v3": {
    "supported_document_types": {
      "11": {
        "United States": {
          "supported_and_mandatory_fields": {
            "17": false
          },
          "lcid_preference": {
            "*": [0, 1033]
          }
        }
      }
    },
    "generic_supported_and_mandatory_fields": {
      "0": true,
      "2": true,
      "3": true,
      "5": true,
      "8": true,
      "9": true,
      "11": false,
      "12": false,
      "17": true,
      "25": true
    },
    "nfcConfig": {
      "enableNFCStatusScreen": false,
      "errorOnNfcTimedOut": false,
      "errorOnNfcBypass": false,
      "Pkd_cert_url": "",
      "pkd_cert_checksum": ""
    },
    "isRawDataRequiredForKYC": false
  }
}

🧩 Note: Document types, fields, and LCID preferences can be expanded based on country and use case.

🔁 To Revert to V1 Structure

If you wish to switch back to V1:

1. Set "version": "1.0" in sdk.app.settings
2. Restart BlaZe-Adapter and IdvWebServer

⚠️ Notes

• The sdk.app.settings configuration impacts both the IdvWebServer and REL-ID SDK (Mobile App).
• Any changes made to this config are reflected in both environments.
• Ensure changes are tested before deployment in production.

✅ Completion

V1/V3 configuration enables flexible control over document scan formats and processing capabilities. Use V3 for full-scale field validation, regional adaptations, and richer KYC integrations.