सब्सक्रिप्शन डनिंग

Subscription Dunning उन ग्राहकों को email भेजता है जिनका subscription असफल payment के बाद समाप्त हो गया है या जिन्होंने उसे रद्द कर दिया है, और उनसे अपनी payment method अपडेट करने या दोबारा खरीदारी करने के लिए कहता है। इसे चालू करने के बाद यह अपने आप चलता है।

सब्सक्रिप्शन डनिंग क्या है?

Dunning यह पहचानता है कि कोई subscription कब पुनर्प्राप्त किए जा सकने वाले state में प्रवेश करता है और ग्राहक से कार्रवाई करने के लिए email sequence भेजता है। तीन states से sequence शुरू होता है:

On Hold subscriptions: Renewal payment विफल हो गया, उदाहरण के लिए अपर्याप्त funds या expired card के कारण।
Past Due subscriptions: Renewal payment विफल हो गया, जबकि grace period खुला है।
Cancelled subscriptions: ग्राहक ने Customer Portal से इसे रद्द किया।

डनिंग कैसे काम करती है

Trigger

एक subscription इन तीन states में से किसी एक में प्रवेश करता है:

On Hold: Renewal payment विफल हो गया।
Past Due: Renewal payment विफल हो गया, जबकि grace period खुला है।
Cancelled: ग्राहक ने Customer Portal से अपना subscription रद्द किया।

Dodo Payments इसके बाद एक dunning attempt बनाता है और dunning.started webhook भेजता है। जब संबंधित sequence में कोई enabled email नहीं होता, तो कोई attempt शुरू नहीं होता और किसी subscription पर एक समय में अधिकतम एक active attempt होता है।

Grace Period

यदि आप grace period सेट करते हैं, तो असफल renewal subscription को past_due में ले जाता है, न कि on_hold में।On-hold email sequence उस अवधि के दौरान चलता है, इसलिए ग्राहक से तब payment करने के लिए कहा जाता है जब उसके पास अभी भी access हो।एक असफल payment से एक sequence शुरू होता है। अवधि समाप्त होने पर दूसरा sequence शुरू नहीं होता। यदि अवधि subscription के on hold रहने पर समाप्त होती है, तो sequence में बचे हुए email फिर भी भेजे जाते हैं। यदि यह subscription के cancelled होने पर समाप्त होती है, तो attempt को exhausted चिह्नित किया जाता है।Dunning attempt में past_due trigger state दर्ज होता है। Dunning analytics पढ़ते समय past_due और on_hold, दोनों पर filter करें।

Email Sequence

Trigger state के आधार पर, Dodo Payments आपके द्वारा configure किए गए delays पर अधिकतम 4 dunning email भेजता है। प्रत्येक email Customer Portal से link होता है, जहाँ ग्राहक अपनी payment method अपडेट कर सकता है, या ऐसे checkout से जहाँ वह cancelled subscription को दोबारा खरीद सकता है।

Recovery

जब ग्राहक Customer Portal में अपनी payment method अपडेट करता है, तो Dodo Payments बाकी बकाया राशि अपने आप charge करता है। यदि payment सफल होता है, तो subscription फिर से सक्रिय हो जाता है और dunning attempt को recovered चिह्नित किया जाता है।

Status Lifecycle

प्रत्येक dunning attempt की इनमें से एक status होती है:

Status	Description
`recovering`	Dunning attempt active है और email भेजे जा रहे हैं
`recovered`	ग्राहक ने अपनी payment method अपडेट की या दोबारा खरीदारी की और payment सफल हुआ
`exhausted`	सभी email भेजे जा चुके हैं और recovery के बिना सात दिन बीत चुके हैं, या subscription state अप्रत्याशित रूप से बदल गई है

जब किसी dunning attempt को exhausted चिह्नित किया जाता है, तो Dodo Payments subscription में कोई बदलाव नहीं करता। यह अपनी वर्तमान state (past due, on hold, या cancelled) में रहता है।

Configuring Dunning

अपने dashboard में Settings → Recovery के अंतर्गत Dunning चालू और configure करें। Dunning default रूप से बंद रहता है।

Dunning settings page with enable toggle, four on-hold emails at 1, 3, 5, and 7 day intervals, and four cancelled emails at the same intervals — Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence

Email Sequences

Dunning में दो email sequences होते हैं, On Hold और Cancelled, जिनमें प्रत्येक में अधिकतम 4 email होते हैं। Dashboard में इन्हें Emails sent to customer when subscription is on hold और Emails sent to customer when subscription is cancelled के रूप में सूचीबद्ध किया जाता है। past_due attempt में On Hold sequence का उपयोग होता है। प्रत्येक email में ये settings होती हैं:

Setting	Description
Enable this email	Email को हटाए बिना इसे चालू या बंद करता है
Send after	Dunning शुरू होने के कितने समय बाद यह email भेजना है, दिनों और घंटों में
Subject Line	Email का subject। यह table के बाद सूचीबद्ध placeholders को support करता है।
Email Body Text	Standard dunning email layout के भीतर दिखने वाला plain text। Line breaks बनाए रखे जाते हैं। HTML और placeholders render नहीं किए जाते।
Reply-to email	ग्राहक के replies प्राप्त करने वाला address। यदि आप इसे खाली छोड़ते हैं, तो आपके store contact email का उपयोग किया जाता है।

Subject Line में Dodo Payments इन placeholders को replace करता है: {store_name}, {store_owner_name}, {store_contact_email}, {subscription_id}, {failure_reason}, और {payment_form_link}। Default delays ये हैं:

Sequence	Email #	Default Delay
On Hold	1	1 दिन
On Hold	2	3 दिन
On Hold	3	5 दिन
On Hold	4	7 दिन
Cancelled	1	1 दिन
Cancelled	2	3 दिन
Cancelled	3	5 दिन
Cancelled	4	7 दिन

Example Dunning Emails

Dunning प्रत्येक subscription state के लिए अलग email भेजता है। ये examples दिखाते हैं कि ग्राहक को क्या दिखाई देता है।

On Hold
Cancelled

Dunning email for an on-hold subscription showing store name, message about failed payment, subscription details with plan and amount, and an Update Payment Method button — Dunning email sent when a renewal payment fails and the subscription is on hold

Customer Recovery Experience

जब ग्राहक on-hold dunning email में दिए गए link पर click करता है, तो Customer Portal उसके subscription पर खुलता है। वहाँ वह subscription status देख सकता है और अपनी payment method अपडेट कर सकता है।

Customer portal showing an on-hold subscription for Pro Plan at $95.00/year with an Update payment method button and a warning banner about the failed payment — Customer portal showing an on-hold subscription with option to update payment method

ग्राहक द्वारा अपनी payment method अपडेट करने के बाद, Dodo Payments किसी भी बकाया राशि को charge करता है। यदि payment सफल होता है, तो subscription active में वापस आ जाता है। Cancelled subscription के लिए, link checkout page खोलता है जिसमें subscription का product पहले से cart में होता है।

Analytics

अपने dashboard में Analytics → Recovery के अंतर्गत Dunning performance track करें।

Dunning section में ये metrics दिखाई जाती हैं:

Metric	Description
Dunning entries	बनाए गए dunning attempts की कुल संख्या
Recovery rate	recovery तक पहुँचने वाले dunning attempts का प्रतिशत
Recovered revenue	Dunning के माध्यम से recover की गई कुल revenue
Emails sent	भेजे गए dunning email की कुल संख्या
Avg. time to recover	Dunning शुरू होने से recovery तक का औसत समय
Recovery rate by email	Sequence में किस email ने recovery कराई, इसका विवरण

Webhook Events

Dunning दो webhook events भेजता है:

Event	Description
`dunning.started`	किसी subscription के लिए dunning attempt शुरू हो गया है
`dunning.recovered`	Dunning के माध्यम से subscription recover हो गया है

Recovery Webhook Payloads

Dunning events के पूरे webhook payload schemas देखें।

Edge Cases

Dunning इन cases को अपने आप handle करता है:

Scenario	Behavior
Customer pays before the first email	Subscription फिर से सक्रिय हो जाता है और dunning attempt को `exhausted` चिह्नित किया जाता है, `recovered` नहीं। कोई `dunning.recovered` event नहीं भेजा जाता।
Customer has, or buys, another active subscription with your business	अगला email भेजे जाने से पहले dunning attempt को `exhausted` चिह्नित किया जाता है
All dunning emails sent	अंतिम email के सात दिन बाद dunning attempt को `exhausted` चिह्नित किया जाता है। Subscription state नहीं बदलती।
Subscription changes to an unexpected state, for example cancellation at the end of a grace period	Dunning attempt को `exhausted` चिह्नित किया जाता है
The subscription’s BYOP connector is disabled	कोई dunning attempt शुरू नहीं होता। Running attempt connector के फिर से enabled होने तक कोई email नहीं भेजता।

Best Practices

Defaults से शुरुआत करें: Default delays (1, 3, 5 और 7 दिन) email को एक सप्ताह में फैलाते हैं, इसलिए ग्राहकों को बहुत अधिक email नहीं मिलते, लेकिन उन्हें लगातार reminder मिलता रहता है।
Recovery rates monitor करें: यह देखने के लिए Recovery rate by email जाँचें कि कौन सा email सबसे अधिक recoveries कराता है। यदि बाद वाले email लगभग कुछ भी recover नहीं करते, तो उन्हें बंद कर दें।
Support के साथ coordinate करें: अपनी support team को बताएं कि dunning email भेजे जा रहे हैं, ताकि वे reply करने वाले ग्राहकों की सहायता कर सकें।
Subscription states की समीक्षा करें: पूरे subscription lifecycle को track करने के लिए dunning को subscription.on_hold और subscription.cancelled webhooks के साथ उपयोग करें।

Dunning Customer Portal में मौजूद मौजूदा on-hold और reactivation flows के साथ काम करता है। इसे चालू करने के बाद यह बिना किसी integration work के अपने आप चलता है।

Recovery Webhooks

dunning.started और dunning.recovered events पर प्रतिक्रिया दें।

Abandoned Cart Recovery

Abandoned या failed checkouts को recovery email के साथ recover करें।

Customer Portal

ग्राहक Customer Portal में अपनी payment methods अपडेट करते हैं।

Subscriptions

वे subscription states जो dunning को trigger करती हैं।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

सब्सक्रिप्शन डनिंग