Dunning refers to retrying failed or declined credit card payments repeatedly and automatically to prevent a subscription from canceling. The dunning period for subscriptions usually extends over 30 days. During this time a failed payment is retried a number of times with increasing intervals in an attempt to keep a subscription active.
Dunning in subscriptions is triggered by an unsuccessful payment attempt. If the subscriber’s credit card has expired and can’t be charged, the payment for their subscription can’t be processed on time, thus triggering the dunning flow.Following the trigger, automatic credit card charge attempts will be made repeatedly over a period of time, e.g. 1 day, 2 days, 4 days, 8 days, 16 days and 30 days after the initial, unsuccessful payment attempt. Both the dunning period and payment intervals can be adjusted to the merchants’ needs in the Merchant Portal.Unsuccessful payment attempt in dunning is often also accompanied by an email notification that asks the subscriber to review their payment method. If the subscriber fails to do so and all subsequent dunning attempts also fail, the subscription is failed as a result.If any of the subsequent payment attempts is successful, the subscription retains its active status and is renewed immediately.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Juo Subscriptions documentation","colors":{"primary":"#3727F4","light":"#3727F4","dark":"#d9d9d9"},"logo":{"light":"https://mintcdn.com/juo-docs/cLJUw5eiI9OKM0X6/logo/light.svg?fit=max\u0026auto=format\u0026n=cLJUw5eiI9OKM0X6\u0026q=85\u0026s=d41a8b3ca189a0212d8c707309bddacd","dark":"https://mintcdn.com/juo-docs/cLJUw5eiI9OKM0X6/logo/dark.svg?fit=max\u0026auto=format\u0026n=cLJUw5eiI9OKM0X6\u0026q=85\u0026s=29f70ff3ce5c77142a480d3a3f94e08e"},"favicon":{"light":"https://mintcdn.com/juo-docs/yVQsOyGv0SLbx5Dr/favicon.png?fit=max\u0026auto=format\u0026n=yVQsOyGv0SLbx5Dr\u0026q=85\u0026s=d6cb6daa51052383f471eedf80ad8402","dark":"https://mintcdn.com/juo-docs/yVQsOyGv0SLbx5Dr/favicon.png?fit=max\u0026auto=format\u0026n=yVQsOyGv0SLbx5Dr\u0026q=85\u0026s=d6cb6daa51052383f471eedf80ad8402"},"navbar":{"links":[{"href":"mailto:hi@juo.io","label":"Contact us"}],"primary":{"type":"button","label":"Book a demo","href":"https://juo.io/demo"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/juo-io"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API","icon":"code","href":"https://juo.dev/"},{"anchor":"Changelog","icon":"newspaper","href":"https://juo.com/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"juo-docs","hasAudioNarration":false,"actualSubdomain":"juo-docs","customDomains":["juo.io"],"gitSource":{"type":"github","owner":"juo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae49eefab76b29675b215f5","collectionId":"c11c4ea5-7b0f-4ee0-9ece-bde04d69496c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae49eefab76b29675b215f5"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae49eefab76b29675b215f5","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Glossary","count":24},{"language":"default","tag":"Use guide","count":12},{"language":"default","tag":"Workflows","count":8},{"language":"default","tag":"Subscription experiences","count":7},{"language":"default","tag":"Integrations","count":7},{"language":"default","tag":"Settings","count":6},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Use cases","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/juo-docs/67fbaf3080934196/style.css"},{"filePath":"sidebar-scroll-fade.css","content":":root{--scrollbar-size: 8px;--scrollbar-thumb: rgba(0, 0, 0, 0.15);--reveal-speed: 0ms}#sidebar-content{scrollbar-width:thin;scrollbar-color:transparent transparent}#sidebar-content::-webkit-scrollbar{width:var(--scrollbar-size)}#sidebar-content::-webkit-scrollbar-track{background:transparent}#sidebar-content::-webkit-scrollbar-thumb{background-color:transparent;border-radius:calc(var(--scrollbar-size) / 2);transition:background-color var(--reveal-speed)}#sidebar-content:hover,#sidebar-content:active{scrollbar-color:var(--scrollbar-thumb) transparent}#sidebar-content:hover::-webkit-scrollbar-thumb,#sidebar-content:active::-webkit-scrollbar-thumb,#sidebar-content::-webkit-scrollbar-thumb:hover{background-color:var(--scrollbar-thumb)}"}],"page":{"pagePath":"glossary/dunning","slug":"/glossary/dunning","pageMetadata":{"title":"Dunning","description":null,"href":"/glossary/dunning"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsx(_components.p,{children:`Retrying failed or declined credit card payments to prevent subscription cancellation.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-is-dunning`,children:`What is dunning`}),`\n`,_jsxs(_components.p,{children:[`Dunning refers to retrying failed or declined credit card payments repeatedly and automatically to prevent a subscription from canceling. The dunning period for `,_jsx(_components.a,{href:`/glossary/subscription`,children:`subscriptions`}),` usually extends over 30 days. During this time a failed payment is retried a number of times with increasing intervals in an attempt to keep a subscription active.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-dunning-works`,children:`How dunning works`}),`\n`,_jsxs(_components.p,{children:[`Dunning in subscriptions is triggered by an unsuccessful payment attempt. If the `,_jsx(_components.a,{href:`/glossary/subscriber`,children:`subscriber’s`}),` credit card has expired and can’t be charged, the payment for their subscription can’t be processed on time, thus triggering the dunning flow.`]}),`\n`,_jsxs(_components.p,{children:[`Following the trigger, automatic credit card charge attempts will be made repeatedly over a period of time, e.g. 1 day, 2 days, 4 days, 8 days, 16 days and 30 days after the initial, unsuccessful payment attempt. Both the dunning period and payment intervals can be adjusted to the merchants’ needs in the `,_jsx(_components.a,{href:`/glossary/merchant-portal`,children:`Merchant Portal`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Unsuccessful payment attempt in dunning is often also accompanied by an `,_jsx(_components.a,{href:`/glossary/email-notifications`,children:`email notification`}),` that asks the subscriber to review their payment method. If the subscriber fails to do so and all subsequent dunning attempts also fail, the subscription is failed as a result.`]}),`\n`,_jsxs(_components.p,{children:[`If any of the subsequent payment attempts is successful, the subscription retains its active status and is `,_jsx(_components.a,{href:`/glossary/subscription-renewal`,children:`renewed`}),` immediately.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Dunning","description":null,"href":"/glossary/dunning"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is dunning","slug":"what-is-dunning","depth":2,"children":[]},{"title":"How dunning works","slug":"how-dunning-works","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"juo-docs","siteName":"Juo Subscriptions documentation","title":"Dunning - Juo Subscriptions documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T13:35:54.038Z","originalFileLocation":"glossary/dunning.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Juo Subscriptions documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Dunning - Juo Subscriptions documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Juo Subscriptions documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://juo.io/docs/glossary/dunning\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://juo-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Glossary\u0026amp;title=Dunning\u0026amp;theme=744beef7a106f2cad03d3b03\u0026amp;signature=415de06470e3b10a982f3402c5f446f41641d7112b6d72ea89767a56c278d517\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Dunning - Juo Subscriptions documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://juo-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Glossary\u0026amp;title=Dunning\u0026amp;theme=744beef7a106f2cad03d3b03\u0026amp;signature=415de06470e3b10a982f3402c5f446f41641d7112b6d72ea89767a56c278d517\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Juo Subscriptions documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3727F4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://juo.io/docs/glossary/dunning\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/glossary/dunning.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://juo.io/#organization\",\"name\":\"Juo Subscriptions documentation\",\"url\":\"https://juo.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/juo-docs/cLJUw5eiI9OKM0X6/logo/light.svg?fit=max\u0026auto=format\u0026n=cLJUw5eiI9OKM0X6\u0026q=85\u0026s=d41a8b3ca189a0212d8c707309bddacd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://juo.io/docs#website\",\"name\":\"Juo Subscriptions documentation\",\"url\":\"https://juo.io/docs\",\"publisher\":{\"@id\":\"https://juo.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://juo.io/docs/glossary/dunning#webpage\",\"url\":\"https://juo.io/docs/glossary/dunning\",\"name\":\"Dunning\",\"dateModified\":\"2026-10-30T13:35:54.038Z\",\"isPartOf\":{\"@id\":\"https://juo.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://juo.io/docs/glossary/dunning#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://juo.io/docs/glossary/dunning#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\" \",\"item\":\"https://juo.io/docs/glossary/build-a-box\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Glossary\",\"item\":\"https://juo.io/docs/glossary/build-a-box\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Dunning\",\"item\":\"https://juo.io/docs/glossary/dunning\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://juo.io/docs/glossary/dunning#article\",\"headline\":\"Dunning\",\"name\":\"Dunning\",\"url\":\"https://juo.io/docs/glossary/dunning\",\"mainEntityOfPage\":{\"@id\":\"https://juo.io/docs/glossary/dunning#webpage\"},\"dateModified\":\"2026-10-30T13:35:54.038Z\",\"publisher\":{\"@id\":\"https://juo.io/#organization\"},\"isPartOf\":{\"@id\":\"https://juo.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Juo Subscriptions documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Juo Subscriptions documentation","nav":{"global":{"anchors":[{"anchor":"API","icon":"code","href":"https://juo.dev/"},{"anchor":"Changelog","icon":"newspaper","href":"https://juo.com/changelog"}]},"groups":[{"group":"Getting started","pages":[{"title":"Intro","href":"/index"},{"title":"About Juo","href":"/about-juo"},{"title":"Use Juo with an AI assistant","sidebarTitle":"Juo MCP","href":"/use-juo-with-ai"},{"title":"Subscription experiences","href":"/subscription-experiences"},{"title":"Retention","href":"/retention"}]},{"group":"Subscription experiences","pages":[{"title":"Subscribe and save","href":"/subscribe-and-save"},{"title":"Build-a-box","href":"/build-a-box"},{"title":"Upsells","href":"/upsells"},{"title":"Extras","href":"/extras"},{"title":"Custom workflows","href":"/custom-workflows"},{"title":"Curated boxes","href":"/curated-boxes"},{"title":"Memberships","href":"/memberships"}]},{"group":"Workflows","pages":[{"title":"Workflows overview","sidebarTitle":"Overview","href":"/workflows/workflows-overview"},{"title":"Triggers","href":"/workflows/triggers"},{"title":"Conditions","href":"/workflows/conditions"},{"title":"Actions","href":"/workflows/actions"},{"title":"Experiments (A/B tests)","sidebarTitle":"Experiments","href":"/workflows/experiments"},{"group":"Use cases","pages":[{"title":"Cancellation flow","href":"/workflows/guides/cancellation-flow"},{"title":"Fight new subscriber churn","href":"/workflows/guides/fight-new-subscriber-churn"},{"title":"VIP rewards","href":"/workflows/guides/vip-rewards"}]}]},{"group":"Settings","pages":[{"title":"General settings","href":"/general-settings"},{"title":"Retention and acquisition settings","sidebarTitle":"Retention settings","href":"/retention-flow"},{"title":"Shipping setup","href":"/shipping-setup"},{"title":"Notifications","href":"/notifications"},{"title":"SID conversion engine","href":"/subscription-intent-detection"},{"title":"SEPA chargebacks recovery","href":"/sepa-chargebacks"}]},{"group":"Integrations","pages":[{"title":"Klaviyo","href":"/klaviyo-integration"},{"title":"Hubspot","href":"/hubspot-integration"},{"title":"Customer.io","href":"/customerio-integration"},{"title":"Gorgias","href":"/gorgias-integration"},{"title":"Zipify","href":"/zipify-integration"},{"title":"Webhooks","href":"/webhooks"},{"title":"Leat","href":"/leat-integration"}]},{"group":"Use guide","pages":[{"title":"Editor","sidebarTitle":"Editor","href":"/editor"},{"title":"Managing subscriptions","href":"/managing-subscriptions"},{"title":"Create a subscription","href":"/create-subscription"},{"title":"Bulk actions","href":"/bulk-actions"},{"title":"Using Customer Portal","href":"/customer-portal"},{"title":"Customer Portal link","href":"/linking-customer-portal"},{"title":"Quick actions","href":"/quick-actions"},{"title":null,"href":"/discounts"},{"title":"Tiered discounts","href":"/tiered-discounts"},{"title":"Subscription widget","href":"/adding-juo-subscription-widget"},{"title":"Customize widget","href":"/subscription-widget"},{"title":"Build a custom subscription storefront","sidebarTitle":"Custom storefront","href":"/custom-storefront"}]},{"group":" ","pages":[{"group":"Glossary","pages":[{"title":"Build A Box","href":"/glossary/build-a-box"},{"title":"Customer Portal","href":"/glossary/customer-portal"},{"title":"Delivery Frequency","description":null,"href":"/glossary/delivery-frequency"},{"title":"Dunning","href":"/glossary/dunning"},{"title":"Dynamic Boxes","description":null,"href":"/glossary/dynamic-boxes"},{"title":"Email Notifications","href":"/glossary/email-notifications"},{"title":"Inventory Policy","href":"/glossary/inventory-policy"},{"title":"Lifetime Value","href":"/glossary/lifetime-value"},{"title":"Membership","href":"/glossary/membership"},{"title":"Merchant Portal","href":"/glossary/merchant-portal"},{"title":"Migration","href":"/glossary/migration"},{"title":"One Time Purchase","href":"/glossary/one-time-purchase"},{"title":"Product Swap","href":"/glossary/product-swap"},{"title":"Retention Flow","href":"/glossary/retention-flow"},{"title":"Skip Renewal","href":"/glossary/skip-renewal"},{"title":"Stock Keeping Unit","href":"/glossary/stock-keeping-unit"},{"title":"Subscriber","href":"/glossary/subscriber"},{"title":"Subscription Box","href":"/glossary/subscription-box"},{"title":"Subscription Cancellation","href":"/glossary/subscription-cancellation"},{"title":"Subscription Order","href":"/glossary/subscription-order"},{"title":"Subscription Pause","href":"/glossary/subscription-pause"},{"title":"Subscription Renewal","href":"/glossary/subscription-renewal"},{"title":"Subscription","href":"/glossary/subscription"},{"title":"Variable Discount","href":"/glossary/variable-discount"}]}]}]},"basePath":"","title":"Dunning - Juo Subscriptions documentation","buildId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","deploymentId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","dynamics":[],"chunks":[]}