--- icon: checklist label: Use cases order: 900 expanded: false --- This section describes the integrating use cases for VerifEye's Redirect. ## Use cases Verification setup All the below examples use the following setup: - Liveness Verifier in Verification mode - Age Verifier in Threshold Verification mode (Above 18) - Face Recognition Verifier in Calculation Only mode - Gender Verifier in Calculation Only mode - They use the same collection - For testing purposes in this example we disabled `ForceSignedInput` — this is strongly recommended to keep enabled in production environments. For more details, see the [Security page](/redirect/security/#incoming-signed-verification-url-request-integrity). ## Use case: Full-page redirect **When to use** - simplest integration; users leave your site temporarily and come back via redirect **How it works (conceptually)** - you send the user to the VerifEye verification URL - the user completes the verification - VerifEye redirects the browser to your result URL with the outcome in the query string parameters **Recommended** - validate `reSignature` server-side to avoid result tampering [!ref text="For more information about the signature, check out the Security page"](/redirect/security/) **Example** In this example we use the EU service. - Verification URL: https://verifeye-service-eu.realeyes.ai/verification/e4fc930b-d780-47e3-ae4c-0d5d2f22e54e _(note: `ForceSignedInput` is disabled on this verification for testing — do not do this in production)_ - Target URL (configured for the Verification): https://example.com - Result URL example (Target URL with the outcome for a specific session in the query string parameters): ``` https://example.com/?reVerificationSessionId=7a429371-f918-4900-bf1b-14a76e551042&reFaceId=99a9e4e3ac75406ebd638f95bc4f0b30&reVerificationResult=passed&reLivenessResult=passed&reFaceRecognitionResult=passed&reAgeVerificationResult=passed&reAge=31&reGenderVerificationResult=passed&reGender=male&reSignature=70ac1eb0762395c831a09f53f854ca7e9745bf5755b83ed8137ed21dec9c7307 ``` [!ref text="Click here to try out" target="blank"](https://verifeye-service-eu.realeyes.ai/verification/e4fc930b-d780-47e3-ae4c-0d5d2f22e54e) ## Use case: Embedded iFrame **When to use** - you want the verification flow embedded in your page without full navigation **How it works (conceptually)** - you embed the hosted verification URL in an iFrame - after completion, VerifEye navigates to a result page that posts a message to the parent window containing: - `redirectedTo`: the final result URL **Recommended** - validate `event.origin` on the host page - validate `reSignature` on your backend if you need tamper detection [!ref text="For more information about origin check and the signature, check out the Security page"](/redirect/security/) **Example** - Verification URL: https://verifeye-service-eu.realeyes.ai/verification/3bb1fb37-9d3a-423f-b5bc-1790a329f117 _(note: `ForceSignedInput` is disabled on this verification for testing — do not do this in production)_ - Target URL (configured for the Verification): https://verifeye-docs.realeyes.ai/iframe_popup_result_example.html - Result URL example (Target URL with the outcome for a specific session in the query string parameters): ``` https://verifeye-docs.realeyes.ai/iframe_popup_result_example.html?reVerificationSessionId=d7c09541-03c1-403e-9b3c-146468657f27&reFaceId=99a9e4e3ac75406ebd638f95bc4f0b30&reVerificationResult=passed&reLivenessResult=passed&reFaceRecognitionResult=passed&reAgeVerificationResult=passed&reAge=31&reGenderVerificationResult=passed&reGender=male&reSignature=462cfda7b1999f243867d5a2ab1725624ca7d85d807b7e8d3cb1f285648c0810 ``` [!ref text="Click here to try out" target="blank"](/static/iframe_example.html) The following file is a minimum example for how to use VerifEye iFrame integration :::code source="/static/iframe_example.html" language="js" title="iframe_example.html" ::: This file shows what is set for the Target URL. This is a technical file that is responsible to receive the result query string parameters and send back the whole URL to the hosted site via `postMessage`. :::code source="/static/iframe_popup_result_example.html" language="js" title="iframe_popup_result_example.html" ::: ## Use case: Popup window **When to use** - you want to keep the host page intact and run verification in a separate window **How it works (conceptually)** - you open a popup to the hosted verification URL - after completion, the popup navigates to the result page and posts a message to `window.opener` with: - `redirectedTo`: the final result URL - and finally the popup window closes **Recommended** - handle popup blockers and provide a fallback - validate `event.origin` on the host page - validate `reSignature` on your backend if you need tamper detection [!ref text="For more information about origin check and the signature, check out the Security page"](/redirect/security/) **Example** - Verification URL: https://verifeye-service-eu.realeyes.ai/verification/3bb1fb37-9d3a-423f-b5bc-1790a329f117 _(note: `ForceSignedInput` is disabled on this verification for testing — do not do this in production)_ - Target URL (configured for the Verification): https://verifeye-docs.realeyes.ai/iframe_popup_result_example.html - Result URL example (Target URL with the outcome for a specific session in the query string parameters): ``` https://verifeye-docs.realeyes.ai/iframe_popup_result_example.html?reVerificationSessionId=5048626a-8fb5-4116-bcdf-8754a85bba4a&reFaceId=99a9e4e3ac75406ebd638f95bc4f0b30&reVerificationResult=passed&reLivenessResult=passed&reFaceRecognitionResult=passed&reAgeVerificationResult=passed&reAge=31&reGenderVerificationResult=passed&reGender=male&reSignature=462cfda7b1999f243867d5a2ab1725624ca7d85d807b7e8d3cb1f285648c0810 ``` [!ref text="Click here to try out" target="blank"](/static/popup_example.html) The following file is a minimum example for how to use VerifEye Popup integration :::code source="/static/popup_example.html" language="js" title="popup_example.html" ::: This file shows what is set for the Target URL. This is a technical file that is responsible to receive the result query string parameters and send back the whole URL to the hosted site via `postMessage`. :::code source="/static/iframe_popup_result_example.html" language="js" title="iframe_popup_result_example.html" ::: --- *Last updated: 2026-02-03*