Create dunning campaigns in the Recurly dashboard under Configuration > Dunning; each campaign defines a retry schedule (intervals, maximum attempts) and email notification steps
Assign a dunning campaign to a specific plan via the plan's dunning_campaign_id field so different subscriber segments get different dunning treatment
Enable Intelligent Retries in the dashboard under Configuration > Recurly Recover; this ML-based system analyzes payment patterns to time retries optimally for soft declines
Register a webhook for new_dunning_event notification; the payload includes invoice UUID, attempt_number, next_attempt_at, and dunning_campaign_id
Register webhooks for invoice/closed (successful collection) and subscription/expired (dunning exhausted) to trigger downstream actions
For communication errors, Intelligent Retries will attempt up to 2 retries 4 hours apart, then 6 retries 1 day apart, then retries 3 days apart through end of dunning cycle — total attempts do not exceed 20 over 60 days
Known gotchas
Recurly Intelligent Retries is a premium Recover feature — it is not available on all Recurly plans; verify entitlement in your account before building logic that depends on it
At the end of a dunning cycle Recurly only supports two subscription outcomes: expire the subscription or leave it active — there is no built-in 'suspend' or 'pause' state triggered automatically by dunning exhaustion
The dunning campaign assigned to a plan only applies to new subscriptions enrolled after the campaign assignment; existing subscriptions retain the campaign active at the time of enrollment
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp