Build Dynamic Verification Pipelines with Didit's Workflow API in Python

Orchestrated WorkflowsDidit's platform provides a powerful no-code visual builder for designing complex, multi-step identity verification journeys, giving businesses full control over their onboarding logic.

Two Modes for FlexibilityWhether you need quick deployment with template-based 'Simple Mode' or granular control with 'Complex Mode,' Didit offers the right approach for every development need.

Seamless Python IntegrationGenerate secure verification links and manage sessions programmatically using Python, allowing for dynamic, automated identity verification within your existing applications.

Didit's AI-Native AdvantageLeverage Didit's AI-native, modular architecture, and Free Core KYC to build robust, scalable, and compliant identity solutions without setup fees, ensuring global reach and superior fraud prevention.

In today's digital-first world, robust identity verification is no longer a luxury but a necessity. Businesses across all sectors, from fintech to online gaming, need to onboard users quickly and securely while complying with evolving regulations like KYC (Know Your Customer) and AML (Anti-Money Laundering). Traditional verification methods can be rigid, slow, and require significant development effort. This is where Didit's Workflow API, especially when integrated with Python, revolutionizes the process, allowing for the creation of dynamic, intelligent, and highly customizable verification pipelines.

The Power of Orchestrated Workflows

Didit's core philosophy revolves around providing an open, modular identity layer. A cornerstone of this approach is our Orchestrated Workflows. These aren't just simple checks; they are comprehensive, multi-step identity verification journeys designed to handle everything from basic ID verification to complex compliance scenarios. Imagine a scenario where a user signs up for your service. Depending on their risk profile, location, or the service they wish to access, you might need different verification steps:

• ID Verification (OCR, MRZ, barcodes) to confirm their identity document.
• Passive & Active Liveness to ensure the user is a real, present human and not a deepfake.
• 1:1 Face Match to compare their live selfie with their ID document photo.
• AML Screening & Monitoring to check against watchlists for financial crime.
• Proof of Address to confirm residency.
• Age Estimation for age-restricted services.

Didit's no-code visual builder in the Business Console allows you to graphically design these intricate flows, defining conditional logic, fallback steps, and decision points. This means you can design a workflow once and deploy it across various user segments or product lines, all managed centrally.

Building Your Workflow: Simple or Complex

Didit understands that not all verification needs are created equal. That's why our workflow builder offers two distinct approaches:

1. Simple Mode: Template-Based Builder: For rapid deployment and common use cases, Simple Mode lets you select from pre-built templates. You can quickly toggle features like ID Verification, Liveness, and Face Match on or off, getting a robust verification flow up and running in minutes. This is ideal for businesses needing to launch quickly with minimal configuration.
2. Complex Mode: Granular Control: When your needs are more nuanced, Complex Mode provides a drag-and-drop interface to build workflows from individual identity primitives. You can define intricate sequences, add custom logic nodes, integrate third-party checks, and create highly tailored user journeys. This level of control is invaluable for meeting specific regulatory requirements or optimizing for unique user experiences.

Both modes leverage Didit's powerful underlying AI-native technology, ensuring accuracy and fraud prevention at every step. The beauty is that whether simple or complex, Didit handles the entire user-facing experience, state management, and conditional steps, freeing your development team to focus on your core product.

Dynamic Verification with Python and Verification Links

Once your workflow is configured in the Didit Business Console, the next step is to integrate it into your application. Didit's Verification Links offer a seamless way to trigger these workflows programmatically. A Verification Link is a unique, secure URL that directs your end-user to a verification flow hosted entirely by Didit. This means zero frontend development for you.

Using Python, you can dynamically generate these links for individual users or sessions. Here's how it works:

1. Configure Your Workflow: In the Didit Business Console, design your multi-step workflow (e.g., ID Document Scan → Liveness Check → AML Screening). Each workflow will have a unique workflow_id.
2. Generate a Verification Link via API (Python): Instead of manually creating links, your Python application can make a simple API call to Didit's /v3/session/ endpoint. You'll pass your API key, the relevant workflow_id, and optionally vendor_data (like your internal user ID) for tracking, and a callback URL to receive real-time updates.

import requests
import json

API_KEY = "YOUR_DIDIT_API_KEY"
WORKFLOW_ID = "your_configured_workflow_id"
YOUR_INTERNAL_USER_ID = "user_12345"
YOUR_WEBHOOK_URL = "https://yourapp.com/didit/webhook/handler"

headers = {
    "x-api-key": API_KEY,
    "Content-Type": "application/json"
}

data = {
    "workflow_id": WORKFLOW_ID,
    "vendor_data": YOUR_INTERNAL_USER_ID,
    "callback": YOUR_WEBHOOK_URL
}

response = requests.post(
    "https://verification.didit.me/v3/session/",
    headers=headers,
    data=json.dumps(data)
)

if response.status_code == 200:
    session_data = response.json()
    verification_url = session_data["url"]
    session_id = session_data["session_id"]
    print(f"Generated Verification URL: {verification_url}")
    print(f"Session ID: {session_id}")
    # Now, send this URL to your user via email, SMS, or in-app message
else:
    print(f"Error generating verification link: {response.status_code} - {response.text}")

1. Share the Link: Your Python application then sends the generated verification_url to your user via email, SMS, or embeds it directly in your application's UI.
2. Get Real-Time Results: As the user progresses through the verification flow, Didit sends automated updates to your configured webhook URL, allowing your Python backend to process results and update user statuses in real-time.

This low-code integration path provides maximum flexibility and automation. You can adapt verification steps based on user attributes, transaction values, or any other business logic, all orchestrated by your Python application interacting with Didit's powerful backend.

How Didit Helps

Didit is an AI-native, developer-first identity platform designed to simplify and automate identity verification. Our modular architecture allows you to compose verification checks like building blocks, creating tailored solutions for any use case. For dynamic verification pipelines, Didit offers unparalleled advantages:

• Orchestrated Workflows: Our no-code visual builder empowers you to design complex, multi-step verification journeys, including ID Verification (OCR, MRZ, barcodes), Passive & Active Liveness, 1:1 Face Match, AML Screening & Monitoring, Proof of Address, and privacy-preserving Age Estimation.
• Developer-First API: With clean APIs and an instant sandbox, integrating Didit into your Python application is straightforward and well-documented. Our Verification Links eliminate the need for frontend development, drastically speeding up time to market.
• AI-Native Accuracy: Didit's AI-driven platform ensures high accuracy in data extraction and fraud detection, reducing manual review and improving conversion rates.
• Global by Design: Support for 130+ languages, 4000+ document types, and 220+ countries and territories means your dynamic pipelines can scale globally.
• Cost-Effective: Didit offers Free Core KYC and a pay-per-successful check model, with no setup fees, making it an economically sound choice for businesses of all sizes.

Ready to Get Started?

Ready to see Didit in action? Get a free demo today.

Start verifying identities for free with Didit's free tier.