Webhook Events Guide

Dodo Payments, payment, subscription, dispute, payout, credit या license key lifecycle के प्रत्येक चरण पर webhook events emit करता है। यह पेज resource के अनुसार प्रत्येक event की सूची देता है। विस्तृत payload schemas और handler examples के लिए नीचे दिए गए resource-specific pages देखें।

Payment Events

Event	कब fire होता है
`payment.succeeded`	जब payment सफलतापूर्वक process हो जाता है।
`payment.failed`	जब declined cards, अपर्याप्त funds या अन्य errors के कारण payment attempt विफल हो जाता है।
`payment.processing`	जब payment process किया जा रहा हो।
`payment.cancelled`	जब payment पूरा होने से पहले cancel कर दिया जाता है।

पूरे payload schema के लिए Payment Webhooks देखें।

Refund Events

Event	कब fire होता है
`refund.succeeded`	जब refund सफलतापूर्वक process हो जाता है।
`refund.failed`	जब processing errors या अन्य समस्याओं के कारण refund attempt विफल हो जाता है।

पूरे payload schema के लिए Refund Webhooks देखें।

Dispute Events

Event	कब fire होता है
`dispute.opened`	जब cardholder किसी payment पर dispute खोलता है।
`dispute.challenged`	जब dispute को contest करने के लिए evidence submit किया जाता है।
`dispute.accepted`	जब dispute को contest किए बिना स्वीकार कर लिया जाता है।
`dispute.cancelled`	जब dispute withdraw या cancel कर दिया जाता है।
`dispute.expired`	जब resolution के बिना response window समाप्त हो जाती है।
`dispute.won`	जब dispute का resolution आपके पक्ष में होता है।
`dispute.lost`	जब dispute का resolution cardholder के पक्ष में होता है।

विस्तृत payload schemas और handler examples के लिए Dispute Webhooks देखें।

Subscription Events

Event	कब fire होता है
`subscription.active`	जब subscription सफलतापूर्वक activate हो जाती है और recurring charges schedule हो जाते हैं।
`subscription.updated`	जब subscription के किसी भी field में बदलाव होता है (polling के बिना real-time sync)।
`subscription.past_due`	जब renewal विफल हो जाता है और grace period शुरू होता है; deadline तक customer का access बना रहता है।
`subscription.on_hold`	जब विफल renewal के कारण subscription को अस्थायी रूप से hold पर रखा जाता है।
`subscription.paused`	जब subscription pause की जाती है।
`subscription.unpaused`	जब paused subscription resume की जाती है।
`subscription.renewed`	जब अगले billing period के लिए subscription सफलतापूर्वक renew हो जाती है।
`subscription.plan_changed`	जब subscription को upgrade, downgrade या अलग add-ons के साथ modify किया जाता है।
`subscription.update_payment_method`	जब subscription का payment method update किया जाता है।
`subscription.cancelled`	जब merchant या customer subscription cancel करता है।
`subscription.failed`	जब mandate creation के दौरान subscription creation विफल हो जाती है।
`subscription.expired`	जब subscription अपनी term के अंत तक पहुंचती है और expire हो जाती है।

विस्तृत payload schemas और handler examples के लिए Subscription Webhooks देखें।

License Key Events

Event	कब fire होता है
`license_key.created`	जब किसी product के लिए नई license key create की जाती है।

पूरे payload schema के लिए License Key Webhooks देखें।

Entitlement Grant Events

Event	कब fire होता है
`entitlement_grant.created`	जब customer के लिए नया entitlement grant create किया जाता है। Auto-fulfilled license-key grants और feature-flag grants `status: "Delivered"` के साथ आते हैं और कोई अलग `delivered` event fire नहीं करते। अन्य grants, जिनमें manually-fulfilled license keys शामिल हैं, `Pending` के साथ आते हैं। Entitlement Grant देखें।
`entitlement_grant.delivered`	Grant fulfillment पूरा होता है — license key जारी की जाती है, file links resolve किए जाते हैं या platform access दिया जाता है।
`entitlement_grant.failed`	Grant fulfillment विफल होता है। Payload में `error_code` और `error_message` देखें।
`entitlement_grant.revoked`	Access वापस ले लिया जाता है। Payload में `revocation_reason` देखें।

विस्तृत payload schemas, sample events और पूरे revocation_reason reference के लिए Entitlement Grant Webhooks देखें।

Credit Events

Event	कब fire होता है
`credit.added`	जब customer को credits दिए जाते हैं (subscription, one-time purchase, add-on या API के माध्यम से)।
`credit.deducted`	जब usage या manual debit के माध्यम से credits consume किए जाते हैं।
`credit.expired`	जब configured expiry period के बाद unused credits expire हो जाते हैं।
`credit.rolled_over`	जब cycle end पर unused credits को नए grant में carry forward किया जाता है।
`credit.rollover_forfeited`	जब max rollover count पूरा हो जाने के कारण credits forfeit हो जाते हैं।
`credit.overage_charged`	जब zero balance से अधिक usage के लिए overage charges लागू किए जाते हैं।
`credit.overage_reset`	जब accumulated overage charges reset किए जाते हैं (उदाहरण के लिए, नए billing cycle की शुरुआत में)।
`credit.manual_adjustment`	जब manual credit या debit adjustment किया जाता है।
`credit.balance_low`	जब credit balance configured threshold से नीचे गिर जाता है।

विस्तृत payload schemas और handler examples के लिए Credit-Based Billing Webhooks देखें।

Recovery Events

Event	कब fire होता है
`abandoned_checkout.detected`	जब 60 मिनट के बाद incomplete या failed checkout का पता चलता है।
`abandoned_checkout.recovered`	जब customer recovery link के माध्यम से payment पूरा करता है।

विस्तृत payload schemas, field descriptions और handler examples के लिए Recovery Webhooks देखें।

Dunning Events

Event	कब fire होता है
`dunning.started`	जब past due या on hold हो चुकी, या cancel की गई subscription के लिए dunning attempt शुरू होता है।
`dunning.recovered`	जब customer अपना payment method update करता है और resulting charge सफल हो जाता है।

विस्तृत payload schemas, field descriptions और handler examples के लिए Recovery Webhooks देखें।

Payout Events

Payout events आपके funds को Dodo Payments से आपके bank account में transfer किए जाने को track करते हैं। ये dashboard में दिखाए गए payout statuses को mirror करते हैं। Payload एक payout object होता है, जिसका shape GET /payouts की entry जैसा ही होता है।

Event	कब fire होता है
`payout.created`	जब payout create किया जाता है, चाहे automatic payout cycle के माध्यम से या off-cycle।
`payout.in_progress`	जब payout की due date आती है और processing शुरू होती है।
`payout.on_hold`	जब payout को pause किया जाता है या review के अंतर्गत रखा जाता है।
`payout.success`	जब आपके bank account में payout settle हो जाता है।
`payout.failed`	जब payout विफल हो जाता है। Funds और fees आपके wallet में वापस credit कर दिए जाते हैं।

Payout events न तो terminal होते हैं और न ही strict order में आते हैं। जब bank transfer वापस करता है, तो payout.failed, payout.success के बाद आ सकता है; और जब failed payout बाद में recover हो जाता है, तो payout.success, payout.failed के बाद आ सकता है। Payload का status हमेशा event type से match करता है, इसलिए latest state खोजने के लिए प्रत्येक event के top-level timestamp का उपयोग करें।

payout.created पहले payout.not_initiated के रूप में emit किया जाता था। यदि कोई existing endpoint payout.not_initiated पर filter करता है, तो filter को payout.created पर update करें, ताकि वह match करता रहे।

विस्तृत payload schemas, field descriptions और handler examples के लिए Payout Webhooks देखें।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Payment Events

Refund Events

Dispute Events

Subscription Events

License Key Events

Entitlement Grant Events

Credit Events

Recovery Events

Dunning Events

Payout Events

​Payment Events

​Refund Events

​Dispute Events

​Subscription Events

​License Key Events

​Entitlement Grant Events

​Credit Events

​Recovery Events

​Dunning Events

​Payout Events

Payment Events

Refund Events

Dispute Events

Subscription Events

License Key Events

Entitlement Grant Events

Credit Events

Recovery Events

Dunning Events

Payout Events