getIDVSelfieProcessStartConfirmation
📸 Event Documentation: getIDVSelfieProcessStartConfirmation
getIDVSelfieProcessStartConfirmation🧾 Overview
This event is triggered by the REL-ID IDV SDK before initiating selfie capture as part of the identity verification (IDV) workflow.
It gives the application a chance to:
- Inform the user about the upcoming selfie capture
- Prepare the UI for the action
- Let the user choose whether to proceed with selfie capture
🖥️ Screen to Present
Display a screen with the following elements:
- Informational message:
- "In order to activate your account, we need to verify your identity."
- "Please ensure you're in a well-lit area before taking the selfie."
- Action buttons:
- Proceed / Start / Submit — invokes the response API
📤 Event Response
On "Proceed", the application must invoke the setIDVSelfieProcessStartConfirmation API.
📦 Event Listener Implementation
React Native
EventEmitter.addListener('getIDVSelfieProcessStartConfirmation', getIDVSelfieProcessStartConfirmation);
const getIDVSelfieProcessStartConfirmation = (response: any) => {
// response.idvWorkflow
}Flutter
rdna.on(RdnaClient.getIDVSelfieProcessStartConfirmation, getIDVSelfieProcessStartConfirmation);
getIDVSelfieProcessStartConfirmation(dynamic response) {
// response.idvWorkflow
}Cordova
document.addEventListener('getIDVSelfieProcessStartConfirmation', getIDVSelfieProcessStartConfirmation, false);Native iOS
(void)getIDVSelfieProcessStartConfirmation:(RDNAIDVWorkflow)workflow;Native Android
void getIDVSelfieProcessStartConfirmation(String response);🧾 Payload Field
| Field | Type | Description |
|---|---|---|
idvWorkflow | Enum | Indicates the current IDV workflow context |
🔁 Response API: setIDVSelfieProcessStartConfirmation
setIDVSelfieProcessStartConfirmation🧾 Overview
This API must be called by the application after user confirmation to proceed with selfie capture.
✅ Parameters
| Name | Type | Description |
|---|---|---|
isConfirm | boolean | true to proceed, false to cancel and redirect |
useDeviceBackCamera | boolean | true to use back camera, false for front |
idvWorkflow | Enum | Value received in event payload |
🔄 Platform Snippets
React Native
RdnaClient.setIDVSelfieProcessStartConfirmation(
true,
false,
idvWorkflow,
(response) => {}
);Flutter
rdna.setIDVSelfieProcessStartConfirmation(true, false, idvWorkflow);Cordova
com.uniken.rdnaplugin.RdnaClient.setIDVSelfieProcessStartConfirmation(
successCallback,
errorCallback,
[true, false, idvWorkflow]
);Native iOS
(RDNAError*)setIDVSelfieProcessStartConfirmation:(BOOL)isConfirm
useDeviceBackCamera:(BOOL)useBackCamera
idvWorkflow:(RDNAIDVWorkflow)workflow;Native Android
RDNA.RDNAError setIDVSelfieProcessStartConfirmation(boolean isConfirm,
boolean useBackCamera,
RDNAIDVWorkflow workflow);⚠️ Error Codes
| Code | Message | Developer Action |
|---|---|---|
| 146 | Identity verification canceled | Redirect to getUser or fallback screen |
✅ Developer Actions
On Success:
- SDK proceeds to launch the selfie capture interface
On Failure or Cancel:
- SDK ends the flow and redirects via fallback events
Updated 3 months ago