Which event marks the closing of the dunning period?

Problem Statement

This article explains which webhook event indicates that the dunning period has ended and how to get notified when dunning is exhausted.

Solution

Chargebee's Dunning feature sends email reminders and schedules payment retries. After the final retry, you can configure what happens to the subscription. Multiple dunning attempts may occur before the status changes.

Event to listen for

Enable a webhook for the payment_failed event. See Webhooks for setup.

Each failed dunning attempt generates a payment_failed event. Only the last failed attempt includes "dunning_status": "exhausted" in the payload, which marks the end of the dunning period.

Example: If there are three dunning attempts, only the third payment_failed event will contain "dunning_status": "exhausted".