how to set up dunning management for Shopify recurring payments | Updated August 2026 | Recurpay Editorial Team | 45–90 minutes setup time | Beginner
What You'll Learn
One of the fastest ways to leak money from a subscription business is doing nothing when a payment fails. Every month, thousands of your customers are sitting there wanting to stay subscribed, but their payment went through and nobody told them. That's involuntary churn, and it's recoverable — if you have the right system in place. Dunning management is the automated process that catches those failed payments, retries them intelligently, and gives customers a simple way to fix the problem without you lifting a finger. This guide walks you through setting it up end-to-end. You'll learn how to:
- Install a dedicated Shopify subscription app with robust dunning capabilities.
- Configure an optimized retry schedule that runs 24–48 hours after the initial failure, spaced across 7–14 days, differentiating between soft and hard declines.
- Build a compelling 3–5 email dunning sequence with escalating urgency and direct, one-click payment update links.
- Enable proactive pre-expiry card alerts to prevent payment failures before they occur.
- Monitor key recovery metrics and iterate on your dunning setup to continuously improve performance and maximize recovered revenue.
Prerequisites: An active Shopify store, at least one subscription product configured, and a subscription app installed (or readiness to install one). No developer experience required.
Why Dunning Management Matters in 2026
Failed payments cost the industry roughly $129 billion in 2025. But here's the thing that keeps most merchants up at night: involuntary churn — customers lost because their payment failed, not because they wanted to leave — accounts for 20 to 40% of all subscription churn depending on your segment.
These aren't unhappy customers making a conscious decision to cancel. An expired card, a fraud filter, a dip in someone's bank account — the customer often has no idea the charge failed. They're still using your product. They're still happy. And then, quietly, the billing system gives up after one or two tries and deactivates them.
The gap between merchants who act and those who don't is massive. Well-executed payment recovery strategies can recover 15–30% of failed payment revenue, while an optimized retry strategy can recover 45–70% of initially failed payments. Best-in-class businesses hit 70–85% recovery rates. The difference between those tiers isn't luck — it's how deliberately the dunning system was configured. According to PayRequest's 2026 benchmark, comprehensive multi-channel dunning can reach 70–80% recovery versus only 20–31% for basic retry-only systems.
The global subscription e-commerce market hit $2.72 trillion in 2025 and is projected to grow at 14.4% annually through 2034. For Shopify merchants in this landscape, a passive approach to failed payments isn't just missing money — it's a strategic liability. A properly configured dunning system is a core part of your recurring revenue infrastructure, not a technical afterthought.
Real talk: Dunning management is essential for protecting recurring revenue. It can recover 50–85% of failed payments and significantly reduce involuntary churn, which accounts for 20–40% of all subscription losses. For supporting data, see Subscription Management Tools: 6 Best Picks (2026).
The Process at a Glance
| Step | Action | Time | Outcome |
|---|---|---|---|
| 1 | Install a subscription app with dunning | 10–15 min | Dunning infrastructure connected to Shopify |
| 2 | Configure your retry schedule and logic | 15–20 min | Automated retries fire on optimized timing |
| 3 | Build your dunning email sequence | 20–30 min | Branded emails send automatically on failure |
| 4 | Enable pre-expiry card alerts | 5–10 min | Card failures prevented before they occur |
| 5 | Monitor recovery metrics and iterate | Ongoing | Recovery rate improves month over month |
Total estimated setup time: 45–90 minutes for initial configuration. Ongoing monitoring takes 15–30 minutes per month.
Step 1: Install a Subscription App with Built-In Dunning Management
What You're Doing
Shopify's native subscription tools handle basic recurring billing, but they don't handle failed payments well. Shopify retries failed charges on a fixed schedule with auto-generated emails and no machine learning or decline-specific optimization. If you're just starting out with a handful of subscribers, that might be enough. But the moment you scale, you're leaving money on the table. A dedicated subscription app with intelligent dunning management is what separates merchants recovering 30% of failed payments from those recovering 70%. This step gets the right infrastructure in place.
How to Do It
- Go to the Shopify App Store and search for a subscription app that explicitly lists dunning management as a feature.
- Install your chosen app and grant the required Shopify permissions during the OAuth flow.
- Complete the onboarding setup — connect your payment gateway, confirm your existing subscription products are recognized, and verify that recurring billing is active.
- Navigate to the dunning or failed-payment section of the app dashboard to confirm it is enabled by default or requires manual activation.
Recurpay is built specifically for this. The platform believes that unlocking subscription revenue should be accessible, fast, and hassle-free for all Shopify merchants. Recurpay's dunning management system is a fully automated solution designed to help Shopify subscription brands recover failed recurring payments before they turn into customer churn. Whether it's an expired credit card, insufficient funds, or a temporary bank decline, the system uses intelligent retry logic, automated email sequences, and customer-friendly interfaces to guide subscribers back to an active billing status. Get your Shopify store subscription-ready in minutes with seamless integration, easy migration, partner opportunities, and robust analytics to track growth. Scale your recurring revenue with no unnecessary complexity or hidden fees.
What Done Looks Like
Your subscription app is installed, your payment gateway is connected, and you can see a dunning or failed-payment management section inside the app dashboard. Existing subscriptions are visible and billing is active.
Next: A dedicated Shopify subscription app with intelligent dunning management is crucial for effective payment recovery, since Shopify's native tools lack the optimization that growing businesses need. For a more detailed walkthrough, see Dunning Management: Recover Failed Payments.
Join 7,500+ brands using Recurpay
Recurpay is the answer to your customer retention game in the emerging era of subscriptions.
Get StartedStep 2: Configure Your Retry Schedule and Decline Logic
What You're Doing
Not all payment failures are the same, and your retry strategy needs to reflect that reality. A soft decline signals a temporary condition — insufficient funds, a network timeout, a velocity limit — where retrying after a short delay can succeed. A hard decline signals a permanent block — a lost or stolen card, a closed account — where retrying makes things worse. Setting a single blanket retry cadence for both failure types is the most common and costly dunning mistake. This step fixes that.
How to Do It
- In your subscription app's dunning settings, locate the retry schedule configuration panel.
- Set your initial retry to fire 1–2 days after the first failure. Best practice is a retry sequence starting 24–48 hours after the first failure, spaced over 7–30 days, with email prompts linking directly to a payment update page.
- Configure subsequent retries for days 3–4, then days 6–7. Keep the total window within 14 days — most recoveries happen within 14 days, and extending a dunning window past 21 days adds minimal revenue while increasing the risk of card network penalty fees.
- Apply different handling for hard declines: for soft declines, retry first, then communicate if unsuccessful; for hard declines, immediate dunning communications are advisable, as retries are unlikely to succeed.
- Save your configuration and confirm the retry logic is active.
Example: Retry Schedule Reference
| Day | Action | Applies To |
|---|---|---|
| Day 0 | Payment fails — system detects decline code | All failures |
| Day 1–2 | First automatic retry | Soft declines only |
| Day 0 (hard) | Immediate email to update payment method | Hard declines only |
| Day 4–5 | Second retry + first customer email sent | Soft declines |
| Day 7 | Third retry + follow-up email | Soft declines |
| Day 10–14 | Final retry + urgent email / subscription hold | All unresolved failures |
Common Mistakes
Retrying hard declines on the same schedule as soft declines. A hard decline will fail again, no matter how you time it. Some processors will even penalize you for repeated attempts on a known-bad card. Always check whether your app distinguishes decline types before finalizing the schedule.
What Done Looks Like
Your app shows a configured multi-step retry schedule that differentiates between soft and hard declines, with retries spaced across a 7–14 day window and no attempts set beyond 21 days.
Next: Optimize your retry schedule by differentiating between soft (temporary) and hard (permanent) declines, initiating retries 24–48 hours after the first failure, and keeping the total dunning window within 14 days for maximum recovery.
Step 3: Build Your Dunning Email Notification Sequence
What You're Doing
Automated retries recover part of your failed payments silently in the background. But a significant share require customer action — an updated card number, a new payment method, or simply awareness that a problem exists. What actually works is a carefully sequenced series of emails that treats the customer as someone who wants to keep paying — because in most cases, they do. The goal is to inform without alarming and make the fix as frictionless as possible.
How to Do It
- Inside your subscription app, navigate to the email notifications or dunning communications section.
- Enable the pre-built notification templates if available, then customize them with your brand name, logo, and tone.
- Configure a sequence of 3–5 emails spanning 7–14 days. Adjust based on your business model — lower-cost subscriptions typically use shorter cycles than premium plans.
- Ensure every email contains a direct, one-click link to the customer's payment update page. Give customers a direct, secure way to update their payment methods — ideally through your customer portal or a one-click link in your reminder emails. If it requires too much work, they'll ignore it.
- Write subject lines that signal both the problem and the solution. Effective patterns include: "Quick fix needed for your subscription," "Your card expired — here's a one-click update," or "Action needed: payment did not go through."
- Set the tone to escalate gradually — friendly and informational in email 1, moderately urgent in email 3, and clearly time-limited in the final email.
Example: 4-Email Dunning Sequence
| Timing | Tone | Primary CTA | |
|---|---|---|---|
| Email 1 | Day 1–2 post-failure | Friendly, informational | Update payment method |
| Email 2 | Day 4–5 | Helpful, reminder tone | Update payment method |
| Email 3 | Day 7–8 | Moderately urgent | Update before subscription pauses |
| Email 4 | Day 12–14 | Final notice, time-bound | Reactivate now to keep access |
Best Practices
- Keep communications friendly, professional, and empathetic to preserve trust and loyalty. Avoid accusatory or threatening language.
- Use mobile-optimized templates with a single prominent CTA button — multiple CTAs reduce click-through on the most important action.
- Test subject line variations on your most important emails (particularly emails 1 and 3). A 5% improvement in email 1 open rate directly translates to recovered revenue.
What Done Looks Like
Your app shows an active email sequence with 3–5 messages scheduled at staggered intervals, each branded, each containing a direct payment update link, and each escalating in urgency from email 1 to the final notice.
Next: A 3–5 email dunning sequence sent over 7–14 days with escalating urgency and a single, one-click payment update link is essential for prompting customer action on failed payments.
Step 4: Enable Pre-Expiry Card Alerts
What You're Doing
The best dunning is the kind you never need to run. The most effective dunning starts before the charge fails — notifying a subscriber that their card is about to expire gives them a chance to update their details before the renewal runs. A prevented failure costs nothing to recover. Pre-expiry alerts are a lightweight, high-ROI addition to any dunning setup.
How to Do It
- In your subscription app, look for a "pre-expiry," "card expiration," or "proactive notifications" setting.
- Enable the alert and set the trigger window. Send an email or in-app reminder 30 days before the card's expiration — this encourages customers to update payment details early.
- Optionally, add a second reminder at 7 days before expiration for subscribers who didn't act on the first alert.
- Include a direct link to the customer self-service portal in every pre-expiry message so updating the card requires no more than one or two clicks.
- Save your settings and verify a test alert can be triggered in your app's preview or test mode.
Best Practices
- Keep pre-expiry messages brief and helpful — one sentence explaining the issue, one CTA to fix it.
- Pair email alerts with an in-app banner in the customer portal if your app supports it. In-app banners increase recovery rate by 10–20 percent on top of email-only sequences.
What Done Looks Like
Your app is configured to automatically send a branded pre-expiry notification 30 days before any stored card expires, with a direct link to the customer payment update page.
Step 5: Monitor Recovery Metrics and Iterate
What You're Doing
Configuration alone isn't a strategy. Dunning performance compounds when you review the data regularly and make targeted adjustments. Your recovery rate is the percentage of failed payments you successfully collect after dunning — this directly measures how well your process recovers revenue, and studies show businesses can recover as much as 5% of their recurring revenue with a solid dunning management process. Tracking the right numbers tells you where your system is losing revenue and what to fix.
How to Do It
- In your subscription app's analytics dashboard, locate the failed payment or dunning report. Review it at least once per month.
- Track four core metrics: total failed charges, recovery rate (recovered ÷ attempted), average days to recovery, and email open/click rates per dunning message.
- If your recovery rate is below 30%, audit your retry timing first — retries on incorrect days are the most common cause of underperformance.
- If email click-through rates are low on email 1, test a new subject line. Small gains in the first email compound across your entire subscriber base.
- Review the split between soft and hard declines monthly. Audit your failure reasons before building your retry schedule — treating all failed payments the same is the most common dunning mistake. Pull your decline codes: if 60% of failures are insufficient funds, time your retries around paydays.
What Done Looks Like
You have a documented monthly review process — at minimum checking recovery rate, email engagement, and decline-type breakdown — and at least one element of your dunning setup has been adjusted based on real data.
Next: Regularly monitor core dunning metrics like recovery rate and email engagement, and use decline code breakdowns to inform iterative adjustments to your retry timing and email content for continuous improvement.
What to Do After Setting Up Dunning Management
Phase 1 — Stabilize (Weeks 1–4): Let your dunning system run through at least one full billing cycle before making changes. Collect baseline data on recovery rate, open rates, and decline types. Resist the urge to tweak before you have statistically meaningful volume.
Phase 2 — Optimize (Months 2–3): Use your first month's data to refine retry timing and email subject lines. If your app supports it, segment your dunning sequence by failure type — treat soft declines and hard declines with distinct email messaging. Add a second pre-expiry reminder at 7 days if your 30-day alert isn't generating sufficient card updates.
Phase 3 — Expand (Month 3+): Layer in additional recovery channels if your platform supports them. Recurpay's dunning management system recovers failed payments through email, SMS, and WhatsApp without manual intervention — activating SMS or WhatsApp for high-value subscribers in later dunning stages can materially lift recovery rates. Pair dunning performance data with your broader churn analysis to distinguish involuntary from voluntary subscriber loss and address each with the appropriate strategy.
Next: After initial setup, stabilize your dunning system for one month, then optimize retry timing and email content in months 2–3, and finally expand to multi-channel recovery (e.g., SMS, WhatsApp) for high-value subscribers.
Resources You'll Need
| Resource | Role | Required / Recommended / Optional | Price |
|---|---|---|---|
| Recurpay | Shopify subscription app with built-in dunning management, retry logic, and multi-channel notifications | Required (or equivalent app) | From $9/month — Rating: 5/5 |
| Shopify Recurring Payments Guide | Official Shopify documentation on subscription billing fundamentals | Recommended | Free |
| Stripe — Managing Expired Cards for Recurring Payments | Reference guide for understanding card expiry, Account Updater services, and dunning best practices | Recommended | Free |
| Baremetrics — Dunning Emails Guide (2026) | Email cadence frameworks, subject line patterns, and timing benchmarks for dunning sequences | Optional | Free |
| HubiFi — Dunning Optimization Guide | Benchmarks and optimization frameworks for measuring and improving recovery rates | Optional | Free |
See also, see What Is Dunning Management? Why It's Essential for ....
Troubleshooting Common Issues
Recovery Rate Is Below 25% After the First Full Month
Likely cause: Retry timing doesn't align with when subscribers' funds are available, or the app is applying the same schedule to all decline types regardless of cause.
Fix: Pull your decline code breakdown from the analytics dashboard. Soft declines such as insufficient funds benefit from retries timed around typical paydays — the 1st and 15th of the month. Confirm your retry schedule reflects this, and verify that hard declines are triggering immediate customer outreach rather than silent retries.
Dunning Emails Are Being Opened But Not Acted On
Likely cause: The email contains a broken or login-required link to the payment update page, creating too much friction for the customer to complete the action.
Fix: Test your payment update link in an incognito browser. It should land the customer directly on the payment update form without requiring a separate login step. Give customers a direct, secure way to update their payment methods — ideally through a one-click link in your reminder emails. Reduce the number of CTAs in each email to exactly one.
Pre-Expiry Alerts Are Not Reducing the Volume of Failed Payments
Likely cause: The alert is firing too close to the expiry date, leaving insufficient time for the subscriber to notice and act before the next billing cycle runs.
Fix: Move the trigger window to 30 days before expiration and add a second alert at 7 days. Even a single reminder sent each time a card is nearing its expiration helps decrease declines — don't assume customers will notice the date on their cards or update them without a prompt.
Dunning Emails Are Causing Subscription Cancellations
Likely cause: Email copy is alarmist or the messaging implies the subscription is already cancelled rather than recoverable.
Fix: Your dunning sequence should achieve two things — recover payments and keep customers happy. Keep communications friendly, professional, and empathetic to preserve trust and loyalty. Avoid accusatory or threatening language. For soft declines specifically, consider running 1–2 silent retry attempts before sending any customer-facing email. Research from PYMNTS shows that credit card declines prompt 27% of subscribers to cancel their subscriptions or switch to a competitor — so tone and timing on that first email are critical.
Next: Common dunning issues like low recovery rates, unacted-upon emails, and increased cancellations can be resolved by optimizing retry timing, ensuring frictionless payment update links, setting earlier pre-expiry alerts, and maintaining empathetic email communication. For more troubleshooting advice, see Smart Dunning Management for Shopify Subscriptions.
Conclusion
Key Takeaways
- Outcome recap: Learning how to set up dunning management for Shopify recurring payments takes under 90 minutes and directly protects monthly recurring revenue from the involuntary churn that accounts for 20–40% of all subscription losses.
- Key insight: The difference between a 25% and a 70%+ recovery rate is almost entirely about distinguishing soft from hard declines, spacing retries intelligently within a 7–14 day window, and pairing automated retries with a well-timed, low-friction email sequence.
- Next action: Install a Shopify subscription app with native dunning support — Recurpay offers this at $9/month with a 5/5 rating — then complete Steps 2 through 5 in a single focused session to have your dunning system live before your next billing cycle runs.
FAQ
How do you set up dunning management for Shopify recurring payments?
To set up dunning management for Shopify recurring payments, follow these five steps: (1) Install a Shopify subscription app with built-in dunning support — Shopify's native tools use a fixed retry schedule with no decline-type differentiation, so a dedicated app is required for effective recovery. (2) Configure your retry schedule to fire 24–48 hours after the first failure, with subsequent retries on days 4–5 and 7, keeping the total window within 14 days. Apply different logic to soft declines (retry first) and hard declines (contact the customer immediately). (3) Build a 3–5 email dunning sequence with escalating urgency and a one-click payment update link in every message. (4) Enable pre-expiry card alerts to fire 30 days before stored card expiration, preventing failures before they occur. (5) Monitor your recovery rate monthly, audit your decline-code breakdown, and adjust retry timing and email subject lines based on real performance data. This is the complete How to Set up dunning management for Shopify recurring payments — Step-by-Step Guide (2026) workflow that takes under 90 minutes to configure initially.
What is dunning management, and why does it matter for Shopify subscriptions?
Dunning management is the automated system a subscription business uses to detect failed payments, retry them on an optimized schedule, and notify customers so they can update their billing information before the subscription lapses. It matters for Shopify subscriptions because involuntary churn — subscribers lost to payment failures rather than conscious cancellations — accounts for 20–40% of all subscription losses. Without dunning, every failed payment becomes a permanently lost customer and lost revenue. With a properly configured system, merchants can recover 50–70% or more of those failed charges automatically.
How many retry attempts should a Shopify dunning sequence include?
Most effective dunning sequences include 3–4 retry attempts spaced across a 7–14 day window. The first retry should fire 24–48 hours after the initial failure. Subsequent retries work well on days 4–5 and day 7. A final attempt can run on day 10–14 if the previous retries haven't succeeded. Extending retries past 21 days adds very little incremental recovery and risks triggering card network penalties — Visa and Mastercard cap retries at 15 attempts within 30 days per payment credential.
What is the difference between a soft decline and a hard decline in subscription billing?
A soft decline is a temporary payment failure — caused by insufficient funds, a bank timeout, a transaction velocity limit, or a temporary issuer hold. The card itself is valid, and a later retry often succeeds without any customer action. A hard decline is a permanent failure — the card has been reported lost or stolen, the account is closed, or the card number is invalid. Retrying a hard decline won't succeed and may result in processor penalties. The correct response to a hard decline is immediate customer outreach asking for a new payment method, not additional retry attempts.
What should a dunning email sequence include?
An effective dunning email sequence should include 3–5 emails sent over 7–14 days after a payment failure. Each email must contain: a clear, blame-free explanation of the payment issue; a single prominent CTA button linking directly to the payment update page (no login friction); and messaging that escalates in urgency from friendly notification in email 1 to a time-limited final notice. Subject lines should signal both the problem and the solution in 35 characters or fewer. Avoid accusatory language — the customer almost always didn't intend for their payment to fail, and maintaining a supportive tone preserves the subscriber relationship throughout the recovery window.
How do pre-expiry card alerts prevent failed payments?
Pre-expiry card alerts notify subscribers 30 days (and optionally 7 days) before their stored payment card expires, giving them time to update their billing details before the next renewal charge runs. Because a prevented failure requires no retry logic, no dunning email, and no customer frustration, pre-expiry alerts are one of the highest-ROI components of a dunning setup. They work best when paired with a direct, one-click link to the customer's self-service payment update page — removing any friction from the update process increases the rate at which subscribers act on the alert.
How long does it take to see results from dunning management on Shopify?
Most Shopify merchants begin seeing measurable recovery within the first billing cycle after dunning is configured — typically 30 days. The first month should be treated as a data-collection period: run the system as configured, then review recovery rate, email open rates, and decline-code breakdown before making any adjustments. Meaningful optimization generally happens in months 2 and 3, when you have enough data to refine retry timing and email copy. Best-in-class recovery rates of 70–85% are typically achieved after 2–3 iterative improvement cycles, not on initial setup.
Can dunning management work across multiple channels beyond email?
Yes. Email is the most common dunning channel, but multi-channel dunning consistently outperforms email-only approaches. In-app banners in the customer self-service portal can increase recovery rates by 10–20% on top of email sequences alone. SMS and messaging app notifications — such as WhatsApp — are particularly effective for high-value subscribers in the later stages of a dunning sequence, when urgency is higher and email may have been missed. Recurpay's dunning system supports email, SMS, and WhatsApp notifications, making it straightforward for Shopify merchants to run multi-channel dunning without additional integrations.
Methodology: This guide was produced by the Recurpay editorial team in August 2026. Statistics, benchmarks, and industry figures are sourced from publicly available 2025–2026 research by Recurly, Baremetrics, PYMNTS, PayRequest, and other industry analysts as cited inline. Recovery rate ranges represent industry benchmarks and will vary by vertical, subscriber base size, payment gateway, and dunning configuration. Pricing and feature references for Recurpay reflect information available at publication date. This article is published by Recurpay for informational purposes for Shopify merchants evaluating subscription and dunning management strategies and does not constitute financial or legal advice.