onIDVServerBiometricAuthenticationResult

Event: onIDVServerBiometricAuthenticationResult

📌 Overview

onIDVServerBiometricAuthenticationResult is an event triggered by the REL-ID SDK after the selfie biometric authentication process is completed. It returns the status of the authentication by comparing the captured selfie with the stored biometric template on the server.

🧠 Purpose

This event communicates the result of the authentication attempt and helps the app take action based on the outcome.

📥 Trigger Source

Triggered after calling:

initiateIDVServerBiometricAuthentication();

📨 Payload Structure

{
  "status": "SUCCESS" | "FAILED",
  "errorCode": 0,
  "message": "Authentication successful"
}

🔑 Payload Fields

Field	Type	Description
`status`	string	Indicates the outcome of the authentication: `SUCCESS` or `FAILED`
`errorCode`	int	Numeric code indicating error cause if any (0 for success)
`message`	string	Description of the authentication result

❌ Error Code Reference

Error Code	Description	Action
0	Authentication successful	Proceed
101	No biometric template found	Prompt biometric opt-in
201	Poor selfie image quality	Retry selfie capture
301	Authentication match failed	Retry or use fallback auth

✅ On Success

Allow user to proceed with secured operation or screen

❌ On Failure

Inform the user
Provide retry option or fallback (e.g., password login)

Code Snippets for Handling `onIDVServerBiometricAuthenticationResult`

React Native

eventEmitter.on('onIDVServerBiometricAuthenticationResult', (result) => {
  if (result.status === 'SUCCESS') {
    // Navigate to secure screen
  } else {
    console.warn('Authentication failed:', result.message);
    // Show retry/fallback
  }
});

Flutter

rdna.onIDVServerBiometricAuthenticationResult((result) {
  if (result['status'] == 'SUCCESS') {
    // Proceed with secure access
  } else {
    print('Failed: ${result['message']}');
    // Offer retry or alternate auth
  }
});

Cordova

document.addEventListener('onIDVServerBiometricAuthenticationResult', function(result) {
  if (result.status === 'SUCCESS') {
    // Authentication success
  } else {
    console.error('Auth failed:', result.message);
    // Handle retry or fallback
  }
});

Native Android

@Override
public void onIDVServerBiometricAuthenticationResult(JSONObject result) {
    String status = result.optString("status");
    if ("SUCCESS".equals(status)) {
        // Continue secure flow
    } else {
        Log.e("BiometricAuth", "Failed: " + result.optString("message"));
        // Show error UI
    }
}

Native iOS (Objective-C)

- (void)onIDVServerBiometricAuthenticationResult:(NSDictionary *)result {
    NSString *status = result[@"status"];
    if ([status isEqualToString:@"SUCCESS"]) {
        // Proceed to secured screen
    } else {
        NSLog(@"Authentication failed: %@", result[@"message"]);
        // Provide retry or fallback option
    }
}

Updated 9 months ago