KYB क्विकस्टार्ट: 10 मिनट में व्यवसाय सत्यापन

यह गाइड आपको 10 मिनट से कम समय में पूरी KYB सत्यापन प्रक्रिया से गुज़ारती है। आप एक वर्कफ़्लो बनाएँगे, एक सत्र शुरू करेंगे, होस्टेड सत्यापन लिंक अपने व्यवसाय संपर्क तक पहुँचाएँगे, webhook का इंतज़ार करेंगे, और अंतिम निर्णय प्राप्त करेंगे।

पूर्व-आवश्यकताएँ

KYB सक्षम किया हुआ एक Didit एप्लिकेशन। ज़रूरत हो तो इसे business.didit.me पर बनाएँ।
Developer Settings → API Keys से एक API कुंजी।
इंटरनेट से पहुँचा जा सकने वाला एक webhook endpoint (निर्णय webhook के लिए)।

चरण

कंसोल में KYB वर्कफ़्लो बनाएँ

Workflows → Create workflow पर जाएँ। वर्कफ़्लो प्रकार के रूप में व्यवसाय सत्यापन (KYB) चुनें।जिन सुविधाओं की आपको ज़रूरत है उन्हें सक्षम करें:

कंपनी रजिस्ट्री लुकअप (आवश्यक)
कंपनी AML (अनुशंसित)
प्रमुख व्यक्ति (अधिकांश विनियमित उद्योगों के लिए आवश्यक)
दस्तावेज़ (वैकल्पिक: जिन दस्तावेज़ प्रकारों की आपको ज़रूरत हो उन्हें चुनें)

सहेजें और workflow_id कॉपी करें। अगले चरण में आप इसका उपयोग करेंगे।

API के माध्यम से व्यवसाय सत्यापन (KYB) सत्र बनाएँ

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_KYB_WORKFLOW_ID",
    "vendor_data": "biz-acme-001"
  }'

रिस्पॉन्स में session_id, session_number और url शामिल होते हैं, यानी वह होस्टेड सत्यापन लिंक जो आप व्यवसाय संपर्क को भेजते हैं। वर्कफ़्लो का प्रकार (KYB) सत्र को अपने आप व्यवसाय सत्र के रूप में चिह्नित कर देता है।

लिंक अपने व्यवसाय संपर्क को भेजें

url को अपने ईमेल या चैट के ज़रिए कंपनी एडमिन को भेजें। वे उसे खोलेंगे, रजिस्ट्री डेटा भरेंगे, प्रमुख व्यक्ति और UBO जोड़ेंगे, और दस्तावेज़ अपलोड करेंगे।आप ब्रांडिंग, लोगो और डोमेन के साथ होस्टेड अनुभव को कस्टमाइज़ कर सकते हैं। देखें व्हाइट लेबल।

स्टेटस webhook प्राप्त करें

जब व्यवसाय प्रवाह पूरा कर लेता है और KYB प्रोसेसिंग किसी अंतिम स्टेटस पर पहुँचती है, तो Didit आपके webhook endpoint पर status.updated इवेंट POST करता है। व्यवसाय सत्र के इवेंट में data के अंदर session_kind: "business" होता है। इवेंट को अपने KYB हैंडलर तक पहुँचाने के लिए इसी के आधार पर फ़िल्टर करें।इवेंट पर भरोसा करने से पहले X-Signature-V2 HMAC सिग्नेचर सत्यापित करें (देखें webhooks), फिर अपना डाउनस्ट्रीम लॉजिक ट्रिगर करें। webhook गंतव्य का secret_shared_key (जो webhook रजिस्टर करते समय मिलती है) अपनी .env फ़ाइल में DIDIT_WEBHOOK_SECRET के रूप में सहेजें।उदाहरण payload:

{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "status.updated",
  "session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "business_session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "session_kind": "business",
  "vendor_data": "biz-acme-001",
  "status": "Approved",
  "created_at": 1776515400,
  "timestamp": 1776515401,
  "decision": { "...": "full KYB decision" }
}

निर्णय प्राप्त करें (वैकल्पिक)

status.updated webhook payload में पहले से पूरा निर्णय शामिल होता है। इस endpoint को तभी कॉल करने की ज़रूरत है जब आपने webhook की सदस्यता नहीं ली है, या आप बाद में आवश्यकता पड़ने पर निर्णय प्राप्त करना चाहते हैं।

curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"

निर्णय में रजिस्ट्री डेटा, प्रमुख व्यक्ति (UBO, शेयरधारक, निदेशक और प्रतिनिधि), AML हिट, दस्तावेज़ और प्रति सुविधा परिणाम शामिल होते हैं। पूरे payload का संदर्भ देखने के लिए रिस्पॉन्स स्कीमा देखें।

निर्णय पर कार्रवाई करें

status के आधार पर:

"Approved": व्यवसाय को ऑनबोर्ड करें।
"Declined": अस्वीकार करें और निर्णय के warnings[] टैग लॉग करें।
"In Review": विश्लेषक के निर्णय की प्रतीक्षा करें; वह तय होने पर आपको एक और webhook मिलेगा।

Node.js उदाहरण

import fetch from 'node-fetch';

const API_KEY = process.env.DIDIT_API_KEY!;
const WORKFLOW_ID = process.env.DIDIT_KYB_WORKFLOW_ID!;
const BASE_URL = 'https://verification.didit.me';

async function startKybVerification(vendorData: string) {
  const res = await fetch(`${BASE_URL}/v3/session/`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ workflow_id: WORKFLOW_ID, vendor_data: vendorData }),
  });
  if (!res.ok) throw new Error(`Session create failed: ${res.status}`);
  return res.json();
}

async function getDecision(sessionId: string) {
  const res = await fetch(`${BASE_URL}/v3/session/${sessionId}/decision/`, {
    headers: { 'x-api-key': API_KEY },
  });
  return res.json();
}

// Kick off the flow
const { session_id, url } = await startKybVerification('biz-acme-001');
console.log('Deliver this URL to your contact:', url);

// ... later, after the webhook confirms completion:
const decision = await getDecision(session_id);
console.log('KYB status:', decision.status);

स्वचालित रूप से क्या होता है

190+ अधिकार क्षेत्रों के विरुद्ध कंपनी रजिस्ट्री लुकअप।
रजिस्ट्री डेटा से UBO और अधिकारी निकालना।
कंपनी-स्तर पर AML स्क्रीनिंग (प्रतिबंध, PEP, प्रतिकूल मीडिया)।
पहचाने गए हर पक्ष के लिए व्यक्ति-स्तर पर AML।
दस्तावेज़ OCR और क्रॉस-रेफ़रेंसिंग।
व्यवसाय प्रोफ़ाइल बनाना और vendor_data के आधार पर उन्हें एकत्र करना।

अगले चरण

इंटीग्रेशन गाइड

एंड-टू-एंड आर्किटेक्चर, पोलिंग बनाम webhook, पुनः प्रयास लॉजिक।

KYB webhook

हर KYB इवेंट और payload की संरचना।

स्टेटस

सत्र, सुविधा और रजिस्ट्री स्टेटस का संदर्भ।

रिस्पॉन्स स्कीमा

पूरा KYB निर्णय payload।

व्यवसाय इकाइयाँ

प्रोफ़ाइल कैसे सत्रों में एकत्र होती हैं।

शुरुआत करें

सुविधाएँ

व्यवसाय प्रोफ़ाइल

संदर्भ

कंसोल

KYB क्विकस्टार्ट: 10 मिनट में व्यवसाय सत्यापन

पूर्व-आवश्यकताएँ

चरण

Node.js उदाहरण

स्वचालित रूप से क्या होता है

अगले चरण

इंटीग्रेशन गाइड

KYB webhook

स्टेटस

रिस्पॉन्स स्कीमा

व्यवसाय इकाइयाँ

​पूर्व-आवश्यकताएँ

​चरण

​Node.js उदाहरण

​स्वचालित रूप से क्या होता है

​अगले चरण

इंटीग्रेशन गाइड

KYB webhook

स्टेटस

रिस्पॉन्स स्कीमा

व्यवसाय इकाइयाँ

पूर्व-आवश्यकताएँ

चरण

Node.js उदाहरण

स्वचालित रूप से क्या होता है

अगले चरण