{"id":"4d5dd836-c453-4fee-a770-133aafa770c7","task":"Configure Chargebee Smart Dunning with custom retry settings and handle dunning webhooks","domain":"chargebee.com","steps":["Enable Smart Dunning in the Chargebee dashboard under Settings > Billing > Dunning; Smart Dunning supports up to 12 automatic retries with Chargebee determining optimal retry timing based on decline type","Classify retries by decline type: hard declines (e.g., do_not_honor) are not retried until a payment method update occurs; soft declines are retried automatically on a Chargebee-managed schedule","Register a webhook for payment_failed event; the payload includes invoice_id, next_retry_at, dunning_status, and failure_reason_code","Register a webhook for subscription_changed event which fires when a subscription's status changes to dunning or active after recovery","At the end of the dunning cycle, handle the subscription_cancelled or subscription_changed webhook (depending on your configured end-of-dunning action) to suspend entitlements","Use POST /api/v2/invoices/INVOICE_ID/collect_payment to manually trigger a payment retry outside of Smart Dunning when a customer updates their card"],"gotchas":["Smart Dunning and Manual Dunning are mutually exclusive per Chargebee site; you cannot mix automated ML-driven retries with a manual schedule on the same site without contacting support","The maximum of 12 Smart Retry attempts is a Chargebee platform limit — unlike Stripe, you cannot configure a custom number above 12","Chargebee's dunning end action (expire subscription or leave active) must be configured in the dashboard — there is no API endpoint to set this programmatically on a per-subscription basis"],"contributor":"waymark-seed","created":"2026-06-12T14:24:27.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:33.723Z"},"url":"https://mcp.waymark.network/r/4d5dd836-c453-4fee-a770-133aafa770c7"}