🔄 Event: getIDVSelfieConfirmation

📘 Description

This event is triggered by the REL-ID SDK module to confirm the match result between the document photo and the captured selfie before continuing the activation or KYC workflow.

🎯 Purpose

This event prompts the app to:

• Display the captured selfie
• Show the user portrait from document
• Present the match score and display text
• Ask for user consent to proceed or retry

🧑‍💻 Platform Support

EventEmitter.addListener('getIDVSelfieConfirmation', getIDVSelfieConfirmation);

rdna.on(RdnaClient.getIDVSelfieConfirmation, getIDVSelfieConfirmation);

document.addEventListener('getIDVSelfieConfirmation', getIDVSelfieConfirmation, false);

(void)getIDVSelfieConfirmation:(RDNAChallengeOpMode)mode workflow:(RDNAIDVWorkflow)workflow;

void getIDVSelfieConfirmation(int challengeMode, RDNA.RDNAIDVWorkflow workflow);

📤 Response Format (String based)

{
  "challengeMode":8,
  "response_data":”<<The response_data contains the Selfie Confirmation JSON v3.0>>”
}

Selfie Confirmation JSON v3.0

{
  "response_data": {
    "analyze_liveness_response": {
      "video": {
        "autocapture_result": {
          "selfie_image": "<Base64 Image>"
        },
        "liveness_result": {
          "score": 100
        }
      }
    },
    "face_matcher_response": {
      "score": 4.674335479736328
    },
    "biometric_result": {
      "display_text": "MATCHED",
      "result_criteria": "Greater than or equal to 1.6"
    },
    "document_detail": {
      "document_info": {
        "name": "testUser",
        "age": "28",
        "portrait_image": "<<base 64 String>>"
      }
    }
  },
  "action_buttons": {
    "success_button": [
      {
        "key": "continue-flow",
        "button_text": "Continue"
      }
    ],
    "failure_button": [
      {
        "key": "continue-flow",
        "button_text": "Continue Anyway"
      },
      {
        "key": "reinit-idv-document-scan",
        "button_text": "Rescan Document"
      },
      {
        "key": "reinit-idv-selfie",
        "button_text": "Recapture Selfie"
      }
    ]
  }
}

📦 Selfie Confirmation JSON v3.0 Details

🧠 Developer Tips

🧠 Notes for Developers

• The app must read response_data.biometric_result.display_text to determine whether to auto-confirm or ask for consent.
• Use the action_buttons.success_button and failure_button to render confirmation or retry options.
• All images (like selfie_image, portrait_image) are in base64 format and should be rendered inline in the UI.
• The match score is optional UI indicators and not mandatory for flow control.

🧭 Example User Flow

flowchart TD
    A[SDK triggers getIDVSelfieConfirmation] --> B[App displays selfie, document image, score]
    B --> C{User choice}
    C -->|✅ Confirm| D[App calls setIDVSelfieConfirmation("continue-flow", challengeMode)]
    C -->|🔁 Retake| E[App calls setIDVSelfieConfirmation("reinit-idv-selfie", challengeMode)]

🛠️ Response API: setIDVSelfieConfirmation

Description:

Used by the application to confirm or reject the captured selfie based on user input.

Parameters:

🧠 Action Keys & Their Significance

🔧

Developers must pass one of the above keys as action in setIDVSelfieConfirmation.

💻 API Usage

RdnaClient.setIDVSelfieConfirmation(true, workflow, challengeMode, (response) => {
  // handle RDNAError
});

rdna.setIDVSelfieConfirmation(true, workflow, challengeMode);

com.uniken.rdnaplugin.RdnaClient.setIDVSelfieConfirmation(
  successCallback,
  errorCallback,
  [true, workflow, challengeMode]
);

(RDNAError *)setIDVSelfieConfirmation:(BOOL)isConfirmed
                              workflow:(RDNAIDVWorkflow)workflow
                        challengeMode:(RDNAChallengeOpMode)mode;

RDNA.RDNAError setIDVSelfieConfirmation(boolean isConfirmed,
                                        RDNA.RDNAIDVWorkflow workflow,
                                        int challengeMode);

⚠️ Error Codes

✅ Notes

• Confirmation is a mandatory step after selfie capture
• Failure to call this API will stall the IDV workflow