Skip to main content

KYC Customizing the Verification Flow

iDenfy's identity verification flow can be tailored to better suit your specific onboarding process. You can adjust various aspects, including:

Adjusting UI Steps & Language​

You can streamline the user experience by pre-filling or limiting choices for certain screens using parameters in your token generation request:

  • Country Selection (country): Pre-select the user's country.
  • Document Selection (documents): Limit the types of documents the user can choose.
    note

    Skipping the document selection screen entirely is only possible if you restrict the choice to a single document type (e.g., only PASSPORT) within the documents array for that session.

  • Language (locale): Set a specific language for the UI. Alternatively, iDenfy can attempt to auto-detect the user's language based on their IP address (defaulting to English if the detected language isn't supported).
  • Instructions & Confirmations: Certain instruction screens or photo confirmation steps can also be skipped.

To enable skipping specific screens not directly controlled by API parameters - contact our techsupport.

Configuring Manual Review & Webhooks​

By default, verifications undergo both automatic checks and a manual review by iDenfy staff for enhanced security and accuracy. Manual review can correct potential OCR errors but adds time to the final result (on avg. ~2min.).

You can customize this:

  1. Enable/Disable Manual Review: Choose whether to include the manual review step based on your risk tolerance and speed requirements.
  2. Configure Webhook Delivery: Choose how you receive results via webhooks:
    • One Webhook (Default): Receive only the final result after all checks (including manual review, if enabled) are complete.
    • Two Webhooks: Receive a preliminary result based on the automatic check first, followed by the final result later. This allows you to potentially grant limited access while waiting for the final confirmation. The final result webhook will contain the status "final": true.

Setting Up Redirects​

Instead of showing iDenfy's default result pages, you can redirect users back to your own website or application URLs after certain stages of the verification process.

Configure redirect URLs either in the session token request or globally for your account via the iDenfy dashboard (or by contacting support):

  • successUrl: Redirect destination after a verification is successfully completed (final result).
  • errorUrl: Redirect destination after a verification fails (final result).
  • unverifiedUrl: Redirect destination if the verification isn't fully analyzed (e.g., user cancels early, an unexpected error occurs).
View Examples of iDenfy's Default Result Pages

Controlling Redirect Timing​

You can adjust when the redirection happens using these account settings:

  1. Immediate Redirect:

    • If ON: Redirects the user to successUrl or errorUrl immediately after the automatic check finishes, based on its result. The user won't see the "waiting for manual review" screen.
    • If OFF (Default): Redirects happen only after the final verification result is determined (including manual review, if enabled).

  2. Skip Waiting for Results:

    • Requires Immediate Redirect to be ON.
    • If ON: Redirects the user to unverifiedUrl immediately after they submit their documents, regardless of the verification status. The user skips both the automatic check waiting time and the manual review waiting time.
Important

Redirects (successUrl, errorUrl, unverifiedUrl) should not be used when integrating via iFrame, as they can cause issues with the user experience within the frame.

Adding Custom Steps​

You can include additional steps in the flow, such as requesting utility bills, bank statements, or other custom file uploads. These uploads are provided to you but are not typically evaluated manually by iDenfy unless specifically arranged.

Mobile SDK Customization​

Our native Android SDK and iOS SDK offer further platform-specific flow customization options beyond the standard API controls.

Non-API Session Creation

If you are not using our API for session creation, you can configure many of these same parameters when creating verification sessions manually through the iDenfy administration platform.