initiateIDVServerBiometricAuthentication

API: initiateIDVServerBiometricAuthentication

📌 Overview

initiateIDVServerBiometricAuthentication is used to initiate a server-side selfie biometric authentication flow. It captures a live selfie from the user and sends it to the REL-ID backend for verification against the stored biometric template.

🔁 Flow Trigger

This API triggers the following SDK event sequence:

1. getIDVSelfieProcessStartConfirmation – to get user confirmation to proceed
2. onIDVServerBiometricAuthenticationResult – returns the result of authentication

🧑‍💻 Method Signature

React Native / Cordova / Native Android / iOS

RdnaClient.initiateIDVServerBiometricAuthentication();

🧾 Parameters

This API does not require any input parameters.

📤 Response

This API does not return a direct synchronous response. It triggers the following event:

Event: onIDVServerBiometricAuthenticationResult

{
  "status": "SUCCESS" | "FAILED",
  "errorCode": number,
  "message": "Authentication result message"
}

📲 User Interface Impact

The SDK handles:

• Displaying the selfie capture UI
• Invoking the result screen or error screens if capture fails or authentication does not match

The host app must:

• Display the confirmation UI when getIDVSelfieProcessStartConfirmation is triggered
• Optionally show retry or fallback options based on the event result

❌ Error Scenarios

🧪 Sample Code

RdnaClient.initiateIDVServerBiometricAuthentication();

rdna.initiateIDVServerBiometricAuthentication();

com.uniken.rdnaplugin.RdnaClient.initiateIDVServerBiometricAuthentication();

rdnaClient.initiateIDVServerBiometricAuthentication();

[self.rdnaClient initiateIDVServerBiometricAuthentication];