Exactly how mid-cycle charges are calculated when your customer upgrades
When your customer upgrades mid-cycle, they’re charged the new plan’s full price, credited for the unused days of the old plan’s base price, and their billing cycle restarts on the day of the change.
Credit = Old plan base price × (days remaining / days in cycle)Charge = New plan's full priceThey pay = Charge - CreditThe billing cycle restarts on the day of the change.
The credit covers the old plan’s effective base price only. If an Offer discount was active, Commet credits what the customer actually paid, not the undiscounted list price. Metered usage consumed since the period started is charged on the same invoice.
Your customer is on Starter at $29/mo, paid on January 1.They upgrade to Pro at $99/mo on January 15 (15 days remaining).Charge for Pro (full price): $99.00Credit for unused Starter days: $29 × (15/30) = $14.50They pay today: $84.50New billing cycle: January 15 – February 15Next full invoice: $99 on February 15
Extra seats are not credited on a plan change. Extra seats on the new plan are billed for the full new period in advance.
Current plan: Pro $99/mo, 5 included seats, $25/extra seatYour customer has 8 seats (5 included + 3 extra = $174/mo total)They upgrade to: Business $299/mo, 10 included seats, $20/extra seatOn January 15 (15 days remaining)
Calculation
Charge for new plan base
$299 (full price)
Charge for new extra seats
$0 — their 8 seats are within the 10 included
Credit for old plan base
$99 × (15/30) = $49.50
Credit for extra seats
$0 — extra-seat charges already paid are not credited
They pay today
$249.50
Your customer’s 8 seats are now fully covered by the Business plan’s 10 included seats, so they stop paying for extra seats. If they had more seats than the new plan includes, the excess would be billed for the full new period in advance.
Your customer is on Plan A at $300/quarter (January 1 – April 1).They upgrade to Plan B at $600/quarter on February 15 (45 days remaining).Charge for Plan B (full price): $600.00Credit: $300 × (45/90) = $150.00They pay today: $450.00New billing cycle: February 15 – May 15Next renewal: May 15
Downgrades take effect at renewal. Your customer already paid for the current cycle and keeps their plan until it expires. Since there’s no mid-cycle switch, there’s nothing to prorate and no refund.
When your customer moves from a free plan to a paid plan, there’s no credit to give — the free plan costs $0. They simply pay the full price of the new plan from that day.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Commet","description":"Measure usage and charge customers with Commet","colors":{"primary":"#160d07","light":"#f8f4f1","dark":"#160d07"},"logo":{"light":"https://mintcdn.com/commet/8U6Rlq-CzHfw2UgS/logo/commet-light.svg?fit=max\u0026auto=format\u0026n=8U6Rlq-CzHfw2UgS\u0026q=85\u0026s=dd792ea3e388feb9ae184dd0b56d1e23","dark":"https://mintcdn.com/commet/8U6Rlq-CzHfw2UgS/logo/commet-dark.svg?fit=max\u0026auto=format\u0026n=8U6Rlq-CzHfw2UgS\u0026q=85\u0026s=841f49e903e571a2f08da9c49d35de8f","href":"https://commet.co/home"},"favicon":"https://mintcdn.com/commet/8U6Rlq-CzHfw2UgS/commet-favicon.svg?fit=max\u0026auto=format\u0026n=8U6Rlq-CzHfw2UgS\u0026q=85\u0026s=4101c50babb618282282fdc0e76b32a2","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","typescript","python","go","java","php"],"prefill":true,"autogenerate":true},"mdx":{}},"background":{"color":{"light":"#fffdfc","dark":"#14100d"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://commet.co/login"}},"footer":{"socials":{"github":"https://github.com/commet-labs","discord":"https://commet.co/discord","x":"https://x.com/trycommet"}},"seo":{"paths":[{"path":"api-reference/2026-07-31","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-07-24","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-07-11","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-06-23","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-06-10","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-06-07","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-05-25","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-05-18","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-05-12","metatags":{"robots":"noindex, follow"}},{"path":"api-reference/2026-05-01","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-07-31","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-07-24","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-07-11","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-06-23","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-06-10","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-06-07","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-05-25","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-05-18","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-05-12","metatags":{"robots":"noindex, follow"}},{"path":"webhooks/2026-05-01","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-07-31","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-07-24","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-07-11","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-06-23","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-06-10","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-06-07","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-05-25","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-05-18","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-05-12","metatags":{"robots":"noindex, follow"}},{"path":"es/api-reference/2026-05-01","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-07-31","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-07-24","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-07-11","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-06-23","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-06-10","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-06-07","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-05-25","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-05-18","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-05-12","metatags":{"robots":"noindex, follow"}},{"path":"es/webhooks/2026-05-01","metatags":{"robots":"noindex, follow"}}]},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"errors":{"404":{"redirect":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode","download-spec"],"display":"header"},"thumbnails":{"fonts":{"family":"Geist"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/commet-labs"},{"anchor":"Discord","icon":"discord","href":"https://commet.co/discord"}]},"languages":[{"language":"en","default":true,"href":""},{"language":"es","href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"commet","hasAudioNarration":false,"actualSubdomain":"commet","customDomains":["commet.co"],"gitSource":{"type":"github","owner":"commet-labs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adb8356d403796e7210bcbb","collectionId":"7cfb0fe2-fec2-4a21-934f-5c098d969aae","liveDeploymentHistoryId":"6adb8356d403796e7210bcbb","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adb8356d403796e7210bcbb","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"en","tag":"API Reference","count":1275},{"language":"en","tag":"Endpoints","count":1275},{"language":"es","tag":"API Reference","count":1275},{"language":"es","tag":"Endpoints","count":1275},{"language":"en","tag":"Webhooks","count":697},{"language":"es","tag":"Webhooks","count":697},{"language":"en","tag":"Events","count":630},{"language":"es","tag":"Eventos","count":630},{"language":"en","tag":"Plans","count":184},{"language":"es","tag":"Plans","count":176},{"language":"en","tag":"Subscriptions","count":161},{"language":"es","tag":"Subscriptions","count":152},{"language":"en","tag":"Errors","count":101},{"language":"es","tag":"Errores","count":101},{"language":"en","tag":"Add-ons","count":88},{"language":"en","tag":"Plan Groups","count":88},{"language":"es","tag":"Add-ons","count":88},{"language":"es","tag":"Plan Groups","count":88},{"language":"en","tag":"Documentation","count":72},{"language":"es","tag":"Documentación","count":72}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"decker@commet.co"}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"[class*=rounded]:not(.rounded-full),[role=button],[role=dialog],[role=menu],button,input,select,textarea{border-radius:0!important}#content-area code,.rounded-full:has(.chat-assistant-input){border-radius:0!important}.code-block-background{--rounded-xl:0px}"}],"page":{"pagePath":"how-is-proration-calculated-when-changing-plans","slug":"/how-is-proration-calculated-when-changing-plans","pageMetadata":{"title":"Proration","description":"Exactly how mid-cycle charges are calculated when your customer upgrades","href":"/how-is-proration-calculated-when-changing-plans"},"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: \"Exactly how mid-cycle charges are calculated when your customer upgrades\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When your customer upgrades mid-cycle, they’re charged the new plan’s `,_jsx(_components.strong,{children:`full price`}),`, credited for the unused days of the old plan’s base price, and their billing cycle `,_jsx(_components.strong,{children:`restarts on the day of the change`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-calculation`,children:`The Calculation`}),`\n`,_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Credit = Old plan base price × (days remaining / days in cycle)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Charge = New plan's full price`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`They pay = Charge - Credit`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`The billing cycle restarts on the day of the change.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The credit covers the old plan’s `,_jsx(_components.strong,{children:`effective base price only`}),`. If an Offer discount was active, Commet credits what the customer actually paid, not the undiscounted list price. Metered usage consumed since the period started is charged on the same invoice.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-simple-upgrade`,children:`Example: Simple Upgrade`}),`\n`,_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Your customer is on Starter at $29/mo, paid on January 1.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`They upgrade to Pro at $99/mo on January 15 (15 days remaining).`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Charge for Pro (full price): $99.00`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Credit for unused Starter days: $29 × (15/30) = $14.50`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`They pay today: $84.50`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`New billing cycle: January 15 – February 15`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Next full invoice: $99 on February 15`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-upgrade-with-extra-seats`,children:`Example: Upgrade with Extra Seats`}),`\n`,_jsxs(_components.p,{children:[`Extra seats are `,_jsx(_components.strong,{children:`not credited`}),` on a plan change. Extra seats on the new plan are billed for the full new period in advance.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Current plan: Pro $99/mo, 5 included seats, $25/extra seat`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Your customer has 8 seats (5 included + 3 extra = $174/mo total)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`They upgrade to: Business $299/mo, 10 included seats, $20/extra seat`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`On January 15 (15 days remaining)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Calculation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Charge for new plan base`}),_jsx(_components.td,{children:`$299 (full price)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Charge for new extra seats`}),_jsx(_components.td,{children:`$0 — their 8 seats are within the 10 included`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Credit for old plan base`}),_jsxs(_components.td,{\"data-numeric\":`true`,children:[`$99 × (15/30) = $`,`49.50`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Credit for extra seats`}),_jsx(_components.td,{children:`$0 — extra-seat charges already paid are not credited`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`They pay today`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`$249.50`})})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Your customer’s 8 seats are now fully covered by the Business plan’s 10 included seats, so they stop paying for extra seats. If they had more seats than the new plan includes, the excess would be billed for the full new period in advance.`})}),`\n`,_jsx(Heading,{level:`2`,id:`quarterly-semiannual-and-yearly-plans`,children:`Quarterly, Semiannual, and Yearly Plans`}),`\n`,_jsx(_components.p,{children:`The same calculation applies — the only difference is the cycle length.`}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Your customer is on Plan A at $300/quarter (January 1 – April 1).`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`They upgrade to Plan B at $600/quarter on February 15 (45 days remaining).`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Charge for Plan B (full price): $600.00`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Credit: $300 × (45/90) = $150.00`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`They pay today: $450.00`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`New billing cycle: February 15 – May 15`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Next renewal: May 15`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`why-downgrades-aren’t-prorated`,children:`Why Downgrades Aren’t Prorated`}),`\n`,_jsxs(_components.p,{children:[`Downgrades take effect `,_jsx(_components.strong,{children:`at renewal`}),`. Your customer already paid for the current cycle and keeps their plan until it expires. Since there’s no mid-cycle switch, there’s nothing to prorate and no refund.`]}),`\n`,_jsx(Heading,{level:`2`,id:`why-free-→-paid-isn’t-prorated`,children:`Why Free → Paid Isn’t Prorated`}),`\n`,_jsx(_components.p,{children:`When your customer moves from a free plan to a paid plan, there’s no credit to give — the free plan costs $0. They simply pay the full price of the new plan from that day.`})]})}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":"Proration","description":"Exactly how mid-cycle charges are calculated when your customer upgrades","href":"/how-is-proration-calculated-when-changing-plans"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The Calculation","slug":"the-calculation","depth":2,"children":[]},{"title":"Example: Simple Upgrade","slug":"example-simple-upgrade","depth":2,"children":[]},{"title":"Example: Upgrade with Extra Seats","slug":"example-upgrade-with-extra-seats","depth":2,"children":[]},{"title":"Quarterly, Semiannual, and Yearly Plans","slug":"quarterly-semiannual-and-yearly-plans","depth":2,"children":[{"title":"Example","slug":"example","depth":3,"children":[]}]},{"title":"Why Downgrades Aren’t Prorated","slug":"why-downgrades-aren’t-prorated","depth":2,"children":[]},{"title":"Why Free → Paid Isn’t Prorated","slug":"why-free-→-paid-isn’t-prorated","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"commet","siteName":"Commet","title":"Proration - Commet","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/how-is-proration-calculated-when-changing-plans","matchLevel":0},"es":{"href":"/es/how-is-proration-calculated-when-changing-plans","matchLevel":1}}},"lastModified":"2026-10-15T16:58:37.985Z","originalFileLocation":"how-is-proration-calculated-when-changing-plans.mdx","locale":"en"},"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=\"Exactly how mid-cycle charges are calculated when your customer upgrades\">\u003cmeta data-mint-head name=\"application-name\" content=\"Commet\">\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/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_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/commet/-T6wn8zM3emjmfTG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Proration - Commet\">\u003cmeta data-mint-head property=\"og:description\" content=\"Exactly how mid-cycle charges are calculated when your customer upgrades\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Commet\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://commet.mintlify.app/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Proration\u0026amp;description=Exactly+how+mid-cycle+charges+are+calculated+when+your+customer+upgrades\u0026amp;theme=149574f881092bb933bc8d6c\u0026amp;signature=74f96258437cc4308bd089f3b65f44eecea994368b7cd418d05e82b83a6f6691\">\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=\"Proration - Commet\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Exactly how mid-cycle charges are calculated when your customer upgrades\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://commet.mintlify.app/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Proration\u0026amp;description=Exactly+how+mid-cycle+charges+are+calculated+when+your+customer+upgrades\u0026amp;theme=149574f881092bb933bc8d6c\u0026amp;signature=74f96258437cc4308bd089f3b65f44eecea994368b7cd418d05e82b83a6f6691\">\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/commet/-T6wn8zM3emjmfTG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Commet\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#160d07\">\u003clink data-mint-head rel=\"canonical\" href=\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/how-is-proration-calculated-when-changing-plans.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://commet.co/docs/es/how-is-proration-calculated-when-changing-plans\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://commet.co/#organization\",\"name\":\"Commet\",\"url\":\"https://commet.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/commet/8U6Rlq-CzHfw2UgS/logo/commet-light.svg?fit=max\u0026auto=format\u0026n=8U6Rlq-CzHfw2UgS\u0026q=85\u0026s=dd792ea3e388feb9ae184dd0b56d1e23\"}},{\"@type\":\"WebSite\",\"@id\":\"https://commet.co/docs#website\",\"name\":\"Commet\",\"url\":\"https://commet.co/docs\",\"publisher\":{\"@id\":\"https://commet.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans#webpage\",\"url\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\",\"name\":\"Proration\",\"description\":\"Exactly how mid-cycle charges are calculated when your customer upgrades\",\"dateModified\":\"2026-10-15T16:58:37.985Z\",\"isPartOf\":{\"@id\":\"https://commet.co/docs#website\"},\"breadcrumb\":{\"@id\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Subscriptions\",\"item\":\"https://commet.co/docs/what-happens-when-a-customer-changes-plans\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Proration\",\"item\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans#article\",\"headline\":\"Proration\",\"name\":\"Proration\",\"description\":\"Exactly how mid-cycle charges are calculated when your customer upgrades\",\"url\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans\",\"mainEntityOfPage\":{\"@id\":\"https://commet.co/docs/how-is-proration-calculated-when-changing-plans#webpage\"},\"dateModified\":\"2026-10-15T16:58:37.985Z\",\"publisher\":{\"@id\":\"https://commet.co/#organization\"},\"isPartOf\":{\"@id\":\"https://commet.co/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Commet\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Commet","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/commet-labs"},{"anchor":"Discord","icon":"discord","href":"https://commet.co/discord"}]},"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Knowledge Base","pages":[{"group":"Billing fundamentals","pages":[{"title":"How Billing Works","href":"/how-does-billing-work"},{"title":"Pricing Changes","href":"/what-happens-when-you-change-your-prices"},{"title":"Billing Intervals","href":"/how-do-monthly-quarterly-and-yearly-billing-work"},{"title":"Invoices","href":"/what-invoices-do-customers-receive-and-when"}]},{"group":"Subscriptions","pages":[{"title":"Plan Changes","description":"What happens when your customer upgrades, downgrades, or switches plans","href":"/what-happens-when-a-customer-changes-plans"},{"title":"Proration","href":"/how-is-proration-calculated-when-changing-plans"},{"title":"Trials","description":"A free trial is an Offer phase: checkout saves the payment method without charging it, and the first charge waits until the trial ends.","href":"/how-do-trial-periods-work"},{"title":"Free Plans","href":"/how-do-free-plans-work-without-payment"},{"title":"Payment Failures","href":"/what-happens-when-a-payment-fails"}]},{"group":"Consumption and pricing","pages":[{"title":"Seats","href":"/how-does-seat-based-billing-work"},{"title":"Quota","href":"/how-does-quota-based-billing-work"},{"title":"Discounts","href":"/how-do-discounts-work"},{"title":"Credits, Credit Packs, and Customer Credits","href":"/how-do-credits-credit-packs-and-customer-credits-differ"},{"title":"Balance and Top-Ups","href":"/how-do-balance-and-top-ups-work"},{"title":"Offers, Promo Codes, and Card Promotions","href":"/how-do-offers-promo-codes-and-card-promotions-work-together"}]},{"group":"Payments","pages":[{"title":"Payment Routing","href":"/how-does-payment-routing-work"},{"title":"Refunds and Retries","href":"/what-happens-when-you-refund-or-retry-a-transaction"}]}]},{"tab":"Build with AI","pages":[{"title":"Build with AI","href":"/ai-onboarding"}]},{"tab":"API Reference","versions":[{"version":"2026-08-27","default":true,"tag":"Latest","groups":[{"group":"Endpoints","pages":[{"group":"Add-ons","pages":[{"title":"List active add-ons","deprecated":null,"version":null,"sidebarTitle":"List active addons","openapi":"/openapi/en/rest/2026-08-27.json get /active-addons","href":"/api-reference/add-ons/list-active-addons"},{"title":"Get add-on","deprecated":null,"version":null,"sidebarTitle":"Get addon","openapi":"/openapi/en/rest/2026-08-27.json get /addons/{id}","href":"/api-reference/add-ons/get-addon"},{"title":"Delete add-on","deprecated":null,"version":null,"sidebarTitle":"Delete addon","openapi":"/openapi/en/rest/2026-08-27.json delete /addons/{id}","href":"/api-reference/add-ons/delete-addon"},{"title":"Update add-on","deprecated":null,"version":null,"sidebarTitle":"Update addon","openapi":"/openapi/en/rest/2026-08-27.json patch /addons/{id}","href":"/api-reference/add-ons/update-addon"},{"title":"List add-ons","deprecated":null,"version":null,"sidebarTitle":"List addons","openapi":"/openapi/en/rest/2026-08-27.json get /addons","href":"/api-reference/add-ons/list-addons"},{"title":"Create add-on","deprecated":null,"version":null,"sidebarTitle":"Create addon","openapi":"/openapi/en/rest/2026-08-27.json post /addons","href":"/api-reference/add-ons/create-addon"},{"title":"Deactivate add-on","deprecated":null,"version":null,"sidebarTitle":"Deactivate addon","openapi":"/openapi/en/rest/2026-08-27.json delete /subscriptions/{id}/addons/{addonId}","href":"/api-reference/add-ons/deactivate-addon"},{"title":"Activate add-on","deprecated":null,"version":null,"sidebarTitle":"Activate addon","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/addons","href":"/api-reference/add-ons/activate-addon"}]},{"group":"API Keys","pages":[{"title":"Delete API key","deprecated":null,"version":null,"sidebarTitle":"Delete api key","openapi":"/openapi/en/rest/2026-08-27.json delete /api-keys/{id}","href":"/api-reference/api-keys/delete-api-key"},{"title":"List API keys","deprecated":null,"version":null,"sidebarTitle":"List api keys","openapi":"/openapi/en/rest/2026-08-27.json get /api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create API key","deprecated":null,"version":null,"sidebarTitle":"Create api key","openapi":"/openapi/en/rest/2026-08-27.json post /api-keys","href":"/api-reference/api-keys/create-api-key"}]},{"group":"Provisioning","pages":[{"title":"Create claim link","deprecated":null,"version":null,"sidebarTitle":"Create claim link","openapi":"/openapi/en/rest/2026-08-27.json post /claim-link","href":"/api-reference/provisioning/create-claim-link"}]},{"group":"Credit Packs","pages":[{"title":"Delete credit pack","deprecated":null,"version":null,"sidebarTitle":"Delete credit pack","openapi":"/openapi/en/rest/2026-08-27.json delete /credit-packs/{id}","href":"/api-reference/credit-packs/delete-credit-pack"},{"title":"Update credit pack","deprecated":null,"version":null,"sidebarTitle":"Update credit pack","openapi":"/openapi/en/rest/2026-08-27.json patch /credit-packs/{id}","href":"/api-reference/credit-packs/update-credit-pack"},{"title":"List credit packs","deprecated":null,"version":null,"sidebarTitle":"List credit packs","openapi":"/openapi/en/rest/2026-08-27.json get /credit-packs","href":"/api-reference/credit-packs/list-credit-packs"},{"title":"Create credit pack","deprecated":null,"version":null,"sidebarTitle":"Create credit pack","openapi":"/openapi/en/rest/2026-08-27.json post /credit-packs","href":"/api-reference/credit-packs/create-credit-pack"},{"title":"Purchase credits","deprecated":null,"version":null,"sidebarTitle":"Purchase credits","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/credits","href":"/api-reference/credit-packs/purchase-credits"}]},{"group":"Customers","pages":[{"title":"Revoke remaining customer credit","deprecated":null,"version":null,"sidebarTitle":"Revoke customer credit","openapi":"/openapi/en/rest/2026-08-27.json post /customers/{id}/credits/{creditId}/revoke","href":"/api-reference/customers/revoke-customer-credit"},{"title":"List customer credits","deprecated":null,"version":null,"sidebarTitle":"List customer credits","openapi":"/openapi/en/rest/2026-08-27.json get /customers/{id}/credits","href":"/api-reference/customers/list-customer-credits"},{"title":"Grant customer credit","deprecated":null,"version":null,"sidebarTitle":"Create customer credit","openapi":"/openapi/en/rest/2026-08-27.json post /customers/{id}/credits","href":"/api-reference/customers/create-customer-credit"},{"title":"Revoke temporary plan access","deprecated":null,"version":null,"sidebarTitle":"Revoke plan grant","openapi":"/openapi/en/rest/2026-08-27.json post /customers/{id}/plan-grants/{grantId}/revoke","href":"/api-reference/customers/revoke-plan-grant"},{"title":"Update temporary access expiration","deprecated":null,"version":null,"sidebarTitle":"Update plan grant","openapi":"/openapi/en/rest/2026-08-27.json patch /customers/{id}/plan-grants/{grantId}","href":"/api-reference/customers/update-plan-grant"},{"title":"List plan grants","deprecated":null,"version":null,"sidebarTitle":"List plan grants","openapi":"/openapi/en/rest/2026-08-27.json get /customers/{id}/plan-grants","href":"/api-reference/customers/list-plan-grants"},{"title":"Grant temporary plan access","deprecated":null,"version":null,"sidebarTitle":"Create plan grant","openapi":"/openapi/en/rest/2026-08-27.json post /customers/{id}/plan-grants","href":"/api-reference/customers/create-plan-grant"},{"title":"Get customer","deprecated":null,"version":null,"sidebarTitle":"Get customer","openapi":"/openapi/en/rest/2026-08-27.json get /customers/{id}","href":"/api-reference/customers/get-customer"},{"title":"Update customer","deprecated":null,"version":null,"sidebarTitle":"Update customer","openapi":"/openapi/en/rest/2026-08-27.json patch /customers/{id}","href":"/api-reference/customers/update-customer"},{"title":"Batch create customers","deprecated":null,"version":null,"sidebarTitle":"Batch create customers","openapi":"/openapi/en/rest/2026-08-27.json post /customers/batch","href":"/api-reference/customers/batch-create-customers"},{"title":"List customers","deprecated":null,"version":null,"sidebarTitle":"List customers","openapi":"/openapi/en/rest/2026-08-27.json get /customers","href":"/api-reference/customers/list-customers"},{"title":"Create customer","deprecated":null,"version":null,"sidebarTitle":"Create customer","openapi":"/openapi/en/rest/2026-08-27.json post /customers","href":"/api-reference/customers/create-customer"}]},{"group":"Features","pages":[{"title":"Get feature access","deprecated":null,"version":null,"sidebarTitle":"Get feature access","openapi":"/openapi/en/rest/2026-08-27.json get /feature-access/{code}","href":"/api-reference/features/get-feature-access"},{"title":"List feature access","deprecated":null,"version":null,"sidebarTitle":"List feature access","openapi":"/openapi/en/rest/2026-08-27.json get /feature-access","href":"/api-reference/features/list-feature-access"},{"title":"Get feature","deprecated":null,"version":null,"sidebarTitle":"Get feature","openapi":"/openapi/en/rest/2026-08-27.json get /features/{code}","href":"/api-reference/features/get-feature"},{"title":"Delete feature","deprecated":null,"version":null,"sidebarTitle":"Delete feature","openapi":"/openapi/en/rest/2026-08-27.json delete /features/{code}","href":"/api-reference/features/delete-feature"},{"title":"Update feature","deprecated":null,"version":null,"sidebarTitle":"Update feature","openapi":"/openapi/en/rest/2026-08-27.json patch /features/{code}","href":"/api-reference/features/update-feature"},{"title":"List features","deprecated":null,"version":null,"sidebarTitle":"List features","openapi":"/openapi/en/rest/2026-08-27.json get /features","href":"/api-reference/features/list-features"},{"title":"Create feature","deprecated":null,"version":null,"sidebarTitle":"Create feature","openapi":"/openapi/en/rest/2026-08-27.json post /features","href":"/api-reference/features/create-feature"}]},{"group":"Invoices","pages":[{"title":"Download invoice PDF","deprecated":null,"version":null,"sidebarTitle":"Download invoice","openapi":"/openapi/en/rest/2026-08-27.json post /invoices/{id}/download-links","href":"/api-reference/invoices/download-invoice"},{"title":"Get invoice","deprecated":null,"version":null,"sidebarTitle":"Get invoice","openapi":"/openapi/en/rest/2026-08-27.json get /invoices/{id}","href":"/api-reference/invoices/get-invoice"},{"title":"Send invoice email","deprecated":null,"version":null,"sidebarTitle":"Send invoice","openapi":"/openapi/en/rest/2026-08-27.json post /invoices/{id}/send","href":"/api-reference/invoices/send-invoice"},{"title":"Update invoice status","deprecated":null,"version":null,"sidebarTitle":"Update invoice status","openapi":"/openapi/en/rest/2026-08-27.json patch /invoices/{id}/status","href":"/api-reference/invoices/update-invoice-status"},{"title":"List invoices","deprecated":null,"version":null,"sidebarTitle":"List invoices","openapi":"/openapi/en/rest/2026-08-27.json get /invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Create adjustment invoice","deprecated":null,"version":null,"sidebarTitle":"Create adjustment invoice","openapi":"/openapi/en/rest/2026-08-27.json post /invoices","href":"/api-reference/invoices/create-adjustment-invoice"}]},{"group":"Markets","pages":[{"title":"Get market","deprecated":null,"version":null,"sidebarTitle":"Get market","openapi":"/openapi/en/rest/2026-08-27.json get /markets/{id}","href":"/api-reference/markets/get-market"},{"title":"Delete market","deprecated":null,"version":null,"sidebarTitle":"Delete market","openapi":"/openapi/en/rest/2026-08-27.json delete /markets/{id}","href":"/api-reference/markets/delete-market"},{"title":"Update market","deprecated":null,"version":null,"sidebarTitle":"Update market","openapi":"/openapi/en/rest/2026-08-27.json patch /markets/{id}","href":"/api-reference/markets/update-market"},{"title":"List markets","deprecated":null,"version":null,"sidebarTitle":"List markets","openapi":"/openapi/en/rest/2026-08-27.json get /markets","href":"/api-reference/markets/list-markets"},{"title":"Create market","deprecated":null,"version":null,"sidebarTitle":"Create market","openapi":"/openapi/en/rest/2026-08-27.json post /markets","href":"/api-reference/markets/create-market"}]},{"group":"Offers","pages":[{"title":"Get offer","deprecated":null,"version":null,"sidebarTitle":"Get offer","openapi":"/openapi/en/rest/2026-08-27.json get /offers/{id}","href":"/api-reference/offers/get-offer"},{"title":"Delete offer","deprecated":null,"version":null,"sidebarTitle":"Delete offer","openapi":"/openapi/en/rest/2026-08-27.json delete /offers/{id}","href":"/api-reference/offers/delete-offer"},{"title":"Update offer","deprecated":null,"version":null,"sidebarTitle":"Update offer","openapi":"/openapi/en/rest/2026-08-27.json patch /offers/{id}","href":"/api-reference/offers/update-offer"},{"title":"List offers","deprecated":null,"version":null,"sidebarTitle":"List offers","openapi":"/openapi/en/rest/2026-08-27.json get /offers","href":"/api-reference/offers/list-offers"},{"title":"Create offer","deprecated":null,"version":null,"sidebarTitle":"Create offer","openapi":"/openapi/en/rest/2026-08-27.json post /offers","href":"/api-reference/offers/create-offer"}]},{"group":"Payments","pages":[{"title":"Cancel a payment link","deprecated":null,"version":null,"sidebarTitle":"Cancel payment","openapi":"/openapi/en/rest/2026-08-27.json post /payments/{id}/cancel","href":"/api-reference/payments/cancel-payment"},{"title":"Get payment","deprecated":null,"version":null,"sidebarTitle":"Get payment","openapi":"/openapi/en/rest/2026-08-27.json get /payments/{id}","href":"/api-reference/payments/get-payment"},{"title":"Charge a customer","deprecated":null,"version":null,"sidebarTitle":"Charge payment","openapi":"/openapi/en/rest/2026-08-27.json post /payments/charge","href":"/api-reference/payments/charge-payment"},{"title":"List payments","deprecated":null,"version":null,"sidebarTitle":"List payments","openapi":"/openapi/en/rest/2026-08-27.json get /payments","href":"/api-reference/payments/list-payments"},{"title":"Create a payment link","deprecated":null,"version":null,"sidebarTitle":"Create payment","openapi":"/openapi/en/rest/2026-08-27.json post /payments","href":"/api-reference/payments/create-payment"}]},{"group":"Payouts","pages":[{"title":"Add a payout bank account","deprecated":null,"version":null,"sidebarTitle":"Add payout bank account","openapi":"/openapi/en/rest/2026-08-27.json post /payouts/bank-accounts","href":"/api-reference/payouts/add-payout-bank-account"},{"title":"Request a payout","deprecated":null,"version":null,"sidebarTitle":"Request payout","openapi":"/openapi/en/rest/2026-08-27.json post /payouts","href":"/api-reference/payouts/request-payout"},{"title":"Deprecated payout verification","deprecated":true,"version":null,"sidebarTitle":"Complete payout verification","openapi":"/openapi/en/rest/2026-08-27.json post /payouts/verification","href":"/api-reference/payouts/complete-payout-verification"}]},{"group":"Plan Groups","pages":[{"title":"Remove plan from group","deprecated":null,"version":null,"sidebarTitle":"Remove plan from group","openapi":"/openapi/en/rest/2026-08-27.json delete /plan-groups/{id}/plans/{planId}","href":"/api-reference/plan-groups/remove-plan-from-group"},{"title":"Reorder plans in group","deprecated":null,"version":null,"sidebarTitle":"Reorder plans in group","openapi":"/openapi/en/rest/2026-08-27.json put /plan-groups/{id}/plans/reorder","href":"/api-reference/plan-groups/reorder-plans-in-group"},{"title":"Add plan to group","deprecated":null,"version":null,"sidebarTitle":"Add plan to group","openapi":"/openapi/en/rest/2026-08-27.json post /plan-groups/{id}/plans","href":"/api-reference/plan-groups/add-plan-to-group"},{"title":"Get plan group","deprecated":null,"version":null,"sidebarTitle":"Get plan group","openapi":"/openapi/en/rest/2026-08-27.json get /plan-groups/{id}","href":"/api-reference/plan-groups/get-plan-group"},{"title":"Delete plan group","deprecated":null,"version":null,"sidebarTitle":"Delete plan group","openapi":"/openapi/en/rest/2026-08-27.json delete /plan-groups/{id}","href":"/api-reference/plan-groups/delete-plan-group"},{"title":"Update plan group","deprecated":null,"version":null,"sidebarTitle":"Update plan group","openapi":"/openapi/en/rest/2026-08-27.json patch /plan-groups/{id}","href":"/api-reference/plan-groups/update-plan-group"},{"title":"List plan groups","deprecated":null,"version":null,"sidebarTitle":"List plan groups","openapi":"/openapi/en/rest/2026-08-27.json get /plan-groups","href":"/api-reference/plan-groups/list-plan-groups"},{"title":"Create plan group","deprecated":null,"version":null,"sidebarTitle":"Create plan group","openapi":"/openapi/en/rest/2026-08-27.json post /plan-groups","href":"/api-reference/plan-groups/create-plan-group"}]},{"group":"Plans","pages":[{"title":"Remove feature from plan","deprecated":null,"version":null,"sidebarTitle":"Remove plan feature","openapi":"/openapi/en/rest/2026-08-27.json delete /plans/{id}/features/{featureId}","href":"/api-reference/plans/remove-plan-feature"},{"title":"Update plan feature","deprecated":null,"version":null,"sidebarTitle":"Update plan feature","openapi":"/openapi/en/rest/2026-08-27.json patch /plans/{id}/features/{featureId}","href":"/api-reference/plans/update-plan-feature"},{"title":"Add feature to plan","deprecated":null,"version":null,"sidebarTitle":"Add plan feature","openapi":"/openapi/en/rest/2026-08-27.json post /plans/{id}/features","href":"/api-reference/plans/add-plan-feature"},{"title":"Set default price","deprecated":null,"version":null,"sidebarTitle":"Set default plan price","openapi":"/openapi/en/rest/2026-08-27.json put /plans/{id}/prices/{priceId}/default","href":"/api-reference/plans/set-default-plan-price"},{"title":"Upsert regional prices","deprecated":null,"version":null,"sidebarTitle":"Upsert regional prices","openapi":"/openapi/en/rest/2026-08-27.json put /plans/{id}/prices/{priceId}/regional","href":"/api-reference/plans/upsert-regional-prices"},{"title":"Delete regional prices","deprecated":null,"version":null,"sidebarTitle":"Delete regional prices","openapi":"/openapi/en/rest/2026-08-27.json delete /plans/{id}/prices/{priceId}/regional","href":"/api-reference/plans/delete-regional-prices"},{"title":"Archive plan price","deprecated":null,"version":null,"sidebarTitle":"Delete plan price","openapi":"/openapi/en/rest/2026-08-27.json delete /plans/{id}/prices/{priceId}","href":"/api-reference/plans/delete-plan-price"},{"title":"Update plan price","deprecated":null,"version":null,"sidebarTitle":"Update plan price","openapi":"/openapi/en/rest/2026-08-27.json patch /plans/{id}/prices/{priceId}","href":"/api-reference/plans/update-plan-price"},{"title":"Add price to plan","deprecated":null,"version":null,"sidebarTitle":"Add plan price","openapi":"/openapi/en/rest/2026-08-27.json post /plans/{id}/prices","href":"/api-reference/plans/add-plan-price"},{"title":"Set plan regional pricing","deprecated":null,"version":null,"sidebarTitle":"Set plan regional pricing","openapi":"/openapi/en/rest/2026-08-27.json put /plans/{id}/regional","href":"/api-reference/plans/set-plan-regional-pricing"},{"title":"Get plan","deprecated":null,"version":null,"sidebarTitle":"Get plan","openapi":"/openapi/en/rest/2026-08-27.json get /plans/{id}","href":"/api-reference/plans/get-plan"},{"title":"Delete plan","deprecated":null,"version":null,"sidebarTitle":"Delete plan","openapi":"/openapi/en/rest/2026-08-27.json delete /plans/{id}","href":"/api-reference/plans/delete-plan"},{"title":"Update plan","deprecated":null,"version":null,"sidebarTitle":"Update plan","openapi":"/openapi/en/rest/2026-08-27.json patch /plans/{id}","href":"/api-reference/plans/update-plan"},{"title":"Set plan visibility","deprecated":null,"version":null,"sidebarTitle":"Set plan visibility","openapi":"/openapi/en/rest/2026-08-27.json put /plans/{id}/visibility","href":"/api-reference/plans/set-plan-visibility"},{"title":"List plans","deprecated":null,"version":null,"sidebarTitle":"List plans","openapi":"/openapi/en/rest/2026-08-27.json get /plans","href":"/api-reference/plans/list-plans"},{"title":"Create plan","deprecated":null,"version":null,"sidebarTitle":"Create plan","openapi":"/openapi/en/rest/2026-08-27.json post /plans","href":"/api-reference/plans/create-plan"}]},{"group":"Portal","pages":[{"title":"Request portal access","deprecated":null,"version":null,"sidebarTitle":"Request portal access","openapi":"/openapi/en/rest/2026-08-27.json post /portal/sessions","href":"/api-reference/portal/request-portal-access"}]},{"group":"Promo Codes","pages":[{"title":"Get promo code","deprecated":null,"version":null,"sidebarTitle":"Get promo code","openapi":"/openapi/en/rest/2026-08-27.json get /promo-codes/{id}","href":"/api-reference/promo-codes/get-promo-code"},{"title":"Update promo code","deprecated":null,"version":null,"sidebarTitle":"Update promo code","openapi":"/openapi/en/rest/2026-08-27.json patch /promo-codes/{id}","href":"/api-reference/promo-codes/update-promo-code"},{"title":"List promo codes","deprecated":null,"version":null,"sidebarTitle":"List promo codes","openapi":"/openapi/en/rest/2026-08-27.json get /promo-codes","href":"/api-reference/promo-codes/list-promo-codes"},{"title":"Create promo code","deprecated":null,"version":null,"sidebarTitle":"Create promo code","openapi":"/openapi/en/rest/2026-08-27.json post /promo-codes","href":"/api-reference/promo-codes/create-promo-code"}]},{"group":"Seats","pages":[{"title":"Get seat balance","deprecated":null,"version":null,"sidebarTitle":"Get seat balance","openapi":"/openapi/en/rest/2026-08-27.json get /seats/balance","href":"/api-reference/seats/get-seat-balance"},{"title":"Get all seat balances","deprecated":null,"version":null,"sidebarTitle":"Get all seat balances","openapi":"/openapi/en/rest/2026-08-27.json get /seats/balances","href":"/api-reference/seats/get-all-seat-balances"},{"title":"Bulk set seats","deprecated":null,"version":null,"sidebarTitle":"Bulk set seats","openapi":"/openapi/en/rest/2026-08-27.json put /seats/bulk","href":"/api-reference/seats/bulk-set-seats"},{"title":"Remove seats","deprecated":null,"version":null,"sidebarTitle":"Remove seats","openapi":"/openapi/en/rest/2026-08-27.json post /seats/remove","href":"/api-reference/seats/remove-seats"},{"title":"Set seats","deprecated":null,"version":null,"sidebarTitle":"Set seats","openapi":"/openapi/en/rest/2026-08-27.json put /seats","href":"/api-reference/seats/set-seats"},{"title":"Add seats","deprecated":null,"version":null,"sidebarTitle":"Add seats","openapi":"/openapi/en/rest/2026-08-27.json post /seats","href":"/api-reference/seats/add-seats"}]},{"group":"Subscriptions","pages":[{"title":"Adjust balance","deprecated":null,"version":null,"sidebarTitle":"Adjust balance","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/balance/adjust","href":"/api-reference/subscriptions/adjust-balance"},{"title":"Top up balance","deprecated":null,"version":null,"sidebarTitle":"Topup balance","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/balance/topup","href":"/api-reference/subscriptions/topup-balance"},{"title":"Cancel subscription","deprecated":null,"version":null,"sidebarTitle":"Cancel subscription","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/cancel","href":"/api-reference/subscriptions/cancel-subscription"},{"title":"Change plan","deprecated":null,"version":null,"sidebarTitle":"Change plan","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/change-plan","href":"/api-reference/subscriptions/change-plan"},{"title":"Apply an Offer to a subscription","deprecated":null,"version":null,"sidebarTitle":"Apply subscription offer","openapi":"/openapi/en/rest/2026-08-27.json put /subscriptions/{id}/offer","href":"/api-reference/subscriptions/apply-subscription-offer"},{"title":"Remove an Offer from a pending checkout","deprecated":null,"version":null,"sidebarTitle":"Remove subscription offer","openapi":"/openapi/en/rest/2026-08-27.json delete /subscriptions/{id}/offer","href":"/api-reference/subscriptions/remove-subscription-offer"},{"title":"Pause subscription","deprecated":null,"version":null,"sidebarTitle":"Pause subscription","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/pause","href":"/api-reference/subscriptions/pause-subscription"},{"title":"Revoke scheduled pause","deprecated":null,"version":null,"sidebarTitle":"Revoke subscription pause","openapi":"/openapi/en/rest/2026-08-27.json delete /subscriptions/{id}/pause","href":"/api-reference/subscriptions/revoke-subscription-pause"},{"title":"Update subscription pause","deprecated":null,"version":null,"sidebarTitle":"Update subscription pause","openapi":"/openapi/en/rest/2026-08-27.json patch /subscriptions/{id}/pause","href":"/api-reference/subscriptions/update-subscription-pause"},{"title":"Update payment method","deprecated":null,"version":null,"sidebarTitle":"Update payment method","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/payment-method/update","href":"/api-reference/subscriptions/update-payment-method"},{"title":"Pay billing periods in advance","deprecated":null,"version":null,"sidebarTitle":"Create prepaid periods checkout","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/prepaid-periods","href":"/api-reference/subscriptions/create-prepaid-periods-checkout"},{"title":"Preview plan change","deprecated":null,"version":null,"sidebarTitle":"Preview change plan","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/preview-change","href":"/api-reference/subscriptions/preview-change-plan"},{"title":"Reactivate a past due or canceled subscription","deprecated":null,"version":null,"sidebarTitle":"Reactivate subscription","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/reactivate","href":"/api-reference/subscriptions/reactivate-subscription"},{"title":"Create a recovery payment link for a past due subscription","deprecated":null,"version":null,"sidebarTitle":"Create subscription recovery link","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/recovery-links","href":"/api-reference/subscriptions/create-subscription-recovery-link"},{"title":"Resume subscription","deprecated":null,"version":null,"sidebarTitle":"Resume subscription","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/resume","href":"/api-reference/subscriptions/resume-subscription"},{"title":"Get subscription by ID","deprecated":null,"version":null,"sidebarTitle":"Get subscription","openapi":"/openapi/en/rest/2026-08-27.json get /subscriptions/{id}","href":"/api-reference/subscriptions/get-subscription"},{"title":"Revert scheduled cancellation","deprecated":null,"version":null,"sidebarTitle":"Uncancel subscription","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions/{id}/uncancel","href":"/api-reference/subscriptions/uncancel-subscription"},{"title":"Get active subscription","deprecated":null,"version":null,"sidebarTitle":"Get active subscription","openapi":"/openapi/en/rest/2026-08-27.json get /subscriptions/active","href":"/api-reference/subscriptions/get-active-subscription"},{"title":"List subscriptions","deprecated":null,"version":null,"sidebarTitle":"List subscriptions","openapi":"/openapi/en/rest/2026-08-27.json get /subscriptions","href":"/api-reference/subscriptions/list-subscriptions"},{"title":"Create subscription","deprecated":null,"version":null,"sidebarTitle":"Create subscription","openapi":"/openapi/en/rest/2026-08-27.json post /subscriptions","href":"/api-reference/subscriptions/create-subscription"}]},{"group":"Test Clock","pages":[{"title":"Deprecated manual billing processing","deprecated":true,"version":null,"sidebarTitle":"Process test clock billing","openapi":"/openapi/en/rest/2026-08-27.json post /test-clock/process-billing","href":"/api-reference/test-clock/process-test-clock-billing"},{"title":"Get test clock state","deprecated":null,"version":null,"sidebarTitle":"Get test clock","openapi":"/openapi/en/rest/2026-08-27.json get /test-clock","href":"/api-reference/test-clock/get-test-clock"},{"title":"Advance test clock","deprecated":null,"version":null,"sidebarTitle":"Advance test clock","openapi":"/openapi/en/rest/2026-08-27.json post /test-clock","href":"/api-reference/test-clock/advance-test-clock"}]},{"group":"Transactions","pages":[{"title":"Refund transaction","deprecated":null,"version":null,"sidebarTitle":"Refund transaction","openapi":"/openapi/en/rest/2026-08-27.json post /transactions/{id}/refund","href":"/api-reference/transactions/refund-transaction"},{"title":"Retry transaction","deprecated":null,"version":null,"sidebarTitle":"Retry transaction","openapi":"/openapi/en/rest/2026-08-27.json post /transactions/{id}/retry","href":"/api-reference/transactions/retry-transaction"},{"title":"Get transaction","deprecated":null,"version":null,"sidebarTitle":"Get transaction","openapi":"/openapi/en/rest/2026-08-27.json get /transactions/{id}","href":"/api-reference/transactions/get-transaction"},{"title":"List transactions","deprecated":null,"version":null,"sidebarTitle":"List transactions","openapi":"/openapi/en/rest/2026-08-27.json get /transactions","href":"/api-reference/transactions/list-transactions"}]},{"group":"Usage","pages":[{"title":"Check usage availability","deprecated":null,"version":null,"sidebarTitle":"Check usage availability","openapi":"/openapi/en/rest/2026-08-27.json post /usage/check","href":"/api-reference/usage/check-usage-availability"},{"title":"Track usage event","deprecated":null,"version":null,"sidebarTitle":"Track usage","openapi":"/openapi/en/rest/2026-08-27.json post /usage/events","href":"/api-reference/usage/track-usage"},{"title":"Set current usage","deprecated":null,"version":null,"sidebarTitle":"Set usage","openapi":"/openapi/en/rest/2026-08-27.json put /usage","href":"/api-reference/usage/set-usage"}]},{"group":"Quota","pages":[{"title":"List quota allowances","deprecated":null,"version":null,"sidebarTitle":"Get all quota allowances","openapi":"/openapi/en/rest/2026-08-27.json get /usage/quota/all","href":"/api-reference/quota/get-all-quota-allowances"},{"title":"Remove quota","deprecated":null,"version":null,"sidebarTitle":"Remove quota","openapi":"/openapi/en/rest/2026-08-27.json post /usage/quota/remove","href":"/api-reference/quota/remove-quota"},{"title":"Get quota allowance","deprecated":null,"version":null,"sidebarTitle":"Get quota allowance","openapi":"/openapi/en/rest/2026-08-27.json get /usage/quota","href":"/api-reference/quota/get-quota-allowance"},{"title":"Set quota","deprecated":null,"version":null,"sidebarTitle":"Set quota","openapi":"/openapi/en/rest/2026-08-27.json put /usage/quota","href":"/api-reference/quota/set-quota"},{"title":"Add quota","deprecated":null,"version":null,"sidebarTitle":"Add quota","openapi":"/openapi/en/rest/2026-08-27.json post /usage/quota","href":"/api-reference/quota/add-quota"}]},{"group":"Webhooks","pages":[{"title":"Get webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Get webhook endpoint","openapi":"/openapi/en/rest/2026-08-27.json get /webhooks/{id}","href":"/api-reference/webhooks/get-webhook-endpoint"},{"title":"Delete webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Delete webhook endpoint","openapi":"/openapi/en/rest/2026-08-27.json delete /webhooks/{id}","href":"/api-reference/webhooks/delete-webhook-endpoint"},{"title":"Update webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Update webhook endpoint","openapi":"/openapi/en/rest/2026-08-27.json patch /webhooks/{id}","href":"/api-reference/webhooks/update-webhook-endpoint"},{"title":"Test webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Test webhook endpoint","openapi":"/openapi/en/rest/2026-08-27.json post /webhooks/{id}/test","href":"/api-reference/webhooks/test-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"sidebarTitle":"List webhook endpoints","openapi":"/openapi/en/rest/2026-08-27.json get /webhooks","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create webhook endpoint","deprecated":null,"version":null,"sidebarTitle":"Create webhook endpoint","openapi":"/openapi/en/rest/2026-08-27.json post /webhooks","href":"/api-reference/webhooks/create-webhook-endpoint"}]}]}]},{"version":"2026-07-31","pages":[{"title":"2026-07-31","href":"/api-reference/2026-07-31/add-ons/list-active-addons"}]},{"version":"2026-07-24","pages":[{"title":"2026-07-24","href":"/api-reference/2026-07-24/add-ons/list-active-addons"}]},{"version":"2026-07-11","pages":[{"title":"2026-07-11","href":"/api-reference/2026-07-11/add-ons/list-active-addons"}]},{"version":"2026-06-23","pages":[{"title":"2026-06-23","href":"/api-reference/2026-06-23/add-ons/list-active-addons"}]},{"version":"2026-06-10","pages":[{"title":"2026-06-10","href":"/api-reference/2026-06-10/add-ons/list-active-addons"}]},{"version":"2026-06-07","pages":[{"title":"2026-06-07","href":"/api-reference/2026-06-07/add-ons/get-addon"}]},{"version":"2026-05-25","pages":[{"title":"2026-05-25","href":"/api-reference/2026-05-25/add-ons/get-addon"}]},{"version":"2026-05-18","pages":[{"title":"2026-05-18","href":"/api-reference/2026-05-18/add-ons/get-addon"}]},{"version":"2026-05-12","pages":[{"title":"2026-05-12","href":"/api-reference/2026-05-12/add-ons/get-addon"}]},{"version":"2026-05-01","pages":[{"title":"2026-05-01","href":"/api-reference/2026-05-01/add-ons/get-addon"}]}]},{"tab":"Webhooks","versions":[{"version":"2026-08-27","default":true,"tag":"Latest","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/webhooks/introduction"}]},{"group":"Events","pages":[{"title":"subscription.created","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.created","href":"/webhooks/subscription-created"},{"title":"subscription.activated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.activated","href":"/webhooks/subscription-activated"},{"title":"subscription.reactivated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.reactivated","href":"/webhooks/subscription-reactivated"},{"title":"subscription.pause_scheduled","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.pause_scheduled","href":"/webhooks/subscription-pause-scheduled"},{"title":"subscription.pause_updated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.pause_updated","href":"/webhooks/subscription-pause-updated"},{"title":"subscription.pause_revoked","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.pause_revoked","href":"/webhooks/subscription-pause-revoked"},{"title":"subscription.paused","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.paused","href":"/webhooks/subscription-paused"},{"title":"subscription.resumed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.resumed","href":"/webhooks/subscription-resumed"},{"title":"subscription.resume_failed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.resume_failed","href":"/webhooks/subscription-resume-failed"},{"title":"subscription.canceled","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.canceled","href":"/webhooks/subscription-canceled"},{"title":"subscription.updated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.updated","href":"/webhooks/subscription-updated"},{"title":"subscription.plan_changed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.plan_changed","href":"/webhooks/subscription-plan-changed"},{"title":"subscription.cancellation_scheduled","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.cancellation_scheduled","href":"/webhooks/subscription-cancellation-scheduled"},{"title":"subscription.cancellation_revoked","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.cancellation_revoked","href":"/webhooks/subscription-cancellation-revoked"},{"title":"subscription.plan_change_scheduled","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.plan_change_scheduled","href":"/webhooks/subscription-plan-change-scheduled"},{"title":"subscription.plan_change_revoked","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.plan_change_revoked","href":"/webhooks/subscription-plan-change-revoked"},{"title":"subscription.past_due","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook subscription.past_due","href":"/webhooks/subscription-past-due"},{"title":"trial.started","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook trial.started","href":"/webhooks/trial-started"},{"title":"trial.converted","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook trial.converted","href":"/webhooks/trial-converted"},{"title":"trial.expired","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook trial.expired","href":"/webhooks/trial-expired"},{"title":"trial.will_end","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook trial.will_end","href":"/webhooks/trial-will-end"},{"title":"trial.checkout_ready","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook trial.checkout_ready","href":"/webhooks/trial-checkout-ready"},{"title":"checkout.ready","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook checkout.ready","href":"/webhooks/checkout-ready"},{"title":"payment.received","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.received","href":"/webhooks/payment-received"},{"title":"payment.failed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.failed","href":"/webhooks/payment-failed"},{"title":"payment.recovered","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.recovered","href":"/webhooks/payment-recovered"},{"title":"payment.retry_failed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.retry_failed","href":"/webhooks/payment-retry-failed"},{"title":"payment.refunded","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.refunded","href":"/webhooks/payment-refunded"},{"title":"payment.disputed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.disputed","href":"/webhooks/payment-disputed"},{"title":"payment.dispute_resolved","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment.dispute_resolved","href":"/webhooks/payment-dispute-resolved"},{"title":"payment_link.created","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment_link.created","href":"/webhooks/payment-link-created"},{"title":"payment_link.completed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment_link.completed","href":"/webhooks/payment-link-completed"},{"title":"payment_link.failed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment_link.failed","href":"/webhooks/payment-link-failed"},{"title":"payment_link.canceled","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment_link.canceled","href":"/webhooks/payment-link-canceled"},{"title":"invoice.created","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook invoice.created","href":"/webhooks/invoice-created"},{"title":"invoice.voided","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook invoice.voided","href":"/webhooks/invoice-voided"},{"title":"invoice.overdue","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook invoice.overdue","href":"/webhooks/invoice-overdue"},{"title":"invoice.upcoming","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook invoice.upcoming","href":"/webhooks/invoice-upcoming"},{"title":"payment_method.attached","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment_method.attached","href":"/webhooks/payment-method-attached"},{"title":"payment_method.updated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payment_method.updated","href":"/webhooks/payment-method-updated"},{"title":"customer.created","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook customer.created","href":"/webhooks/customer-created"},{"title":"customer.updated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook customer.updated","href":"/webhooks/customer-updated"},{"title":"customer.state_changed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook customer.state_changed","href":"/webhooks/customer-state-changed"},{"title":"plan_grant.created","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook plan_grant.created","href":"/webhooks/plan-grant-created"},{"title":"plan_grant.updated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook plan_grant.updated","href":"/webhooks/plan-grant-updated"},{"title":"plan_grant.expired","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook plan_grant.expired","href":"/webhooks/plan-grant-expired"},{"title":"plan_grant.revoked","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook plan_grant.revoked","href":"/webhooks/plan-grant-revoked"},{"title":"credits.granted","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook credits.granted","href":"/webhooks/credits-granted"},{"title":"credits.purchased","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook credits.purchased","href":"/webhooks/credits-purchased"},{"title":"credits.low","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook credits.low","href":"/webhooks/credits-low"},{"title":"credits.depleted","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook credits.depleted","href":"/webhooks/credits-depleted"},{"title":"credits.expired","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook credits.expired","href":"/webhooks/credits-expired"},{"title":"balance.topped_up","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook balance.topped_up","href":"/webhooks/balance-topped-up"},{"title":"balance.low","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook balance.low","href":"/webhooks/balance-low"},{"title":"balance.depleted","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook balance.depleted","href":"/webhooks/balance-depleted"},{"title":"quota.threshold_reached","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook quota.threshold_reached","href":"/webhooks/quota-threshold-reached"},{"title":"quota.exceeded","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook quota.exceeded","href":"/webhooks/quota-exceeded"},{"title":"seats.updated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook seats.updated","href":"/webhooks/seats-updated"},{"title":"seats.limit_reached","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook seats.limit_reached","href":"/webhooks/seats-limit-reached"},{"title":"addon.activated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook addon.activated","href":"/webhooks/addon-activated"},{"title":"addon.deactivated","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook addon.deactivated","href":"/webhooks/addon-deactivated"},{"title":"usage.recorded","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook usage.recorded","href":"/webhooks/usage-recorded"},{"title":"payout.available","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payout.available","href":"/webhooks/payout-available"},{"title":"payout.created","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payout.created","href":"/webhooks/payout-created"},{"title":"payout.paid","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payout.paid","href":"/webhooks/payout-paid"},{"title":"payout.failed","version":null,"deprecated":null,"playground":"none","openapi":"/openapi/en/webhooks/2026-08-27.json webhook payout.failed","href":"/webhooks/payout-failed"}]}]},{"version":"2026-07-31","pages":[{"title":"2026-07-31","href":"/webhooks/2026-07-31/subscription-created"}]},{"version":"2026-07-24","pages":[{"title":"2026-07-24","href":"/webhooks/2026-07-24/subscription-created"}]},{"version":"2026-07-11","pages":[{"title":"2026-07-11","href":"/webhooks/2026-07-11/subscription-created"}]},{"version":"2026-06-23","pages":[{"title":"2026-06-23","href":"/webhooks/2026-06-23/subscription-created"}]},{"version":"2026-06-10","pages":[{"title":"2026-06-10","href":"/webhooks/2026-06-10/subscription-created"}]},{"version":"2026-06-07","pages":[{"title":"2026-06-07","href":"/webhooks/2026-06-07/subscription-created"}]},{"version":"2026-05-25","pages":[{"title":"2026-05-25","href":"/webhooks/2026-05-25/subscription-created"}]},{"version":"2026-05-18","pages":[{"title":"2026-05-18","href":"/webhooks/2026-05-18/subscription-created"}]},{"version":"2026-05-12","pages":[{"title":"2026-05-12","href":"/webhooks/2026-05-12/subscription-created"}]},{"version":"2026-05-01","pages":[{"title":"2026-05-01","href":"/webhooks/2026-05-01/subscription-created"}]}]},{"tab":"Errors","hidden":true,"searchable":true,"pages":[{"title":"Errors","href":"/api-reference/errors/idempotency_in_progress"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/how-is-proration-calculated-when-changing-plans"}]}]},"title":"Proration - Commet","buildId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","deploymentId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","dynamics":[],"chunks":[]}