मुख्य सामग्री पर जाएं
हर बार जब उपयोगकर्ता या व्यवसाय इकाई की स्थिति या प्रोफ़ाइल डेटा बदलता है, तब एक webhook भेजा जाता है, ताकि आपका सिस्टम तुरंत प्रतिक्रिया दे सके। इकाई webhooks का उपयोग प्रोफ़ाइल डेटा सिंक करने, अन्य सिस्टम में ब्लॉक लागू करने, या आगे के अनुपालन फ़्लो शुरू करने के लिए करें।

​
इवेंट कैटलॉग

activity.created को subscribed_events में स्वीकार किया जाता है और इसे Try Webhook टेस्टर में शामिल किया गया है, लेकिन Didit इसे फ़िलहाल लाइव ट्रैफ़िक के लिए डिलीवर नहीं करता। इसके आधार पर टाइमलाइन मिरर न बनाएँ।
Didit सत्र, लेन-देन और व्यवसाय-सत्र इवेंट भी भेजता है, जिनमें इकाई के फ़ील्ड का संदर्भ होता है। देखें:

​
पेलोड संरचनाएँ

इकाई webhooks फ़्लैट होते हैं: इनमें कोई data रैपर और कोई event कुंजी नहीं होती। इवेंट को रूट करने के लिए webhook_type पढ़ें।

​
user.status.updated / business.status.updated

यह स्थिति में हर बदलाव पर ट्रिगर होता है। पेलोड में status और previous_status होते हैं। इसमें यह नहीं बताया जाता कि स्थिति क्यों बदली: कारण जानने के लिए इकाई को कंसोल में खोलें।

​
user.data.updated / business.data.updated

यह तब ट्रिगर होता है जब प्रोफ़ाइल फ़ील्ड बदलते हैं। changed_fields में वे फ़ील्ड सूचीबद्ध होते हैं जो बदले, और changes में हर फ़ील्ड का previous और current मान होता है।
changed_fields में ये फ़ील्ड आ सकते हैं:
  • उपयोगकर्ता: vendor_data, display_name, full_name, date_of_birth, metadata, portrait_image, issuing_states, approved_emails, approved_phones, features, session_count, approved_count, declined_count, in_review_count, first_session_at, last_session_at।
  • व्यवसाय: vendor_data, display_name, metadata, legal_name, registration_number, country_code, session_count, approved_count, declined_count, in_review_count, features, first_session_at, last_session_at।
केवल बदले हुए फ़ील्ड सिंक करने के लिए changed_fields और changes का उपयोग करें।

​
डिलीवरी, पुनः प्रयास और हस्ताक्षर

सभी इकाई webhooks मानक डिलीवरी अनुबंध का पालन करते हैं:
  • हस्ताक्षरित HMAC-SHA256 से X-Signature-V2 हेडर में (अनुशंसित), गंतव्य की secret_shared_key के साथ। X-Signature और अप्रचलित X-Signature-Simple भी भेजे जाते हैं, साथ में X-Timestamp भी।
  • पुनः प्रयास किया जाता है अधिकतम 2 बार, लगभग 1 मिनट और लगभग 4 मिनट के बाद, जब आपका endpoint 5xx या 404 का उत्तर देता है, टाइमआउट होता है, या कनेक्ट नहीं हो पाता। पूरी नीति के लिए webhooks संदर्भ देखें।
  • आइडेम्पोटेंट — हर webhook के payload में एक अनन्य event_id होता है; अपनी ओर से डुप्लिकेट हटाएँ।
गंतव्य सेटअप और हस्ताक्षर सत्यापन के कोड उदाहरणों के लिए webhooks संदर्भ देखें।

​
सब्सक्राइब करना

Management API या Business Console के माध्यम से किसी webhook गंतव्य पर इकाई इवेंट सब्सक्राइब करें:

​
अगले चरण

webhooks संदर्भ

गंतव्य, हस्ताक्षर, पुनः प्रयास और सत्यापन।

गंतव्य बनाएँ

नया webhook endpoint पंजीकृत करें।

उपयोगकर्ता संचालन

वे बदलाव जो उपयोगकर्ता webhooks ट्रिगर करते हैं।
अंतिम संशोधन 7 नवंबर 2026