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

Required Parameters

Optional Parameters

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

Handling Redirects

When using redirectUrl, users will be redirected to your URL after completing or abandoning the verification:

Redirect Parameters

Example Redirect Handler

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