How minutes are consumed, when campaigns pause, and what triggers access blocks.
Minute pools and consumption order
When a call is made or a chat interaction occurs, the platform deducts from the client’s minute pools in a fixed order:
The three pools are:
Included minutes
Minutes allocated fresh at the start of each billing period. Shown in the Included minutes section of the subscription card:
“Available: / min”
A progress bar that turns amber when 90% is used.
“Resets each billing period” tooltip note - “These minutes are allocated each period and reset on . Unused minutes do not carry over.”
If the plan has no recurring fee, this section is hidden (usage-only plans have no included pool).
Add-on balance (wallet)
Minutes purchased through add-on packs. Shown as “Add-on minutes (wallet)” with the badge “Never expires”.
Drawn down only after included minutes are exhausted.
Only available if the subscription plan has Add-on packs · On.
Accumulated across multiple pack applications; balance persists across period renewals.
Clients see this as “Add-on balance” on their Usage This Period card.
Excess minutes (billable)
Minutes used beyond both the included allowance and the add-on wallet, when the plan has a per-minute rate configured.
Shown as “Excess minutes (billable)” on the subscription card.
The tooltip reads: “Usage beyond included + add-on. Billed at per minute at period end.”
At period end, the platform creates a Cycle - Usage payment request for the total billable minutes × the per-minute rate.
Clients see this as “Billable usage” on their usage card.
When there is no overage option
If all three pools are exhausted and the plan has neither a per-minute rate nor any add-on balance, the platform treats this as an access restriction:
All of the client’s campaigns are paused automatically.
The pause reason stored internally is: “Included Minutes are exhausted; campaigns were paused to avoid further usage.”
Chat conversion
When Chat Enabled is shown on a plan, chat interactions count against the minute pools using the conversion rate displayed as “1 min = chats”. For example, if the conversion is 5 chats per minute, consuming 50 chats deducts 10 minutes from the active pool.The client’s usage card shows equivalent chat counts wherever minute amounts appear:
”≈ / chats” below the included minutes progress bar.
Included minutes and overage rate descriptions include a blue annotation like ”(≈ chats)” or “(or chats)”.
Access gates and the client portal
The platform checks several conditions before allowing a client user to access their portal or run campaigns:
Condition
Portal state
Client is disabled
Blocked
Client is not on External Billing
Not applicable (different portal flow)
Outstanding unpaid cycle balance
Soft warning banner (portal still open if not overdue)
Subscription is Past Due
Blocked - “Payment overdue - access restricted”
Subscription is Blocked
Blocked - “Subscription suspended”
Plan assigned but no subscription started
Blocked - client sees a Subscribe button and can start the subscription themselves
Subscription Active and pools not exhausted
Open
Past Due and Blocked statuses immediately restrict the client’s portal access regardless of remaining minute balances. Marking the outstanding payment request as Paid is the only way to restore access from a Past Due state.
Billing status summary badges
On the agency’s subscription card, two badges reflect the current billing state at a glance:
” unpaid” (red destructive badge) - appears when there are outstanding payment request amounts across any currency.
“Next due: ” (outline badge) - shows the earliest upcoming due date across all open payment requests.
Campaign pause and resume behavior
When campaigns are paused by the billing system, the pause reason is one of:
Minutes exhausted - included and add-on balance both ran out, no per-minute rate.
Subscription payment overdue - the subscription moved to Past Due.
Grace period expired - the subscription moved to Blocked.
Campaigns are resumed automatically when:
The subscription returns to Active (all cycle requests marked paid), and
At least one minute pool is still available (included minutes remain, wallet has balance, or a per-minute rate is configured).
If campaigns were paused because minutes were exhausted, they do not resume until minutes are replenished (via a new period that resets included minutes, or an add-on pack being applied).
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"VoiceAIWrapper","description":"VoiceAIWrapper Docs","colors":{"primary":"#0B5CFF","light":"#4D8FFF","dark":"#094ACC"},"logo":{"light":"https://mintcdn.com/supafunnel/DKNI5GtlE4iCGz-8/logos/logo-black.png?fit=max\u0026auto=format\u0026n=DKNI5GtlE4iCGz-8\u0026q=85\u0026s=f0b7526597a0673902ae0e4bf3fec499","dark":"https://mintcdn.com/supafunnel/DKNI5GtlE4iCGz-8/logos/logo-white.png?fit=max\u0026auto=format\u0026n=DKNI5GtlE4iCGz-8\u0026q=85\u0026s=eb4ccb9c83526a01d2f6e8326200af7d"},"favicon":"https://mintcdn.com/supafunnel/3wItPkcmr5tq6xUZ/favicon.png?fit=max\u0026auto=format\u0026n=3wItPkcmr5tq6xUZ\u0026q=85\u0026s=3f402e51253e48bc19c79be7dd669a08","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.voiceaiwrapper.app"}},"appearance":{"default":"light"},"background":{"color":{"dark":"#0d0d0d"}},"navbar":{"links":[{"href":"/general/support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.voiceaiwrapper.app"}},"footer":{"socials":{"x":"https://x.com/voiceaiwrapper","linkedin":"https://linkedin.com/company/voiceaiwrapper"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API Reference","icon":"code","href":"/api-reference/authentication"},{"anchor":"Dashboard","icon":"monitor","href":"https://dashboard.voiceaiwrapper.app"},{"anchor":"Support","icon":"headset","href":"/general/support"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"supafunnel","hasAudioNarration":false,"actualSubdomain":"supafunnel","customDomains":["docs.voiceaiwrapper.app"],"gitSource":{"type":"github","owner":"supafunnel-co","repo":"voice-ai-wrapper-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad20bd17414c95fc10f4a9e","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Documentation","count":30},{"language":"default","tag":"API reference","count":29},{"language":"default","tag":"MCP server","count":16},{"language":"default","tag":"External Billing","count":13},{"language":"default","tag":"Leads (v2)","count":7},{"language":"default","tag":"Billing","count":7},{"language":"default","tag":"Tools","count":7},{"language":"default","tag":"Web Widget","count":7},{"language":"default","tag":"Headless Mode (Bring your own UI)","count":7},{"language":"default","tag":"Campaigns","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"documentation/billing/usage-and-access","slug":"/documentation/billing/usage-and-access","pageMetadata":{"title":"Usage and Access","description":"How minutes are consumed, when campaigns pause, and what triggers access blocks.","sidebarTitle":"Usage \u0026 Access","icon":"gauge","href":"/documentation/billing/usage-and-access"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How minutes are consumed, when campaigns pause, and what triggers access blocks.\"\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={em:`em`,hr:`hr`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Table,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`minute-pools-and-consumption-order`,children:`Minute pools and consumption order`}),`\n`,_jsx(_components.p,{children:`When a call is made or a chat interaction occurs, the platform deducts from the client’s minute pools in a fixed order:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=55cd25ec729950ab7ad6cdc20e66ecd1`,alt:`Subscription lifecycle state diagram: Start leads to Active (campaigns run, portal open). Active renews each period, can become Past due if payment is not paid by the due date, or Canceled if the agency cancels. Past due (campaigns paused, portal blocked) can return to Active when marked as paid (dashed arrow), move to Blocked when the grace period expires, or to Canceled if the agency cancels. Blocked (must cancel and restart) can only go to Canceled. Canceled is terminal. Legend: green Active, orange Past due, red Blocked (unrecoverable without canceling), gray Canceled.`,style:{borderRadius:`0.5rem`},\"data-og-width\":`1484`,width:`1484`,\"data-og-height\":`1350`,height:`1350`,\"data-path\":`images/call_billing_flowchart.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?w=280\u0026fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=115f0c21abd6a0829d3086ccf86c1ff1 280w, https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?w=560\u0026fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=20c5b2769b5f9b4397047b1d8feb566a 560w, https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?w=840\u0026fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=22351982920cf263ea99ca8acfeba63d 840w, https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=2a552c9fb0f5db70d9f11d5842e8afb0 1100w, https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=6edd82365d05291e9acb7f71eb816d03 1650w, https://mintcdn.com/supafunnel/QBBQeH9LzHfBOm9W/images/call_billing_flowchart.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QBBQeH9LzHfBOm9W\u0026q=85\u0026s=8653f54bc859404a69b8c32e502a7346 2500w`})}),`\n`,_jsx(_components.p,{children:`The three pools are:`}),`\n`,_jsx(Heading,{level:`3`,id:`included-minutes`,children:`Included minutes`}),`\n`,_jsxs(_components.p,{children:[`Minutes allocated fresh at the start of each billing period. Shown in the `,_jsx(_components.strong,{children:`Included minutes`}),` section of the subscription card:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsxs(_components.strong,{children:[`“Available: `,` / `,` min”`]})}),`\n`,_jsx(_components.li,{children:`A progress bar that turns amber when 90% is used.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`“Resets each billing period”`}),` tooltip note - `,_jsxs(_components.em,{children:[`“These minutes are allocated each period and reset on `,`. Unused minutes do not carry over.”`]})]}),`\n`,_jsx(_components.li,{children:`If the plan has no recurring fee, this section is hidden (usage-only plans have no included pool).`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`add-on-balance-wallet`,children:`Add-on balance (wallet)`}),`\n`,_jsxs(_components.p,{children:[`Minutes purchased through add-on packs. Shown as `,_jsx(_components.strong,{children:`“Add-on minutes (wallet)”`}),` with the badge `,_jsx(_components.strong,{children:`“Never expires”`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Drawn down only after included minutes are exhausted.`}),`\n`,_jsxs(_components.li,{children:[`Only available if the subscription plan has `,_jsx(_components.strong,{children:`Add-on packs · On`}),`.`]}),`\n`,_jsx(_components.li,{children:`Accumulated across multiple pack applications; balance persists across period renewals.`}),`\n`,_jsxs(_components.li,{children:[`Clients see this as `,_jsx(_components.strong,{children:`“Add-on balance”`}),` on their `,_jsx(_components.strong,{children:`Usage This Period`}),` card.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`excess-minutes-billable`,children:`Excess minutes (billable)`}),`\n`,_jsx(_components.p,{children:`Minutes used beyond both the included allowance and the add-on wallet, when the plan has a per-minute rate configured.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Shown as `,_jsx(_components.strong,{children:`“Excess minutes (billable)”`}),` on the subscription card.`]}),`\n`,_jsxs(_components.li,{children:[`The tooltip reads: `,_jsxs(_components.em,{children:[`“Usage beyond included + add-on. Billed at `,` per minute at period end.”`]})]}),`\n`,_jsxs(_components.li,{children:[`At period end, the platform creates a `,_jsx(_components.strong,{children:`Cycle - Usage`}),` payment request for the total billable minutes × the per-minute rate.`]}),`\n`,_jsxs(_components.li,{children:[`Clients see this as `,_jsx(_components.strong,{children:`“Billable usage”`}),` on their usage card.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`when-there-is-no-overage-option`,children:`When there is no overage option`}),`\n`,_jsx(_components.p,{children:`If all three pools are exhausted and the plan has neither a per-minute rate nor any add-on balance, the platform treats this as an access restriction:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`All of the client’s campaigns are `,_jsx(_components.strong,{children:`paused automatically`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The pause reason stored internally is: `,_jsx(_components.em,{children:`“Included Minutes are exhausted; campaigns were paused to avoid further usage.”`})]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`chat-conversion`,children:`Chat conversion`}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.strong,{children:`Chat Enabled`}),` is shown on a plan, chat interactions count against the minute pools using the conversion rate displayed as `,_jsxs(_components.strong,{children:[`“1 min = `,` chats”`]}),`. For example, if the conversion is 5 chats per minute, consuming 50 chats deducts 10 minutes from the active pool.`]}),`\n`,_jsx(_components.p,{children:`The client’s usage card shows equivalent chat counts wherever minute amounts appear:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.em,{children:[`”≈ `,` / `,` chats”`]}),` below the included minutes progress bar.`]}),`\n`,_jsxs(_components.li,{children:[`Included minutes and overage rate descriptions include a blue annotation like `,_jsxs(_components.em,{children:[`”(≈ `,` chats)”`]}),` or `,_jsxs(_components.em,{children:[`“(or `,` chats)”`]}),`.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`access-gates-and-the-client-portal`,children:`Access gates and the client portal`}),`\n`,_jsx(_components.p,{children:`The platform checks several conditions before allowing a client user to access their portal or run campaigns:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Condition`}),_jsx(_components.th,{children:`Portal state`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Client is disabled`}),_jsx(_components.td,{children:`Blocked`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Client is not on External Billing`}),_jsx(_components.td,{children:`Not applicable (different portal flow)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Outstanding unpaid cycle balance`}),_jsx(_components.td,{children:`Soft warning banner (portal still open if not overdue)`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Subscription is `,_jsx(_components.strong,{children:`Past Due`})]}),_jsxs(_components.td,{children:[`Blocked - `,_jsx(_components.em,{children:`“Payment overdue - access restricted”`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Subscription is `,_jsx(_components.strong,{children:`Blocked`})]}),_jsxs(_components.td,{children:[`Blocked - `,_jsx(_components.em,{children:`“Subscription suspended”`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plan assigned but no subscription started`}),_jsxs(_components.td,{children:[`Blocked - client sees a `,_jsx(_components.strong,{children:`Subscribe`}),` button and can start the subscription themselves`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Subscription `,_jsx(_components.strong,{children:`Active`}),` and pools not exhausted`]}),_jsx(_components.td,{children:`Open`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Past Due`}),` and `,_jsx(_components.strong,{children:`Blocked`}),` statuses immediately restrict the client’s portal access regardless of remaining minute balances. Marking the outstanding payment request as `,_jsx(_components.strong,{children:`Paid`}),` is the only way to restore access from a Past Due state.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`billing-status-summary-badges`,children:`Billing status summary badges`}),`\n`,_jsx(_components.p,{children:`On the agency’s subscription card, two badges reflect the current billing state at a glance:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`”`,` unpaid”`]}),` (red destructive badge) - appears when there are outstanding payment request amounts across any currency.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`“Next due: `,`”`]}),` (outline badge) - shows the earliest upcoming due date across all open payment requests.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`campaign-pause-and-resume-behavior`,children:`Campaign pause and resume behavior`}),`\n`,_jsx(_components.p,{children:`When campaigns are paused by the billing system, the pause reason is one of:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Minutes exhausted`}),` - included and add-on balance both ran out, no per-minute rate.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Subscription payment overdue`}),` - the subscription moved to `,_jsx(_components.strong,{children:`Past Due`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Grace period expired`}),` - the subscription moved to `,_jsx(_components.strong,{children:`Blocked`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Campaigns are `,_jsx(_components.strong,{children:`resumed automatically`}),` when:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The subscription returns to `,_jsx(_components.strong,{children:`Active`}),` (all cycle requests marked paid), `,_jsx(_components.strong,{children:`and`})]}),`\n`,_jsx(_components.li,{children:`At least one minute pool is still available (included minutes remain, wallet has balance, or a per-minute rate is configured).`}),`\n`]}),`\n`,_jsx(_components.p,{children:`If campaigns were paused because minutes were exhausted, they do not resume until minutes are replenished (via a new period that resets included minutes, or an add-on pack being applied).`})]})}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":"Usage and Access","description":"How minutes are consumed, when campaigns pause, and what triggers access blocks.","sidebarTitle":"Usage \u0026 Access","icon":"gauge","href":"/documentation/billing/usage-and-access"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Minute pools and consumption order","slug":"minute-pools-and-consumption-order","depth":2,"children":[{"title":"Included minutes","slug":"included-minutes","depth":3,"children":[]},{"title":"Add-on balance (wallet)","slug":"add-on-balance-wallet","depth":3,"children":[]},{"title":"Excess minutes (billable)","slug":"excess-minutes-billable","depth":3,"children":[]}]},{"title":"When there is no overage option","slug":"when-there-is-no-overage-option","depth":2,"children":[]},{"title":"Chat conversion","slug":"chat-conversion","depth":2,"children":[]},{"title":"Access gates and the client portal","slug":"access-gates-and-the-client-portal","depth":2,"children":[]},{"title":"Billing status summary badges","slug":"billing-status-summary-badges","depth":2,"children":[]},{"title":"Campaign pause and resume behavior","slug":"campaign-pause-and-resume-behavior","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"supafunnel","siteName":"VoiceAIWrapper","title":"Usage and Access - VoiceAIWrapper","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-16T12:24:32.697Z","originalFileLocation":"documentation/billing/usage-and-access.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=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How minutes are consumed, when campaigns pause, and what triggers access blocks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"VoiceAIWrapper\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_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/supafunnel/-JJo1zQ6gdVoBi-k/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Usage and Access - VoiceAIWrapper\">\u003cmeta data-mint-head property=\"og:description\" content=\"How minutes are consumed, when campaigns pause, and what triggers access blocks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"VoiceAIWrapper\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://supafunnel.mintlify.site/_mintlify/api/og/v2?division=External+Billing\u0026amp;title=Usage+and+Access\u0026amp;description=How+minutes+are+consumed%2C+when+campaigns+pause%2C+and+what+triggers+access+blocks.\u0026amp;theme=516b39465ba7b446e5e894ee\u0026amp;signature=2bafb8399e873023f3f92516d2db8deb525fdeb08894cc65ace221b08547794b\">\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=\"Usage and Access - VoiceAIWrapper\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How minutes are consumed, when campaigns pause, and what triggers access blocks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supafunnel.mintlify.site/_mintlify/api/og/v2?division=External+Billing\u0026amp;title=Usage+and+Access\u0026amp;description=How+minutes+are+consumed%2C+when+campaigns+pause%2C+and+what+triggers+access+blocks.\u0026amp;theme=516b39465ba7b446e5e894ee\u0026amp;signature=2bafb8399e873023f3f92516d2db8deb525fdeb08894cc65ace221b08547794b\">\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/supafunnel/-JJo1zQ6gdVoBi-k/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"VoiceAIWrapper\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0B5CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/billing/usage-and-access.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.voiceaiwrapper.app/#organization\",\"name\":\"VoiceAIWrapper\",\"url\":\"https://docs.voiceaiwrapper.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/supafunnel/DKNI5GtlE4iCGz-8/logos/logo-black.png?fit=max\u0026auto=format\u0026n=DKNI5GtlE4iCGz-8\u0026q=85\u0026s=f0b7526597a0673902ae0e4bf3fec499\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.voiceaiwrapper.app#website\",\"name\":\"VoiceAIWrapper\",\"url\":\"https://docs.voiceaiwrapper.app\",\"publisher\":{\"@id\":\"https://docs.voiceaiwrapper.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access#webpage\",\"url\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access\",\"name\":\"Usage and Access\",\"description\":\"How minutes are consumed, when campaigns pause, and what triggers access blocks.\",\"dateModified\":\"2026-04-16T12:24:32.697Z\",\"isPartOf\":{\"@id\":\"https://docs.voiceaiwrapper.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Billing\",\"item\":\"https://docs.voiceaiwrapper.app/documentation/billing/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"External Billing\",\"item\":\"https://docs.voiceaiwrapper.app/documentation/billing/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Usage and Access\",\"item\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access#article\",\"headline\":\"Usage and Access\",\"name\":\"Usage and Access\",\"description\":\"How minutes are consumed, when campaigns pause, and what triggers access blocks.\",\"url\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access\",\"mainEntityOfPage\":{\"@id\":\"https://docs.voiceaiwrapper.app/documentation/billing/usage-and-access#webpage\"},\"dateModified\":\"2026-04-16T12:24:32.697Z\",\"publisher\":{\"@id\":\"https://docs.voiceaiwrapper.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.voiceaiwrapper.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"VoiceAIWrapper\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"VoiceAIWrapper\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/documentation/billing/usage-and-access.md","siteName":"VoiceAIWrapper","nav":{"global":{"anchors":[{"anchor":"API Reference","icon":"code","href":"/api-reference/authentication"},{"anchor":"Dashboard","icon":"monitor","href":"https://dashboard.voiceaiwrapper.app"},{"anchor":"Support","icon":"headset","href":"/general/support"}]},"tabs":[{"tab":"API reference","icon":"square-terminal","pages":[{"title":"API reference","href":"/api-reference/authentication"}]},{"tab":"Documentation","icon":"book-open","groups":[{"group":"Web Widget","pages":[{"group":"Headless Mode (Bring your own UI)","pages":[{"title":"Overview","icon":"ghost","href":"/documentation/widget/headless-mode"},{"title":"Quick start","icon":"rocket","href":"/documentation/widget/headless-mode/quickstart"},{"title":"Methods","icon":"square-code","href":"/documentation/widget/headless-mode/methods"},{"title":"Events","icon":"radio","href":"/documentation/widget/headless-mode/events"},{"title":"Consent in Headless Mode","icon":"shield-check","href":"/documentation/widget/headless-mode/consent"},{"title":"Examples","icon":"file-code","href":"/documentation/widget/headless-mode/examples"},{"title":"Troubleshooting \u0026 FAQ","icon":"wrench","href":"/documentation/widget/headless-mode/troubleshooting"}]}]},{"group":"Billing","pages":[{"group":"External Billing","pages":[{"title":"External Billing Overview","sidebarTitle":"Overview","icon":"layout-dashboard","href":"/documentation/billing/overview"},{"title":"Billing Plans","sidebarTitle":"Billing Plans","icon":"credit-card","href":"/documentation/billing/billing-plans"},{"title":"Subscription Lifecycle","sidebarTitle":"Subscription Lifecycle","icon":"refresh-cw","href":"/documentation/billing/subscription-lifecycle"},{"title":"Add-On Packs","sidebarTitle":"Add-On Packs","icon":"package-plus","href":"/documentation/billing/addon-packs"},{"title":"Payment Requests","description":"The full reference for payment request types, kinds, statuses, due dates, grace periods, and what happens when a request is paid.","sidebarTitle":"Payment Requests","icon":"receipt","href":"/documentation/billing/payment-requests"},{"title":"Usage and Access","sidebarTitle":"Usage \u0026 Access","icon":"gauge","href":"/documentation/billing/usage-and-access"},{"title":"Client Portal","description":"What clients see on their Billing page and how to read each section.","sidebarTitle":"Client Portal","icon":"panels-top-left","href":"/documentation/billing/client-portal"}]}]},{"group":"MCP server","pages":[{"title":"MCP server overview","sidebarTitle":"Overview","icon":"plug","href":"/documentation/mcp/overview"},{"title":"Quickstart","icon":"rocket","href":"/documentation/mcp/quickstart"},{"group":"Connect an AI app","icon":"link","pages":[{"title":"Connect ChatGPT","sidebarTitle":"ChatGPT","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supafunnel/images/icons/openai.svg","href":"/documentation/mcp/connect-chatgpt"},{"title":"Connect Claude","sidebarTitle":"Claude","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supafunnel/images/icons/anthropic.svg","href":"/documentation/mcp/connect-claude"}]},{"title":"Sign-in and permissions","sidebarTitle":"Sign-in and permissions","icon":"lock","href":"/documentation/mcp/authentication"},{"title":"Example prompts","icon":"lightbulb","href":"/documentation/mcp/example-prompts"},{"group":"Tools","icon":"blocks","pages":[{"title":"Tools overview","sidebarTitle":"Overview","icon":"layout-grid","href":"/documentation/mcp/tools/overview"},{"title":"Agent tools","sidebarTitle":"Agents","icon":"bot","href":"/documentation/mcp/tools/agents"},{"title":"Agent build tools","sidebarTitle":"Agent builds","icon":"hammer","href":"/documentation/mcp/tools/agent-builds"},{"title":"Web widget tools","sidebarTitle":"Web widgets","icon":"app-window","href":"/documentation/mcp/tools/web-widgets"},{"title":"Phone number tools","sidebarTitle":"Phone numbers","icon":"phone","href":"/documentation/mcp/tools/phone-numbers"},{"title":"Setup and call tools","sidebarTitle":"Setup and calls","icon":"list-check","href":"/documentation/mcp/tools/setup-and-calls"},{"title":"Account tools","sidebarTitle":"Account","icon":"user","href":"/documentation/mcp/tools/account"}]},{"title":"Limits and rules","sidebarTitle":"Limits and rules","icon":"gauge","href":"/documentation/mcp/limits"},{"title":"Errors","icon":"triangle-alert","href":"/documentation/mcp/errors"},{"title":"Troubleshooting","icon":"wrench","href":"/documentation/mcp/troubleshooting"}]}]}]},"basePath":"","title":"Usage and Access - VoiceAIWrapper","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-1H5zLJUq.js","DynamicMarkdown-RhjEuCHC.js","zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js"]}