Skip to main content
The Direct Link integration provides the simplest way to integrate Urtentic’s identity verification. With minimal development effort, redirect users to a hosted verification flow.

​
Overview

Direct Link allows you to redirect users to a secure, hosted verification page where they complete the identity verification process. Once complete, users are redirected back to your application.

​
URL Structure

https://verify.urtentic.com/?flowId={FLOW_ID}&clientId={CLIENT_ID}&metadata={METADATA}&redirectUrl={REDIRECT_URL}

​
Required Parameters

ParameterDescriptionExample
flowIdYour workflow ID from the dashboarddb50ed08-18fa-41e8-9e46-a44aca39f69d
clientIdYour Urtentic client ID (URL encoded)hpUBmWypQfnIRJXslel8JDZtAEHF9PQjbT2eJQjNkXM%3D

​
Optional Parameters

ParameterDescription
metadataJSON object with custom data (URL encoded)
redirectUrlURL to redirect to after verification (URL encoded)
The metadata parameter accepts any JSON object. You can pass any custom data relevant to your application (user IDs, references, session data, etc.). This metadata will be included in all webhook notifications.

​
Implementation Examples

​
Basic Implementation

const flowId = 'db50ed08-18fa-41e8-9e46-a44aca39f69d';
const clientId = 'hpUBmWypQfnIRJXslel8JDZtAEHF9PQjbT2eJQjNkXM=';

const metadata = {
  userId: '350ff98e3d934ad4bc5301f4504702d4',
  userEmail: '[email protected]',
  reference: 'REF-12345'
};

const baseUrl = 'https://verify.urtentic.com/';
const params = new URLSearchParams({
  flowId: flowId,
  clientId: clientId,
  metadata: JSON.stringify(metadata)
});

const verificationUrl = `${baseUrl}?${params.toString()}`;
window.location.href = verificationUrl;

​
Handling Redirects

When using redirectUrl, users will be redirected to your URL after completing or abandoning the verification: 
https://yourapp.com/verification/complete?flowId=db50ed08-...&status=completed

​
Redirect Parameters

ParameterDescriptionPossible Values
flowIdThe workflow IDYour workflow UUID
statusVerification statuscompleted, abandoned

​
Example Redirect Handler

app.get('/verification/complete', (req, res) => {
  const { flowId, status } = req.query;

  if (status === 'completed') {
    res.redirect('/dashboard?message=verification-complete');
  } else if (status === 'abandoned') {
    res.redirect('/verification?message=verification-abandoned');
  } else {
    res.redirect('/');
  }
});
The redirect only indicates that the user has returned from the verification flow. For actual verification results and extracted data, always rely on webhook notifications. The redirect is for UX purposes only.

​
Benefits

Quick Implementation

Get up and running in minutes

No Frontend Development

No need to integrate UI components

Automatic Updates

Always use the latest verification interface

Secure

Hosted on Urtentic’s secure infrastructure

​
Best Practices

  1. Always use webhooks for verification results - don’t rely solely on redirects
  2. Validate redirect parameters to prevent tampering
  3. Use HTTPS for redirect URLs
  4. Store metadata that helps you identify the user and verification context
  5. Handle abandoned verifications gracefully in your UX