KYB Overview

Introduction to Know Your Business (KYB)

VOVE ID's KYB (Know Your Business) solution enables you to verify the identity and legitimacy of business entities as part of your compliance and onboarding process. The KYB integration allows you to collect and verify business information, documents, and Ultimate Beneficial Owners (UBOs) through a seamless workflow.

What is KYB?

KYB is the business equivalent of KYC (Know Your Customer). It's a compliance process that verifies the identity of a business entity, its ownership structure, and the individuals who ultimately own or control the business (UBOs). This is essential for:

• Anti-Money Laundering (AML) compliance

• Risk assessment and due diligence

• Regulatory compliance (varies by jurisdiction)

• Fraud prevention

• Building trust with legitimate businesses

Key Features

Business Verification

• Automated business search and verification using external data providers

• Support for multiple countries and jurisdictions

• Business registry data validation

• Document collection and verification

Document Management

• Upload and store business documents (registration certificates, licenses, etc.)

• AI-powered document analysis and data extraction

• Support for various document types

UBO Management

• Invite and verify Ultimate Beneficial Owners

• Individual KYC verification for each UBO

• Track UBO verification status

• Support for multiple UBOs per business

Website Analysis (Optional)

• Automated website verification and analysis

• Domain ownership verification

• Business activity validation

• Risk assessment based on online presence

KYB Flow Architecture

The KYB verification process follows a structured 6-step workflow:

Step 1: Create KYB Case

Your Backend

Call the KYB API to create a new verification case:

POST /kyb/case

Returns:

• Verification token (valid 24 hours)

• Case ID and details

Step 2: Share Verification Link

Your Application

Construct and send the verification link to your business customer:

https://web.voveid.com/kyb/?authToken={token}&publicKey={publicKey}&environment=Production

Send via email, SMS, or display directly in your application.

Step 3: Business Customer Completes Verification

Business Portal (Customer-Facing)

The business customer accesses the portal and completes:

Step	Description
📄 Upload Documents	Business registration certificates, licenses, etc.
📝 Fill Business Form	Registration number, address, industry, etc.
🔍 Business Search	Verify business in official registries
👥 Invite UBOs	Add Ultimate Beneficial Owners for individual verification
✅ Submit Case	Submit completed case for VOVE ID review

Status progresses: NOT_STARTED → IN_PROGRESS

Step 4: VOVE ID Reviews Case

VOVE ID Processing

Once submitted, VOVE ID reviews the case:

• Validates documents and data

• Checks UBO verification status

• Performs compliance checks

Status changes: IN_PROGRESS → IN_REVIEW

Step 5: Receive Webhook Notifications

Your Backend

Real-time webhook events keep you informed:

// Webhook events you'll receive
{
  "kyb.case.created": "Case created",
  "kyb.case.status.changed": "Status updated",
  "kyb.case.completed": "Verification approved",
  "kyb.case.rejected": "Verification rejected",
  "kyb.ubo.invited": "UBO invited for verification",
  "kyb.ubo.completed": "UBO completed KYC"
}

Step 6: Retrieve Final Results

Your Backend

Retrieve complete verification results:

GET /kyb/case/{id}

Final Status:

• COMPLETED - Business verified and approved

• REJECTED - Verification failed (see rejection reasons)

Case Status Lifecycle

A KYB case progresses through the following statuses:

• NOT_STARTED: Case created, business has not yet accessed the verification portal

• IN_PROGRESS: Business is actively completing the verification steps

• IN_REVIEW: Business has submitted the case for review by VOVE ID

• COMPLETED: Verification approved, business is verified

• REJECTED: Verification rejected due to compliance or data issues

KYB Flows

KYB flows are country-specific configurations that define:

• Required verification steps for businesses in that jurisdiction

• Required documents to collect

• KYC flow to use for UBO verification

• Optional steps like additional document upload

Each organization can create custom KYB flows tailored to their compliance requirements and the jurisdictions they operate in.

API Environments

Sandbox: https://api.voveid.net/v2

Production: https://api.voveid.com/v2

Authentication

All KYB API requests require authentication using your API key in the request header:

x-api-key: YOUR_API_KEY

Security Note: Never expose your API key in client-side code. All KYB case creation and management operations should be performed on your backend server.

Getting Started

To integrate KYB into your application:

1. Configure KYB Flow: Create a KYB flow for your target country/jurisdiction (or use default flows)

2. Create KYB Case: When a business needs verification, create a case via your backend

3. Share Verification Link: Provide the verification link to the business customer

4. Set Up Webhooks: Configure webhook endpoints to receive real-time status updates

5. Retrieve Results: Access verification results and make business decisions

Next Steps

• Create a KYB Case - Learn how to create cases and generate verification links

• KYB Case Management - Manage cases, documents, and UBOs

• KYB Webhooks - Set up webhooks to receive verification updates