KYC Redirect WEB UI and iFrame
How to personalise UI, and verification flow adjustments can be found in Help center
Redirect and iFrame Integration
To integrate our identity verification process into your website, we highly recommend using an iFrame integration. This method keeps the user on your site throughout the verification flow, creating a seamless user experience. If an iFrame isn't suitable, you can also use a redirect to send the user to our web interface.
iFrame Integration
To use an iFrame, embed https://ui.idenfy.com/
in your iframe tag with the authToken
query parameter. You can get the authToken
by generating an identification token. Unlike a redirect, an iFrame keeps the user on your site during verification.
To get started, simply embed the URL in an iframe
tag and append the authToken
as a query parameter.
- The
allowfullscreen
attribute is required if you are using our 3D liveness feature. - Do not use
successUrl
,errorUrl
, orunverifiedUrl
when generating the token, as this may break the iFrame flow. - The company's logo will not be displayed inside the verification session's UI.
- After verification, you can close the iFrame and display the next page for your client.
<!DOCTYPE html>
<html>
<body>
<iframe
id="iframe"
allowfullscreen
style="width:80%; height:800px;"
src="https://ui.idenfy.com/?authToken=3FA5TFPA2ZE3LMPGGS1EGOJNJE"
allow="camera"></iframe>
<p id="display"></p>
<script>
window.addEventListener('message', receiveMessage, false);
function receiveMessage(event) {
console.log(event);
// ...
}
</script>
</body>
</html>
Query Parameters
Name | Example Value | Description |
---|---|---|
authToken | 3FA5TFPA2ZE3LMPGGS1EGOJNJE | Authentication token for the verification session. |
lang | en | Optional. Forces a specific iFrame language (e.g., lang=en ). Overrides the locale set during token generation. |
Verification Status
Monitor verification progress via the data
object in the console.
Property | Values | Meaning |
---|---|---|
status | APPROVED / FAILED / UNVERIFIED | Automated check result: approved, denied, or unfinished (timeout/cancel). |
manualStatus | APPROVED / FAILED / WAITING | Manual review result: approved, denied, or pending. |
autoSuspected / manualSuspected | true / false | Flags whether suspicion was raised during automated or manual checks. |
Redirect to Web UI
To start a verification, redirect your client to:
https://ivs.idenfy.com/api/v2/redirect?authToken=
authToken
Where authToken
is the value generated from verification session.
Example:
https://ivs.idenfy.com/api/v2/redirect?authToken=3FA5TFPA2ZE3LMPGGS1EGOJNJE
After the redirect, the user will see the iDenfy verification web UI.

Web SDK
We often get asked if we provide a Web SDK. The short answer: No - and that’s by design.
Instead of adding the extra complexity of maintaining SDK packages, version upgrades, and dependency issues, we provide a superior integration option:
- With iFrame you get always up-to-date verification flow (no SDK updates required).
- Seamless branding with full control over the surrounding page and layout.
- Lighter integration — no additional packages, no breaking changes, no maintenance burden.
- Future-proof stability — your integration won’t be affected by SDK lifecycle or compatibility issues.
This means you can integrate identity verification into your web app quickly, keep the user on your site, and avoid the long-term headaches of SDK management.
If an iFrame isn't suitable for your use case, you can also use a redirect to send the user to our web interface.