🔄 Event: getIDVSelfieConfirmation

📘 Description

This event is triggered by the Ditto 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