मुख्य सामग्री पर जाएं
POST
curl

KYC और KYB समर्थन

यह उपयोगकर्ता सत्यापन (KYC) और व्यवसाय सत्यापन (KYB) दोनों सत्रों के लिए काम करता है। Didit दोनों प्रकार के सत्रों में session_id को हल करता है और एक JWT शेयर token बनाता है, जिसमें शामिल है:
जब प्राप्त करने वाला पार्टनर token इंपोर्ट करता है, तब Didit संबंधित प्रकार का सत्र (KYC या KYB) उसके संबंधों सहित क्लोन करता है।

आवश्यकताएँ

  • सत्र किसी समाप्त स्थिति में होना चाहिए (APPROVED, DECLINED, IN_REVIEW)।
  • आपके पास write:sessions विशेषाधिकार होना चाहिए।
  • for_application_id एक मान्य Didit एप्लिकेशन होना चाहिए (आमतौर पर पार्टनर का एप्लिकेशन)।

उदाहरण

रिस्पॉन्स:

TTL सीमाएँ

संबंधित

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

पथ पैरामीटर

sessionId
string<uuid>
आवश्यक

token मिंट करने के लिए स्रोत सत्यापन सत्र का UUID।

उदाहरण:

"11111111-2222-3333-4444-555555555555"

बॉडी

application/json
for_application_id
string<uuid>
आवश्यक

Didit एप्लिकेशन का UUID जो token को रिडीम करेगा। यह मौजूद होना चाहिए, हटाया हुआ नहीं होना चाहिए, और कॉल करने वाले एप्लिकेशन से भिन्न होना चाहिए। इसे Business Console में Settings → Application के अंतर्गत खोजें।

उदाहरण:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
डिफ़ॉल्ट:3600

Token का लाइफ़टाइम, सेकंड में। न्यूनतम 60, अधिकतम 86400 (24 घंटे)। डिफ़ॉल्ट रूप से 3600 (1 घंटा)।

आवश्यक सीमा: 60 <= x <= 86400
उदाहरण:

3600

प्रतिक्रिया

शेयर token मिंट किया गया।

share_token
string

HS256-हस्ताक्षरित JWT। इसे टारगेट एप्लिकेशन पर POST /v3/session/import-shared/ को share_token के रूप में हूबहू पास करें।

उदाहरण:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

उस लक्षित एप्लिकेशन UUID का इको करता है जिससे टोकन बाउंड है।

उदाहरण:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

क्या स्रोत सत्र एक उपयोगकर्ता सत्यापन (KYC) या व्यवसाय सत्यापन (KYB) सत्र है।

उपलब्ध विकल्प:
user,
business
अंतिम संशोधन 7 नवंबर 2026