Skip to main content

Flow customisation possibilities​

iDenfy's identity verification sessions can be configured with different flows that allows additional flexibility on the default flow that is displayed below:

Full flow

Changes may be applied to:

  • Skipping certain steps - country selection, document selection, instructions, uploaded photo confirmation.

  • Forcing specific language in the UI.

  • Setting Max Attempt Counts

  • Including or excluding manual review.

  • Redirection to a URL that was provided in the verification session's request.

  • Adding an additional step, such as utility bills, bank statements, or any picture/file of your description that won't be evaluated manually but could still be needed with each client's application.

  • Additional flow customisation for Android SDK and iOS SDK

Skipping certain steps​

Country selection, document selection, and instructions screens are accompanied with the values that you provide inside the verification session's request. If the country, documents, locale parameters are included inside the request body, these values will be either preselected, or limited(e.g. documents that the user can choose from).

note

Document selection skipping will work only if available documents array size is 1, e.g, you allow only PASSPORT for this specific verification session.

To enable skipping of a certain screen or step, forward your request to tech support via our dashboard

Forcing specific language​

Using the same approach as described before, you can also apply it to default language with the locale parameter. There is also a possibility to detect the IP address location of a client and automatically set the corresponding language. If the client is in a country with a language that we don't support yet, we will display the default language - English.

Including or excluding manual review​

With manual review enabled, it is the final step of the verification when the client's application is being reviewed by iDenfy's staff. Manual review can override iDenfy's automatic check results, and correct OCR errors, if there are any. In comparison with the automatic check, the manual review may make the process longer(an average verification is reviewed within 3-5 minutes), but it is highly recommended to keep the manual review for security purposes.

You can choose if you need to receive 1 or 2 webhooks. With only 1 webhook, you will receive only the final results of each verification. With 2 webhooks, you can receive preliminary(auto reviewed) results, and final(manually revied) results. This will enable more flexibility on how you would like to handle the onboarding process and perhaps providing limited access to the user before the final results arrive. The final results will include "final":true flag inside the webhook's body.

Max Attempt Count​

It indicates how many times user can retry auto review when processing identification before manual review will be executed. For example, with this number as 0, the client must succeed auto review on the first try, with this number as 3, the client can fail auto review for 3 times and succeed on the 4th.

Redirection to a URL​

Redirect Schema

Examples of iDenfy's default pages could be found here:

After the automatic processing part is finished, user can be redirected (if Immediate Redirect setting is turned on) to your provided URLs based on the automatic check results. You can pass URLs inside your session token request or add them inside your environment's configuration so every generated session will already have these URL settings by default without specifying the parameters with API requests. You can also contact techsupport if you need help to set Redirect URLs at account level:

  • successUrl A URL where the client will be redirected after a successful automatic check verification.

  • errorUrl A URL where the client will be redirected after a failed automatic check verification.

  • unverifiedUrl A URL where the client will be redirected after a non-analyzed verification. E.g. user immediately cancels the process or unexpected error occours. Also, in cases when Immediate Redirect and Skip Waiting for Results are turned on, regardless of the verification status, user will be redirected to it.

Redirection functionality shouldn't be used with iframe integration. The timing of when the redirection should happen can also be changed by the two corresponding settings:

Immediate redirect​

Immediate redirect can be turned on if you want your users to be redirected back to "Success" or "Failed" URL, based on the automatic check results. Redirection is done immediately after they submit the verification and pass the automatic check. This way they won't be seeing the waiting window for human supervision confirmation.

Skip waiting for results​

With this option turned on, your user will be immediately redirected to "unverifiedUrl" after they submit the verification, regardless of verification status. This way they won't be waiting for automatic check results. This option is used together with Immediate Redirect. If the Unverified URL is not set or passed, the infinite spinner will be shown for the user.

note

If you do not use our API, you can still create the sessions with the same parameters described above through iDenfy's administration platform.