🔁 Migration Guide: v25.03.06 ➝ v25.04.06 (22-May-2025)

This guide details the required changes to migrate your Native SDK integration from v25.03.06 to v25.04.06.

⚠️ Breaking Changes

❌ Removed APIs

• initiatePalmBiometricVerification()
• setIDVPalmVeinBiometricProcessStartConfirmation()

❌ Removed Callbacks

• getIDVPalmVeinBiometricProcessStartConfirmation()
• onIDVPalmVeinBiometricVerifyResponse()

These palm-related APIs and callbacks have been deprecated and are no longer supported in v25.04.06.

✨ New Additions

🆕 New APIs

• extendSessionIdleTimeout()
  Use this to extend user session just before idle timeout, improving UX and preventing forced logouts.

🆕 New Callbacks (must be implemented by the app)

• onSessionTimeOutNotification()
  Triggered to warn the app before session expiry.
• onSessionExtensionResponse()
  Informs the app whether a session extension was successful.

🌐 Localization Updates

Update the IDV Core localization string files in both Android and iOS to align with the new SDK version's messaging and labels.

🔧 Android – Regula Library Updates

Update your Gradle project dependencies:

implementation 'com.regula.documentreader.core:fullauthrfid:7.7.13549@aar'
implementation('com.regula.documentreader:api:7.7.11299@aar') {
    transitive = true
}

🧾 NFC Certificate Update

Ensure proper certificate for passive authentication is in place:

• ✅ Use: icaopkd-002-complete-000310
• ❌ Remove: icaopkd-002-complete-000294

Platform-specific Notes:

• Android: Replace the .ldif file
• iOS: Replace Certificate.bundle

🧩 Minimum Backend Requirement

🚨

REL-ID Server version 25.04.02 or higher is required

Critical backend support includes:

• Proper Forgot Password behavior (without requiring unnecessary activation)
• Automatic session termination upon device deletion/status update via GM API

✅ Summary Checklist

• Remove deprecated palm biometric APIs and callbacks
• Implement new session timeout callbacks
• Update localization string files
• Update Regula libraries in Android project
• Replace PKD certificate for NFC scan
• Ensure REL-ID server is updated to v25.04.02 or higher