Autumn uses Stripe subscriptions under the hood to handle recurring billing. When you attach a plan to a customer, Autumn creates the Stripe subscription and provisions feature balances automatically.When a subscription is created, Autumn provisions balances for each feature in the plan. Balances determine what the customer can access and track how much they’ve used. For example, a Pro plan might grant 1,000 API requests per month—this becomes a balance that decrements as the customer uses your product.Balances can also be created for credit systems (eg, $10 credits per month) and boolean toggle features (eg, access to a premium analytics dashboard).
Subscription statuses
Status
Description
active
Subscription is in good standing
trialing
Customer is in a free trial period
past_due
Payment failed, subscription needs attention
scheduled
Product will activate at end of current billing period
expired
Subscription has ended
Accepting Payments
Learn about the checkout and payment flow
Managing Subscriptions
Handle upgrades, downgrades and cancellations
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Autumn","colors":{"primary":"#8838ff","light":"#9b5cff","dark":"#8838ff"},"logo":{"light":"https://mintcdn.com/leylandscompany/to8Sl5QONVKXQmtE/docs-wallis/assets/logo/autumn-dark.svg?fit=max\u0026auto=format\u0026n=to8Sl5QONVKXQmtE\u0026q=85\u0026s=7e3c381fb722c47325d41aaf2a885730","dark":"https://mintcdn.com/leylandscompany/to8Sl5QONVKXQmtE/docs-wallis/assets/logo/autumn-light.svg?fit=max\u0026auto=format\u0026n=to8Sl5QONVKXQmtE\u0026q=85\u0026s=aa1f28cb6227aa76e46313fdf0d1ea51"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/leylandscompany/docs-wallis/favicon.svg","api":{"playground":{"display":"interactive"},"examples":{"languages":["typescript","python","bash"]}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.useautumn.com"}},"footer":{"socials":{"x":"https://x.com/autumnpricing","github":"https://github.com/useautumn","linkedin":"https://linkedin.com/company/useautumn"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"contextual":{"options":["copy","cursor"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"leylandscompany","hasAudioNarration":false,"actualSubdomain":"leylandscompany","customDomains":["authtest.leylnd.me"],"gitSource":{"type":"github","owner":"yangleyland","repo":"docs-wallis","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"docs-wallis","label":"","_id":"6af233dcc51f81d987dc1453"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcaaa0e27a1477ddc702f4","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Autumn","count":159},{"language":"default","tag":"API Reference","count":77},{"language":"default","tag":"Documentation","count":62},{"language":"default","tag":"Configure Pricing","count":19},{"language":"default","tag":"ZZ Tools","count":18},{"language":"default","tag":"Billing","count":17},{"language":"default","tag":"Customers","count":15},{"language":"default","tag":"Additional Resources","count":14},{"language":"default","tag":"Rewards \u0026 Referrals","count":13},{"language":"default","tag":"Balances","count":10}]},"assistantConfig":{"enableStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false,"authValue":{"auth":{}}},"customCss":[{"filePath":"docs-wallis/language-tabs.css","content":"[data-testid=\"code-sample-language-select\"],.code-sample-language-select,[aria-haspopup=\"listbox\"]{}"},{"filePath":"docs-wallis/style.css","content":".prose>.api-section{display:none!important}"}],"page":{"pagePath":"docs-wallis/documentation/concepts/subscriptions","slug":"/docs-wallis/documentation/concepts/subscriptions","pageMetadata":{"title":"Subscriptions","description":"How Autumn manages customer subscriptions","href":"/docs-wallis/documentation/concepts/subscriptions","public":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How Autumn manages customer subscriptions\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Mermaid,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Autumn uses Stripe subscriptions under the hood to handle recurring billing. When you attach a plan to a customer, Autumn creates the Stripe subscription and provisions feature balances automatically.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n P[Plan] -->|attach| C[Customer]\n C -->|creates| S[Stripe Subscription]\n S -->|provisions| B[Balances]`}),`\n`,_jsxs(_components.p,{children:[`When a subscription is created, Autumn provisions `,_jsx(_components.a,{href:`/docs-wallis/documentation/concepts/balances`,children:`balances`}),` for each feature in the plan. Balances determine what the customer can access and track how much they’ve used. For example, a Pro plan might grant 1,000 API requests per month—this becomes a balance that decrements as the customer uses your product.`]}),`\n`,_jsxs(_components.p,{children:[`Balances can also be created for `,_jsx(_components.a,{href:`/docs-wallis/documentation/modelling-pricing/credit-systems`,children:`credit systems`}),` (eg, $10 credits per month) and boolean toggle features (eg, access to a premium analytics dashboard).`]}),`\n`,_jsx(Heading,{level:`2`,id:`subscription-statuses`,children:`Subscription statuses`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`active`})}),_jsx(_components.td,{children:`Subscription is in good standing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trialing`})}),_jsx(_components.td,{children:`Customer is in a free trial period`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`past_due`})}),_jsx(_components.td,{children:`Payment failed, subscription needs attention`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scheduled`})}),_jsx(_components.td,{children:`Product will activate at end of current billing period`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expired`})}),_jsx(_components.td,{children:`Subscription has ended`})]})]})]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Accepting Payments`,icon:`credit-card`,href:`/docs-wallis/documentation/customers/payment-flow`,children:_jsx(_components.p,{children:`Learn about the checkout and payment flow`})}),_jsx(Card,{title:`Managing Subscriptions`,icon:`sliders`,href:`/docs-wallis/documentation/customers/subscription-lifecycle`,children:_jsx(_components.p,{children:`Handle upgrades, downgrades and cancellations`})})]})]})}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":"Subscriptions","description":"How Autumn manages customer subscriptions","href":"/docs-wallis/documentation/concepts/subscriptions","public":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Subscription statuses","slug":"subscription-statuses","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/authtest.leylnd.me/4effaa931c2ef138/docs-wallis/dynamic-response.js"],"subdomain":"authtest.leylnd.me","siteName":"Autumn","title":"Subscriptions - Autumn","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T00:29:02.392Z","originalFileLocation":"docs-wallis/documentation/concepts/subscriptions.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=\"description\" content=\"How Autumn manages customer subscriptions\">\u003cmeta data-mint-head name=\"application-name\" content=\"Autumn\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_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=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Subscriptions - Autumn\">\u003cmeta data-mint-head property=\"og:description\" content=\"How Autumn manages customer subscriptions\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Autumn\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://leylandscompany.mintlify.io/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Subscriptions\u0026amp;description=How+Autumn+manages+customer+subscriptions\u0026amp;theme=e04c80a420b14e31bbb7053f\u0026amp;signature=a8d9043801defab266de7d6df31e0770cb23713bcd771de36d4a1d66227bd9b8\">\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=\"Subscriptions - Autumn\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How Autumn manages customer subscriptions\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://leylandscompany.mintlify.io/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Subscriptions\u0026amp;description=How+Autumn+manages+customer+subscriptions\u0026amp;theme=e04c80a420b14e31bbb7053f\u0026amp;signature=a8d9043801defab266de7d6df31e0770cb23713bcd771de36d4a1d66227bd9b8\">\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=\"/mintlify-assets/_mintlify/favicons/leylandscompany/IXLIteGDEKXyFwuk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Autumn\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8838ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs-wallis/documentation/concepts/subscriptions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://authtest.leylnd.me/#organization\",\"name\":\"Autumn\",\"url\":\"https://authtest.leylnd.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/leylandscompany/to8Sl5QONVKXQmtE/docs-wallis/assets/logo/autumn-dark.svg?fit=max\u0026auto=format\u0026n=to8Sl5QONVKXQmtE\u0026q=85\u0026s=7e3c381fb722c47325d41aaf2a885730\"}},{\"@type\":\"WebSite\",\"@id\":\"https://authtest.leylnd.me#website\",\"name\":\"Autumn\",\"url\":\"https://authtest.leylnd.me\",\"publisher\":{\"@id\":\"https://authtest.leylnd.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions#webpage\",\"url\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions\",\"name\":\"Subscriptions\",\"description\":\"How Autumn manages customer subscriptions\",\"dateModified\":\"2026-11-14T00:29:02.392Z\",\"isPartOf\":{\"@id\":\"https://authtest.leylnd.me#website\"},\"breadcrumb\":{\"@id\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\" \",\"item\":\"https://authtest.leylnd.me/docs-wallis/welcome\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Concepts\",\"item\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Subscriptions\",\"item\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions#article\",\"headline\":\"Subscriptions\",\"name\":\"Subscriptions\",\"description\":\"How Autumn manages customer subscriptions\",\"url\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions\",\"mainEntityOfPage\":{\"@id\":\"https://authtest.leylnd.me/docs-wallis/documentation/concepts/subscriptions#webpage\"},\"dateModified\":\"2026-11-14T00:29:02.392Z\",\"publisher\":{\"@id\":\"https://authtest.leylnd.me/#organization\"},\"isPartOf\":{\"@id\":\"https://authtest.leylnd.me#website\"}}]}\u003c/script>","agentPointerHref":"/docs-wallis/documentation/concepts/subscriptions.md","siteName":"Autumn","nav":{"global":null,"products":[{"product":"Autumn","tabs":[{"tab":"Documentation","icon":"folder-open","groups":[{"group":" ","public":true,"pages":[{"group":"Concepts","pages":[{"title":"How It Works","sidebarTitle":"Overview","href":"/docs-wallis/documentation/concepts/overview"},{"title":"Plans","href":"/docs-wallis/documentation/concepts/plans"},{"title":"Features","href":"/docs-wallis/documentation/concepts/features"},{"title":"Plan Items","description":"Configure what customers get access to when they purchase a plan","href":"/docs-wallis/documentation/concepts/plan-items"},{"title":"Subscriptions","href":"/docs-wallis/documentation/concepts/subscriptions","public":true},{"title":"Balances","description":"Understanding how feature balances work in Autumn","href":"/docs-wallis/documentation/concepts/balances"},{"title":"Stripe Sync","href":"/docs-wallis/documentation/concepts/stripe"}],"public":true},{"title":"Migrating to Autumn","href":"/docs-wallis/documentation/getting-started/migration"},{"title":"MCP Server","sidebarTitle":"Agents \u0026 MCP","href":"/docs-wallis/documentation/mcp"}]},{"group":"Getting Started","pages":[]},{"group":"Configure Pricing","pages":[]},{"group":"Billing \u0026 Subscriptions","pages":[]},{"group":"Customers","pages":[]},{"group":"Additional Resources","pages":[{"group":"Lakehouse","pages":[]}]}]},{"tab":"Examples","icon":"graduation-cap","pages":[]},{"tab":"CLI","icon":"square-terminal","pages":[]},{"tab":"API Reference","icon":"display-code","groups":[{"group":"Billing","pages":[{"group":"Licenses","pages":[]}]},{"group":"Balances","pages":[]},{"group":"Customers","pages":[]},{"group":"Authorization","pages":[]},{"group":"Events","pages":[]},{"group":"Entities","pages":[]},{"group":"Plans","pages":[]},{"group":"Features","pages":[]},{"group":"Rewards \u0026 Referrals","pages":[]},{"group":"Webhook Events","pages":[{"group":"Balances","pages":[]},{"group":"Billing","pages":[]},{"group":"Vercel","pages":[]}]},{"group":"Platform (Beta)","pages":[]}]},{"tab":"Changelog","icon":"list-ol","pages":[]},{"tab":"ZZ Tools","icon":"wrench","groups":[{"group":"ZZ Tools","pages":[]}]}],"global":{"anchors":[{"anchor":"Discord","icon":"discord","href":"https://discord.gg/STqxY92zuS"},{"anchor":"GitHub","icon":"github","href":"https://github.com/useautumn/autumn"},{"anchor":"Website","icon":"globe","href":"https://useautumn.com"}]}},{"product":"Mintlify Starter Kit 8252","groups":[{"group":"Getting Started","pages":[]},{"group":"Ethelda Hidden","hidden":true,"pages":[]}],"global":{"anchors":[{"anchor":"Documentation","icon":"book-open-cover","href":"https://mintlify.com/docs"},{"anchor":"Blog","icon":"newspaper","href":"https://mintlify.com/blog"}]}}]},"basePath":"","title":"Subscriptions - Autumn","deploymentId":"dpl_JBcG4SqQdQs4stMdkd4mUQhLXtnE","buildId":"dpl_JBcG4SqQdQs4stMdkd4mUQhLXtnE","dynamics":[],"chunks":[]}