Subscription lifecycle on Nadles begins with creating an order.When a customer clicks Subscribe on the checkout page, Nadles creates an order which expires in 24 hours if not paid.Before taking the customer to the payment page, Nadles collects billing address to make sure invoices are issued correctly.After a successful payment, the customer is returned to the subscription dashboard where all details about pricing, current usage and included API endpoints are displayed:
On the subscription page, the customer can
Manage API access keys.
Update payment method.
View the full transaction history.
Switch the subscription to a different product, if that is allowed by the configuration.
Subscriptions are not canceled immediately. When the user clicks Cancel subscription, the cancellation is scheduled for the nearest billing date.
This helps avoid unnecessary refunds.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nadles Documentation","colors":{"primary":"#644376","light":"#07C983","dark":"#644376"},"logo":{"light":"https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/logo/logo_noemboss.svg?fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=29af88d82079298990ef9dd87bc911e6","dark":"https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/logo/logo_noemboss.svg?fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=29af88d82079298990ef9dd87bc911e6"},"favicon":"https://mintcdn.com/nadles/WGoKyNQHhztkDHRn/favicon.ico?fit=max\u0026auto=format\u0026n=WGoKyNQHhztkDHRn\u0026q=85\u0026s=882f72bc7c6f7bb7943ba3c25a65df8b","navbar":{"links":[{"href":"mailto:support@nadles.com","label":"Support"}],"primary":{"type":"button","label":"Sign in","href":"https://app.nadles.com"}},"footer":{"socials":{"x":"https://x.com/nadlescom","linkedin":"https://linkedin.com/company/nadles","medium":"https://nadles.medium.com/"}},"banner":{"content":"🚀 Nadles can now natively monetize your AI and LLM tokens. Learn how in our new documentation: [How to set up AI billing](/products/ai-and-llm-billing).","dismissible":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Go to website","icon":"browsers","color":{"light":"#644376","dark":"#644376"},"href":"https://www.nadles.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nadles","hasAudioNarration":false,"actualSubdomain":"nadles","customDomains":["docs.nadles.com"],"gitSource":{"type":"github","owner":"olschaefer","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a2a84898ac106f3a95f6394","collectionId":"633e99d5-c21e-4807-9270-b6c682a9cd04","schemaVersion":"v3"},"entitlements":{},"buildId":"6a2a84898ac106f3a95f6394:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":36},{"language":"default","tag":"API","count":8},{"language":"default","tag":"User portal","count":8},{"language":"default","tag":"Products","count":7},{"language":"default","tag":"Provider API","count":6},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Overview","count":3},{"language":"default","tag":"Subscriptions","count":3},{"language":"default","tag":"Payment integration","count":2},{"language":"default","tag":"Prices","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"subscriptions/overview","slug":"/subscriptions/overview","pageMetadata":{"title":"Overview","icon":"repeat","iconType":"sharp-solid","description":null,"href":"/subscriptions/overview"},"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={li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Subscription lifecycle on Nadles begins with creating an order.`}),`\n`,_jsxs(_components.p,{children:[`When a customer clicks `,_jsx(_components.strong,{children:`Subscribe`}),` on the checkout page, Nadles creates an order which expires in 24 hours if not paid.`]}),`\n`,_jsx(_components.p,{children:`Before taking the customer to the payment page, Nadles collects billing address to make sure invoices are issued correctly.`}),`\n`,_jsx(_components.p,{children:`After a successful payment, the customer is returned to the subscription dashboard where all details about pricing, current usage and included API endpoints are displayed:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=58b7dd676e5ca63a8209b0a665840683`,alt:``,\"data-og-width\":`2866`,width:`2866`,\"data-og-height\":`1928`,height:`1928`,\"data-path\":`images/subscriptions/subscription-dashboard.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?w=280\u0026fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=1a09f7a894ac11cf861ccf4fc5771d8a 280w, https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?w=560\u0026fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=e70f46babff23157c6860419c569d801 560w, https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?w=840\u0026fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=8f77c644b9e1bfb7b301bb646637b6f5 840w, https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?w=1100\u0026fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=1b055f5307b9fe6fbc23705ffbf23de3 1100w, https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?w=1650\u0026fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=736c1050b1a23ecba06aae916d250f45 1650w, https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/images/subscriptions/subscription-dashboard.png?w=2500\u0026fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=beab234336990936d8f19546ac9d06f4 2500w`})}),`\n`,_jsx(_components.p,{children:`On the subscription page, the customer can`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Manage API access keys.`}),`\n`,_jsx(_components.li,{children:`Update payment method.`}),`\n`,_jsx(_components.li,{children:`View the full transaction history.`}),`\n`,_jsx(_components.li,{children:`Switch the subscription to a different product, if that is allowed by the configuration.`}),`\n`,_jsx(_components.li,{children:`Top up prepaid items, if allowed.`}),`\n`,_jsx(_components.li,{children:`Cancel subscription.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`cancellation`,children:`Cancellation`}),`\n`,_jsxs(_components.p,{children:[`Subscriptions are not canceled immediately. When the user clicks `,_jsx(_components.strong,{children:`Cancel subscription`}),`, the cancellation is scheduled for the nearest billing date.\nThis helps avoid unnecessary refunds.`]})]})}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":"Overview","icon":"repeat","iconType":"sharp-solid","description":null,"href":"/subscriptions/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Cancellation","slug":"cancellation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"nadles","siteName":"Nadles Documentation","title":"Overview - Nadles Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-11T09:49:13.100Z","originalFileLocation":"subscriptions/overview.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=\"Nadles Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_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/nadles/AcUNUgqDQddSgAdd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Overview - Nadles Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nadles Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nadles.com/subscriptions/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nadles.mintlify.app/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Overview\u0026amp;theme=3f6f57e9f816bb43084b1ca4\u0026amp;signature=79ed57148963f5b1fcd194cd52e67bbe0b5ccdd5984a68fc32fd078c956468fb\">\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=\"Overview - Nadles Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nadles.mintlify.app/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Overview\u0026amp;theme=3f6f57e9f816bb43084b1ca4\u0026amp;signature=79ed57148963f5b1fcd194cd52e67bbe0b5ccdd5984a68fc32fd078c956468fb\">\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/nadles/AcUNUgqDQddSgAdd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nadles Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#644376\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nadles.com/subscriptions/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/subscriptions/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nadles.com/#organization\",\"name\":\"Nadles Documentation\",\"url\":\"https://docs.nadles.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nadles/0Nb4bFxOTiT2NICu/logo/logo_noemboss.svg?fit=max\u0026auto=format\u0026n=0Nb4bFxOTiT2NICu\u0026q=85\u0026s=29af88d82079298990ef9dd87bc911e6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nadles.com#website\",\"name\":\"Nadles Documentation\",\"url\":\"https://docs.nadles.com\",\"publisher\":{\"@id\":\"https://docs.nadles.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nadles.com/subscriptions/overview#webpage\",\"url\":\"https://docs.nadles.com/subscriptions/overview\",\"name\":\"Overview\",\"dateModified\":\"2026-06-11T09:49:13.100Z\",\"isPartOf\":{\"@id\":\"https://docs.nadles.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nadles.com/subscriptions/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nadles.com/subscriptions/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Nadles Documentation\",\"item\":\"https://docs.nadles.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Overview\",\"item\":\"https://docs.nadles.com/subscriptions/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.nadles.com/subscriptions/overview#article\",\"headline\":\"Overview\",\"name\":\"Overview\",\"url\":\"https://docs.nadles.com/subscriptions/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nadles.com/subscriptions/overview#webpage\"},\"dateModified\":\"2026-06-11T09:49:13.100Z\",\"publisher\":{\"@id\":\"https://docs.nadles.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nadles.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nadles Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Nadles Documentation","nav":{"global":{"anchors":[{"anchor":"Go to website","icon":"browsers","color":{"light":"#644376","dark":"#644376"},"href":"https://www.nadles.com/"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Overview","pages":[{"title":"Introduction","mode":"wide","icon":"house","href":"/introduction"},{"title":"Components","icon":"cubes","href":"/components"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"}]},{"group":"AI and LLM billing","pages":[{"title":"Billing for AI tokens usage","icon":"microchip-ai","iconType":"light","href":"/products/ai-and-llm-billing"}]},{"group":"API","pages":[{"title":"Add API","icon":"circle-plus","href":"/api-management/add-api"},{"title":"API settings","icon":"gear","href":"/api-management/settings"},{"title":"Custom domain","icon":"globe-pointer","href":"/api-management/custom-domain"},{"title":"User authentication","icon":"road-barrier","href":"/api-management/user-authentication"},{"title":"Securing your backend","icon":"key","href":"/api-management/securing-your-backend"},{"title":"Request and response transformations","icon":"arrow-down-up-across-line","href":"/api-management/transformations"},{"title":"API key management","icon":"key-skeleton-left-right","href":"/api-management/api-key-management"},{"title":"Additional information","icon":"info","href":"/api-management/nadles-api-gateway"}]},{"group":"Products","pages":[{"title":"Overview","icon":"cart-shopping","href":"/products/overview"},{"title":"Create product","icon":"square-plus","href":"/products/create"},{"title":"Billable metrics","icon":"gauge","href":"/products/billable-metrics"},{"title":"Rate limits","icon":"stopwatch-20","href":"/products/rate-limits"},{"title":"Rejection rules","icon":"ban","href":"/products/rejection-rules"},{"title":"Request / response transformations","icon":"arrow-down-up-across-line","href":"/products/transformations"},{"title":"Modifying products","icon":"pen-to-square","href":"/products/modifying-products"}]},{"group":"Prices","pages":[{"title":"Overview","icon":"dollar-sign","href":"/pricing/overview"},{"title":"Create prices","icon":"octagon-plus","href":"/pricing/create-price"}]},{"group":"Payment integration","pages":[{"title":"Stripe","icon":"stripe","href":"/payment-integration/stripe"},{"title":"Paddle","icon":"star-christmas","iconType":"duotone","href":"/payment-integration/paddle"}]},{"group":"User portal","pages":[{"title":"Getting started","icon":"id-badge","iconType":"solid","href":"/user-portal/getting-started"},{"title":"Styling","icon":"paintbrush","href":"/user-portal/style-user-portal"},{"title":"Custom domain","icon":"globe-pointer","href":"/user-portal/custom-domain"},{"title":"Checkout links","icon":"link","href":"/user-portal/checkout-links"},{"title":"Pricing page","icon":"money-check-dollar","href":"/user-portal/pricing-page"},{"title":"HTML and JavaScript","icon":"code","iconType":"solid","href":"/user-portal/html-and-javascript"},{"title":"Adding pages","icon":"file-plus","iconType":"solid","href":"/user-portal/adding-pages"},{"title":"API","icon":"webhook","iconType":"solid","description":null,"href":"/user-portal/api"}]},{"group":"Subscriptions","pages":[{"title":"Overview","icon":"repeat","iconType":"sharp-solid","href":"/subscriptions/overview"},{"title":"Upgrades and downgrades","icon":"arrow-up-big-small","iconType":"solid","description":null,"href":"/subscriptions/upgrades-and-downgrades"},{"title":"One-time charges","icon":"money-bill-1","href":"/subscriptions/one-time-charges"}]},{"group":"Analytics","pages":[{"title":"Query syntax","icon":"chart-mixed","href":"/analytics/query-syntax"}]},{"group":"Other","pages":[{"title":"F.A.Q.","icon":"messages-question","href":"/other/faq"}]}]},{"anchor":"Provider API","icon":"cloud","pages":[{"title":"Provider API","href":"/api/provider/list-customer-subscriptions"}]}]},"title":"Overview - Nadles Documentation","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["10e4515597","07c022d89b","a74be98ba7"],"chunks":["BannerMarkdown-BVNUlwBc.js","dist-aeztFa9U.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-rL8ZCCw4.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","Frame-COGkNuA6.js","DynamicMarkdown-85clUA0i.js","zoom-image-lightbox-BZxD9MAj.js","lightbox-handle-r17bVUz3.js"]}