> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Plans and Subscriptions
> Sandbox, Starter, Scale, Pro, Enterprise. Top-ups, add-ons, payment method, billing history. Powered by Stripe.
**Plans and Subscriptions** is the cross-system billing surface. Pick a plan, top up credits, add or remove a payment method, see invoices. Stripe handles every payment; Wittify never holds your card data. Open it from the sidebar plan card's **Upgrade Plan** button, the topbar profile dropdown's **Plans and Subscription** entry, or the System submenu.
## Reaching this page
The page renders inside the dashboard shell with the sidebar and topbar in place. A past-due banner can pin above every tab when an invoice is overdue.
The body is a row of four tabs:
| Tab | What it covers |
| --------------------- | ----------------------------------------------------------------------------------- |
| **Overview** | Smart upgrade card, current plan, active add-ons, manage plan, view all plans. |
| **Plans and Add-Ons** | Plans grid, comparison table, add-ons (top-ups, services, features), auto-recharge. |
| **Payment Method** | Saved cards, add card, set default, remove card. |
| **Billing History** | Invoice table with retry payment and CSV export. |
The page refreshes every 30 seconds while it's visible, so payment and subscription updates appear within roughly 30 seconds. Refreshing pauses while the tab is in the background.
## Past-due banner
When an invoice is open or failed, a red strip pins above all four tabs.
| Element | What you see |
| ------------------ | ------------------------------------------------------- |
| Title | *Your account is past due.* |
| Body | *Settle the open invoice to keep your service running.* |
| **Pay now** button | Opens the secure retry-payment page in a new tab. |
Once the invoice is paid the banner disappears on the next refresh.
## Overview tab
### Smart upgrade card
A single card at the top of the tab. Its visual state depends on the highest-pressure usage meter and your current plan.
| State | When | What you see |
| ------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Critical | At least 95% of any quota used | Red strip. Title: **You're about to hit your limit**. Body: *You've used almost all of your quota this period. Top up now or upgrade to avoid service interruption.* Buttons: **Top up credits**, **View All Plans**, **Upgrade plan**. |
| Warning | At least 75% of any quota used | Amber strip. Title: **You're running low**. Body: *You've used most of your quota this period. Top up credits or upgrade your plan to avoid interruptions.* Buttons: **Top up credits**, **View All Plans**, **Upgrade plan**. |
| Sandbox ready | On Sandbox, under 75% used | Brand-gradient strip. Title: **You're on Sandbox**. Body: *You're on the free trial plan. Upgrade to unlock more channels, agents, and AI capacity.* Bullet list: *Deploy to WhatsApp, Instagram, and more*; *Up to 15,000 AI responses per month*; *Phone and SIP calling (Scale and above)*; *Priority support and expert setup.* Buttons: **View All Plans**, **Upgrade plan**. |
| Paid ready | On any paid plan, under 75% used | Quiet card. Title: **Ready for more?** Body: *Unlock more credits, channels, and features by upgrading to the next tier.* Or, on Pro, the Enterprise variant: *Talk to our team about a custom Enterprise plan tailored to your needs.* Buttons: **View All Plans**, **Upgrade plan** or **Contact Sales**. |
### Current Plan card
A card showing your active plan with usage meters.
| Element | What you see |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plan name + color | E.g. **Scale** with the indigo plan color. |
| Renewal line | *Next billing on `{date}`* (or *Cancellation effective `{date}`* when you have cancelled). |
| Usage meters | One meter per quota dimension (AI responses, voice minutes, agents, etc.). Each meter shows current value, cap, and a colored bar. |
| Burn-rate forecast | A small line under the meter when the highest-pressure dimension would exhaust before the period ends. Tones: red for 3 or fewer days, amber for 7 or fewer, neutral otherwise. Suppressed when less than one day has elapsed in the period or you are pacing fine. |
### Active add-ons
Renders only when you have purchased at least one add-on. Each row shows the add-on name, the quantity, and a small disable affordance for feature-flag add-ons.
### Manage plan
A row of buttons.
| Button | Behavior |
| ----------------------- | ----------------------------------------------------------------------------------------------------- |
| **Change Plan** | Routes to the Plans and Add-Ons tab with the plans grid in focus. |
| **Cancel Subscription** | Visible when subscription is active. Opens the cancel confirmation dialog. |
| **Resume Subscription** | Visible when subscription is cancelled but still in its paid period. Resumes the active subscription. |
#### Cancel confirmation
| Element | What it says |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Title | **Cancel your subscription?** |
| Body | *You will keep access to your current plan until `{period end}`, then your account will move to Sandbox. You can resume any time before that.* |
| **Keep subscription** button | Closes the dialog. |
| **Cancel subscription** button | Destructive (red, white text). Posts to Stripe via the backend; a toast confirms once Stripe accepts the change. |
### View All Plans banner
A wide banner at the bottom of the Overview that routes to the Plans and Add-Ons tab.
## Plans and Add-Ons tab
### Currency and period
Above the plans grid:
| Control | What it does |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Country / currency** dropdown | Five options: US Dollar, Saudi Riyal, Qatari Riyal, UAE Dirham, Egyptian Pound. The choice is a display preference; your actual checkout currency is determined by your billing address and applicable tax rules. |
| **Monthly / Yearly** toggle | Flips every plan card between monthly and yearly billing. Yearly is shown with a discount line per plan. |
### Plans grid
Five plan cards.
| Plan | Color | Best for |
| -------------- | -------------- | ---------------------------------------------- |
| **Sandbox** | slate | Free tier for trying Wittify. |
| **Starter** | blue | Your first production agent. |
| **Scale** | indigo | Growing teams with multi-channel. |
| **Pro** | purple | Power users with high volume and integrations. |
| **Enterprise** | brand gradient | Custom contracts and SLAs. |
Each card lists four key features and a CTA. The CTA changes based on your current plan:
| Current plan vs target | CTA |
| ----------------------------- | ----------------------------------------------------------------------- |
| Lower than your current plan | **Downgrade** (outline, opens confirmation). |
| Higher than your current plan | **Upgrade** (brand-gradient, routes through Stripe checkout). |
| Same plan, same period | **Current** (disabled badge). |
| Same plan, different period | **Switch billing** (outline, switches monthly to yearly or vice versa). |
| Enterprise | **Contact Sales** (outline, opens the contact link). |
### Comparison
A collapsible block under the plans grid. Title: **Compare plans**. Click to expand. The body is a feature-by-feature table across all five plans, in seven categories with about 41 rows total. Cells render either a checkmark, an X, a numeric value, or a small "Coming soon" pill.
### Add-Ons
Three sections.
#### Top-ups
Credit packs that add to your balance immediately.
| Element | Notes |
| ------------------ | ------------------------------------------------------------------------------------------- |
| Pack tile | Pack name, included credits, price. |
| Quantity stepper | Plus and minus buttons next to a numeric input. |
| **Buy now** button | Opens Stripe checkout. After payment the credits land in your balance and a toast confirms. |
#### Services
Managed services you can purchase (e.g. agent design, custom integrations). Each tile carries the service name, a short description, and a contact button that opens the contact form.
#### Features
Feature-flag add-ons that enable advanced capabilities (e.g. premium voices, advanced analytics). Each card has an **Active** badge when enabled, and a **Disable** affordance with confirmation.
### Auto-recharge
Toggle: **Enable auto-recharge**. When on, you pick a balance threshold and a pack size; when your balance crosses the threshold, a recharge runs automatically. Disabling it requires a confirmation dialog.
## Payment Method tab
A list of your saved cards. We never see your raw card number — card details are entered on a secure payment page hosted by our payment provider.
### Per-card row
| Element | What you see |
| ------------------------- | --------------------------------------------------------- |
| Card brand and last four | E.g. *Visa ending in 4242*. |
| Expiration | E.g. *Expires 09/2027*. |
| **Default** badge | Shown on the default card. |
| **Set as default** button | Outline-style. Hidden on the current default. |
| **Remove** button | Opens a red confirmation dialog before removing the card. |
### Add card
A button at the top of the list. **+ Add card**. Clicking opens our payment provider's secure card-entry page in a new tab; once you confirm, the new card appears in the list on the next refresh.
### Remove confirmation
| Element | What it says |
| ----------------- | ------------------------------------------------------------------------------------- |
| Title | **Remove this card?** |
| Body | *You will not be able to renew your subscription with this card after it is removed.* |
| **Cancel** button | Closes the dialog. |
| **Remove** button | Red destructive button — removes the card. |
## Billing History tab
A paginated invoice table.
### Columns
| Column | Notes |
| ------- | ------------------------------------------------------------ |
| Date | Invoice issue date. |
| Amount | The total in your invoice currency. |
| Status | **Paid**, **Open**, **Void**, **Uncollectible**, **Failed**. |
| Invoice | A link to the invoice PDF. |
| Action | A **Retry payment** button on **Open** and **Failed** rows. |
### Pagination
A footer bar with **Previous page**, **Next page**, and a *Page X of Y* indicator. The page size is fixed.
### Export CSV
A button at the top of the table. Downloads a CSV of the visible rows in a format that opens cleanly in Excel — Arabic renders correctly and the export is safe against spreadsheet formula tricks.
## Country and currency
The **Country / currency** dropdown is a *display preference only* — it changes how prices are shown on the page. Your actual checkout currency is determined by your billing address and applicable tax rules.
## Common questions
The page re-fetches every 30 seconds while the tab is visible. Wait, or click another tab and back. If your tab was in the background, the poll pauses and resumes when you return. If the change still does not appear after a minute, refresh the tab.
Cancelling stops the next renewal but you keep access through the end of the current paid period. The cancellation dialog shows the date your access ends. **Resume Subscription** appears in the same place during that window so you can undo the cancellation.
The dropdown is a display preference — it converts prices shown on the page to the picked currency. Your actual checkout currency is determined by your billing address and applicable tax rules. If your charge currency differs from the dropdown, your billing address is the cause.
The card-entry page runs in its own tab. After you confirm, return to this tab and wait for the next 30-second refresh, or reopen the Payment Method tab. If the card still does not appear, the setup failed; check your email for a failure notification.
Disable takes effect on the next recharge attempt, not on one already in flight. If a recharge ran moments after you disabled it, that recharge was already underway; subsequent recharges will not fire.
Two reasons: you have no payment method on file (add a card from the Payment Method tab first), or your account has an open invoice (settle it first via the past-due banner).
The first three bytes are a UTF-8 BOM that lets Excel detect the encoding correctly so Arabic strings render. Spreadsheet apps that do not understand the BOM will show those three bytes as a small artifact; open the file in a different reader (Numbers, Google Sheets, a text editor) for a clean view.
Stripe-hosted retry pages can take a moment to render and rely on JavaScript. If you have script-blocking extensions, they can break the redirect. Disable the extension for `checkout.stripe.com` and try again.
The full comparison is large (about 41 rows across seven categories). It collapses on first render so the plans grid is not pushed off-screen. Click the heading to expand.
Enterprise is contract-based and prices vary by usage and SLAs, so the card does not show a price. **Contact Sales** opens the contact form to start that conversation.
## Where to go next
Personal info, security, account deletion.
Billing alert toggles live there.
Audit log of every account action.
Back to the AI Agents dashboard.