वेबहुक इवेंट गाइड

डोडो पेमेंट्स वास्तविक समय में वेबहुक सूचनाएँ प्रदान करता है ताकि आप लेनदेन, सदस्यता, रिफंड, विवाद, और लाइसेंस कुंजी प्रबंधन से संबंधित महत्वपूर्ण घटनाओं के बारे में सूचित रह सकें। नीचे इन घटनाओं का एक विस्तृत गाइड है, जिसे स्पष्टता के लिए श्रेणीबद्ध किया गया है, साथ ही कार्यान्वयन टिप्स और विचार भी शामिल हैं।

भुगतान इवेंट्स

इवेंट का नाम	इवेंट का प्रकार	वर्णन
Payment Succeeded	`payment.succeeded`	जब भुगतान सफलतापूर्वक संसाधित हो जाता है तब ट्रिगर होता है।
Payment Failed	`payment.failed`	जब त्रुटियों, अस्वीकृत कार्डों, या अन्य समस्याओं के कारण भुगतान प्रयास विफल होता है।
Payment Processing	`payment.processing`	यह दर्शाता है कि भुगतान वर्तमान में संसाधित किया जा रहा है।
Payment Cancelled	`payment.cancelled`	जब भुगतान पूरा होने से पहले रद्द कर दिया जाता है तब ट्रिगर होता है।

रिफंड इवेंट्स

इवेंट का नाम	इवेंट का प्रकार	वर्णन
Refund Succeeded	`refund.succeeded`	जब रिफंड सफलतापूर्वक संसाधित हो जाता है तब ट्रिगर होता है।
Refund Failed	`refund.failed`	जब प्रोसेसिंग त्रुटियों या अन्य समस्याओं के कारण रिफंड प्रयास विफल होता है।

विवाद इवेंट्स

इवेंट का नाम	इवेंट का प्रकार	वर्णन
Dispute Opened	`dispute.opened`	जब ग्राहक विवाद शुरू करता है तब ट्रिगर होता है।
Dispute Expired	`dispute.expired`	यह दर्शाता है कि विवाद बिना समाधान के समाप्त हो गया।
Dispute Accepted	`dispute.accepted`	जब व्यापारी विवाद स्वीकार करता है तब ट्रिगर होता है।
Dispute Cancelled	`dispute.cancelled`	जब ग्राहक या सिस्टम द्वारा विवाद रद्द किया जाता है तब होता है।
Dispute Challenged	`dispute.challenged`	जब व्यापारी विवाद को चुनौती देता है तब ट्रिगर होता है।
Dispute Won	`dispute.won`	यह दर्शाता है कि व्यापारी ने सफलतापूर्वक विवाद जीत लिया है।
Dispute Lost	`dispute.lost`	जब व्यापारी विवाद हार जाता है तब होता है।

सदस्यता इवेंट्स

इवेंट का नाम	इवेंट का प्रकार	वर्णन
Subscription Active	`subscription.active`	यह दर्शाता है कि सदस्यता अब सक्रिय है और पुनरावर्ती शुल्क निर्धारित हैं।
Subscription Updated	`subscription.updated`	जब किसी भी सदस्यता फ़ील्ड को अपडेट किया जाता है तब ट्रिगर होता है (पोलिंग के बिना रीयल-टाइम सिंक)।
Subscription On Hold	`subscription.on_hold`	जब नवीनीकरण विफल होने के कारण सदस्यता अस्थायी रूप से रुक जाती है तब ट्रिगर होता है।
Subscription Renewed	`subscription.renewed`	जब सदस्यता सफलतापूर्वक नवीनीकृत होती है तब होता है।
Subscription Plan Changed	`subscription.plan_changed`	जब सदस्यता को अपग्रेड, डाउनग्रेड या विभिन्न ऐडऑन के साथ संशोधित किया जाता है तब ट्रिगर होता है।
Subscription Cancelled	`subscription.cancelled`	जब कोई व्यापारी या ग्राहक सदस्यता रद्द करता है तब ट्रिगर होता है।
Subscription Failed	`subscription.failed`	विफल सदस्यता को दर्शाता है। इसका मतलब है कि हम एक आदेश बनाने में असमर्थ थे।
Subscription Expired	`subscription.expired`	जब सदस्यता अपनी अवधि के अंत तक पहुंचती है और समाप्त हो जाती है तब ट्रिगर होता है।

लाइसेंस कुंजी इवेंट्स

इवेंट का नाम	इवेंट का प्रकार	वर्णन
License Key Created	`license_key.created`	जब किसी उत्पाद के लिए नया लाइसेंस की बनाया जाता है तब ट्रिगर होता है।

अधिकारिता अनुदान घटनाएँ

घटना का नाम	घटना का प्रकार	विवरण
अनुदान निर्मित	`entitlement_grant.created`	ग्राहक के लिए एक नया अधिकारिता अनुदान बनाया जाता है। लाइसेंस-कुंजी अनुदान आते हैं `delivered`; OAuth-आधारित अनुदान (Discord, GitHub, Notion) आते हैं `pending`.
अनुदान वितरित	`entitlement_grant.delivered`	अनुदान पूरा हो जाता है — लाइसेंस कुंजी जारी, फ़ाइल लिंक सुलझाए, या प्लेटफ़ॉर्म एक्सेस दिया गया।
अनुदान विफल	`entitlement_grant.failed`	अनुदान पूर्णता विफल हुई; निरीक्षण करें `error_code` और `error_message`.
अनुदान रद्द	`entitlement_grant.revoked`	एक्सेस वापस लिया जाता है; निरीक्षण करें `revocation_reason` (सदस्यता स्थिति, रिफंड, योजना परिवर्तन, या मैनुअल)।

विस्तृत पेलोड स्कीमा, नमूना घटनाएँ, और पूर्ण revocation_reason संदर्भ के लिए देखें अधिकारिता अनुदान वेबहुक.

क्रेडिट घटनाएँ

घटना का नाम	घटना का प्रकार	विवरण
क्रेडिट जोड़ा गया	`credit.added`	जब क्रेडिट ग्राहक को प्रदान किए जाते हैं तब ट्रिगर होता है (सदस्यता, एकबारगी, एड-ऑन, या API)।
क्रेडिट कटौती	`credit.deducted`	जब क्रेडिट का उपभोग किया जाता है या मैनुअल डेबिट के माध्यम से होता है।
क्रेडिट समाप्त	`credit.expired`	जबनिर्धारित समाप्ति अवधि के बाद अप्रयुक्त क्रेडिट समाप्त होते हैं।
क्रेडिट स्थानांतरित	`credit.rolled_over`	जब अप्रयुक्त क्रेडिट नए अनुदान के लिए चक्र के अंत में स्थानांतरित हो जाते हैं।
स्थानांतरण जब्त	`credit.rollover_forfeited`	जब क्रेडिट जब्त होते हैं क्योंकि अधिकतम स्थानांतरण गणना तक पहुंच गया।
ओवरएज चार्ज	`credit.overage_charged`	जब शून्य संतुलन से परे उपयोग के लिए ओवरएज चार्ज लागू होते हैं।
मैनुअल समायोजन	`credit.manual_adjustment`	जब मैनुअल क्रेडिट या डेबिट समायोजन किया जाता है तब ट्रिगर होता है।
संतुलन कम	`credit.balance_low`	जब क्रेडिट संतुलन निर्धारित सीमा से नीचे गिरता है तब ट्रिगर होता है।

पुनर्प्राप्ति घटनाएँ

घटना का नाम	घटना का प्रकार	विवरण
त्यागा गया चेकआउट पाया गया	`abandoned_checkout.detected`	जब 60 मिनट के बाद एक अपूर्ण या असफल चेकआउट पाया जाता है तब ट्रिगर होता है।
त्यागा गया चेकआउट पुनर्प्राप्त	`abandoned_checkout.recovered`	जब ग्राहक एक पुनर्प्राप्ति लिंक के माध्यम से भुगतान पूरा करता है तब होता है।

विस्तृत पेलोड स्कीमास, फ़ील्ड विवरण, और हैंडलर उदाहरणों के लिए, देखें रिकवरी वेबहुक्स।

डनिंग घटनाएँ

घटना का नाम	घटना का प्रकार	विवरण
डनिंग प्रारंभ हुआ	`dunning.started`	जब एक सदस्यता के लिए डनिंग प्रयास शुरू होता है जो होल्ड पर गई या रद्द हो गई।
डनिंग पुनर्प्राप्त	`dunning.recovered`	जब एक ग्राहक अपने भुगतान विधि को अपडेट करता है और परिणामस्वरूप चार्ज सफल होता है।

विस्तृत पेलोड स्कीमा, फील्ड विवरण, और हैंडलर उदाहरणों के लिए देखें पुनर्प्राप्ति वेबहुक. ये वेबहुक घटनाएँ व्यापारियों को अपनी कार्यों को प्रभावी ढंग से प्रबंधित करने के लिए महत्वपूर्ण अपडेट प्रदान करने के लिए डिज़ाइन की गई हैं। अपनी वेबहुक एकीकरण में प्रत्येक संबंधित घटना के लिए मजबूत हैंडलरों को लागू करें ताकि चिकनी और विश्वसनीय कार्यशीलता सुनिश्चित हो सके।

​भुगतान इवेंट्स

​रिफंड इवेंट्स

​विवाद इवेंट्स

​सदस्यता इवेंट्स

​लाइसेंस कुंजी इवेंट्स

​अधिकारिता अनुदान घटनाएँ

​क्रेडिट घटनाएँ

​पुनर्प्राप्ति घटनाएँ

​डनिंग घटनाएँ