initiateAgentKYCforUser

🔍 Overview

initiateAgentKYCforUser is a post-login API used by agent users to initiate the KYC process on behalf of a newly created customer. It captures both document and biometric (selfie) details and allows storing the user's biometric template on the server.

Upon invocation:

• The REL-ID SDK triggers the full KYC flow including:
  1. Document scanning (getIDVDocumentScanProcessStartConfirmation)
  2. Document confirmation (getIDVConfirmDocumentDetails)
  3. Selfie capture (getIDVSelfieProcessStartConfirmation)
  4. Selfie confirmation (getIDVSelfieConfirmation)
  5. Biometric opt-in (getIDVBiometricOptInConsent)

🔐 Preconditions

• This is a post-login API.
• It must be used only when a user session exists.

🧑‍💻 User Flow Summary

1. Triggered post-login to begin KYC verification.
2. Captures document via scanner.
3. Captures and confirms selfie.
4. Asks user consent to store biometric template.
5. Finalizes KYC and returns status.

📱 UI Requirement

The mobile app must present the following screens to the agent user during this workflow:

• 📄 Document Capture Screen (via SDK)
• 📷 Selfie Capture Screen (via SDK)
• ✅ Document Confirmation UI (custom)
• 🎯 Selfie Confirmation UI (custom)
• 🔐 Biometric Consent UI (custom)

📥 Parameters

📤 Return Type

Returns RDNAError JSON indicating success or failure.

Code Snippets

RdnaClient.initiateAgentKYCforUser(userId, reason, (response) => {});

rdna.initiateAgentKYCforUser(userId, reason);

com.uniken.rdnaplugin.RdnaClient.initiateAgentKYCforUser(successCallback, errorCallback, [userId, reason]);

(RDNAError *)initiateAgentKYCforUser:(NSString *)userId reason:(NSString *)reason;

RDNA.RDNAError initiateAgentKYCforUser(String userId, String reason);

🔁 Workflow Events & Actions

1. getIDVDocumentScanProcessStartConfirmation

   • Developer must invoke setIDVDocumentScanProcessStartConfirmation.

2. getIDVConfirmDocumentDetails

   • Developer must invoke setIDVConfirmDocumentDetails.

   • If true → triggers getIDVSelfieProcessStartConfirmation.

   • If false → restarts document scan.

3. getIDVSelfieProcessStartConfirmation

   • Developer invokes setIDVSelfieProcessStartConfirmation.

4. getIDVSelfieConfirmation

   • Developer must invoke setIDVSelfieConfirmation.

👇 Actions for setIDVSelfieConfirmation

5. getIDVBiometricOptInConsent

   • Developer must invoke setIDVBiometricOptInConsent.

6. Completion Event: onIDVActivatedCustomerKYCResponse

   • Sent on KYC success or failure.

✅ On Success

• The SDK will invoke the events in sequence as per KYC flow
• On completion or failure, the event onIDVAgentKYCResponse will be triggered

❌ On Failure

• Developer should handle errors as per RDNAError structure
• Error events can be triggered at any stage in the flow

📌 Developer Notes

• The RDNAChallengeOpMode used in this flow is: RDNA_IDV_API_AGENT_BIOMETRIC_AND_DOCUMENT_SCAN.
• Use this op mode in all related event response APIs.