Open in AthenaHQ
app.athenahq.ai/settings/billingPurpose
The Billing page is the single place where Athena customers manage everything related to paying for the product: which plan they’re on, how many AI-search tracking credits they have left, when their next invoice is due, and where to download past invoices. It sits inside Settings and is the destination for every upgrade, downgrade, credit top-up, and payment-method change in the app. The page adapts to who is looking at it. Organization-level admins and owners see an organization-wide view that lets them see plan status, switch between Credits, Invoices, and Websites sub-tabs, distribute credits across the websites and groups they own, and review billing history for the whole org. Users who only have access to a single website (external members, partner-shared users) see a website-scoped view focused on that website’s plan, credit balance, subscription controls, and its own invoice history. Billing is also the landing point for customers in trouble: anyone whose subscription has lapsed, whose renewal payment failed, or who needs to convert a free trial will be sent here. It is the only place inside the app where users can open the Stripe customer portal, change plans, or buy add-on credits.What’s on the page
Page header
A breadcrumb in the form Settings › Billing with an info icon. Hovering the info icon reveals the helper text “Manage your subscription, credits, and invoices.”Loading state
While membership data is still being resolved, the entire content area shows a centered animated spinner. Individual cards inside the page may also show skeleton placeholders while their data loads.Tabs bar (organization view)
Three tabs that swap the content beneath the summary card:- Credits: credit distribution and usage charts.
- Invoices: paid invoice history.
- Websites: list of every website in the org with its plan and credit details.
Credits tab
Opens onto a Credit Distribution panel showing how the org’s credit pool is split across its websites and groups, followed by a Credit Usage Events panel containing:- A note that all timestamps are shown in UTC, and the active date range (start–end).
- An Export button and a range selector dropdown.
- A bar chart titled Credits Used by Date (UTC).
- Two collapsible accordion sections beneath the chart for the usage tables (see Tables below).
Invoices tab (organization view)
Shows invoices grouped into collapsible monthly rows. Each closed month row displays the month label, an invoice count badge, and the total amount across all invoices in that month (broken down per currency if mixed). Clicking a month row expands an inline invoice table. If the org has no paid invoices yet, a card shows the empty-state text “No invoices yet.”Websites tab
Lists every website in the org as a virtualised, scrollable table. Above the list is a count summary (“12 websites · 8 active subscriptions”) and a search box on the right. The list itself shows one row per website with a logo, name, URL, plan badge, status badge, and a kebab menu. Clicking a row expands an inline detail panel showing Current Plan, Credits, and Next Invoice details. If the org has no websites and the user is an admin, an empty-state card shows an Add Website button.Current plan card (website view)
A wide left-hand card on the website-scoped billing view:- Header text “This website is currently on the plan:”.
- The plan name (e.g. Growth, Starter, Enterprise) in large text.
- Up to three badges: a status badge (Active / Downgrading / Canceling / Past Due / Special / Trialing), an interval badge (Monthly / Yearly), and any other relevant state.
- The current billing cycle date range, e.g. “10/1/2025 – 10/31/2025”.
- If the subscription is set to not renew, a yellow note: “Your subscription will not be renewed when the billing cycle ends.”
Credits section (website view)
Below the plan info on the same card:- A small badge next to “Credits” that reads either Organization (with tooltip: “Organization-wide credits shared across all websites”) or Website (with tooltip: “Website-specific credits, not shared with other websites”).
- A progress bar with two labels underneath: “N used” on the left and “N left” on the right. The bar turns orange when usage exceeds 66%.
- A Usage insights block containing Daily average, Projected this period, and Days remaining. If projected usage exceeds the monthly allotment, an orange “Pace exceeds limit” indicator appears.
- A helper line “Track more prompts and rank higher in AI search” and an Add Credits (or Manage Credits) button.
Billing History section (website view)
Under the cards above:- Heading “Billing History” with subtext “Your past invoices and payment history.” plus an underlined “View all invoices” link.
- A month picker on the right that defaults to the most recent month with invoices.
- A table of invoices for the selected month.
Pricing Plans modal
A full-screen dialog opened by View plans or Plans & add-ons. Header reads either “Grow Your AI Visibility” or “Plans & add-ons” if already on Enterprise (in which case a blue banner above the cards offers a Chat with us CTA). Contains:- A Monthly / Annual (17% off) toggle.
- Two side-by-side plan cards: Self-Serve and Enterprise, with prices, feature lists, “See all features” link, and a primary CTA per card.
- The Enterprise card hides the Self-Serve card entirely when the user is already on Enterprise.
- Cards highlighted as the user’s current plan show a disabled “Current plan” button.
Tables
Billing History table (website view)
Lists paid invoices for the website filtered by the selected month.- Date: date the invoice was created (formatted in UTC).
- Amount: invoice total in dollars.
- Plan: the plan(s) the invoice covers (e.g. Growth, Starter, Starter (Yearly), Growth (Yearly), Enterprise, Credits (Monthly), Credits (One-time)).
- Status: payment status badge: Paid (neutral), Pending (warning), or other.
- Invoice: an external-link icon button that opens the hosted Stripe invoice page in a new tab.
Org Invoices table (inside collapsible month row)
Shown when a month row is expanded in the organization Invoices tab.- Date: date the invoice was created.
- Amount: invoice total formatted in the invoice’s currency.
- Status: payment status badge.
- Invoice: external-link icon to the hosted Stripe invoice page.
Credit usage by time bucket table
Collapsible accordion under the credit usage chart.- Period start (UTC): the start of each hour or day bucket in UTC.
- Credits used: number of credits consumed in that bucket. The trigger label also shows the total period count and aggregate credits used.
Credit usage by website table
Collapsible accordion under the credit usage chart.- Website: website name and URL.
- Credits used: total credits the website consumed during the selected range. The trigger label also shows the website count and aggregate credits used.
Websites tab table
A virtualised list of every website in the org.- Website: logo (or a fallback initial), website name, and URL.
- Plan badge: the website’s current plan tier.
- Status badge: the website’s subscription status.
- ⋯ menu: kebab menu with Edit Website and Delete Website options.
- Current Plan: the plan name.
- Credits: a usage bar showing used vs. remaining credits. If the credits are shared org-wide the badge reads Organization; if split per website it reads Website with the tooltip “Website-specific credits allocated from the organization pool”. Unlimited credit plans show an Unlimited badge instead of a bar.
- Next Invoice: date of the next billing charge, plus the credits reset date if applicable.
Charts
Credits Used by Date (UTC)
A bar chart inside the Credits tab.- X-axis: date label (hour if the range is 24h, day otherwise).
- Y-axis: credits consumed.
- Tooltip: exact credit count per bucket. The range is controlled by the range selector dropdown (Last 24 hours / 7 days / 30 days / 90 days). If no usage exists in the range, an empty state message replaces the chart.
Filters
- Month selector (Billing History – website view): picks which month’s invoices appear in the table.
- Range selector (Credit Usage Events): controls the chart and the two accordion tables. Options: Last 24 hours, Last 7 days, Last 30 days, Last 90 days.
- Tabs (org view). Credits / Invoices / Websites switch the entire sub-section displayed.
- Search (Websites tab): filters the website list by name or URL.
- Monthly / Annual toggle (Pricing Plans modal): controls the displayed prices on plan cards.
- Monthly / One-time toggle (Credits dialog): controls whether the purchase will recur monthly or be a single charge.
What you can do here
Plan management
- View plans / Plans & add-ons: opens the Pricing Plans modal to compare Self-Serve and Enterprise.
- Get started (Self-Serve card): initiates Stripe Checkout for the Starter/Self-Serve plan.
- Switch to annual / Switch to monthly: initiates Stripe Checkout to change billing interval if the user is already on Self-Serve.
- Get in touch (Enterprise card): opens AthenaHQ’s sales calendar in a new tab.
- See all features: opens athenahq.ai/pricing in a new tab.
- Chat with us (Enterprise banner): opens the AthenaHQ sales calendar in a new tab.
- Renew Plan: re-activates a canceled subscription via a confirmation dialog with a Confirm button.
- Cancel downgrade: reverses a scheduled plan downgrade via a confirmation dialog. The dialog has Keep Downgrade and Confirm buttons.
Credits
- Add Credits / Manage Credits: opens the credits dialog.
- Inside the dialog: switch between Monthly and One-time, use the + / − stepper (capped at 50 packages), and press the primary button (label changes contextually) to buy or remove credits.
- Buy [N] Credits: redirects to Stripe Checkout for a one-time purchase.
- Add [N] Credits/month: redirects to Stripe Checkout for a recurring monthly add-on.
- Remove [N] Credits/month: reduces the recurring add-on; takes effect at end of billing cycle, no refund for the current period.
- Cancel Add-on: cancels the recurring credit add-on at end of cycle; scheduled cancellation is shown as a “Cancelling” status until then.
- Cancel: closes the dialog without making changes.
Invoices
- Invoice external-link icon (every invoice row): opens the hosted Stripe invoice page in a new tab.
- View all invoices link (website view): navigates to /settings/billing?section=invoices.
- Month picker (website view): changes which month’s invoices are shown.
- Click month row (org view): expands to show the invoices in that month.
Credit usage tab
- Export button: downloads a CSV of credit usage. The export contains the per-time-bucket breakdown and the per-website breakdown for the selected range. Disabled if no non-zero usage exists in the range.
- Range selector. Last 24 hours, Last 7 days, Last 30 days, Last 90 days.
- Usage by time bucket accordion: expand to see credit totals per hour or day.
- Usage by website accordion: expand to see credit totals per website.
Websites tab
- Search field: filters the list by name or URL.
- Click a row: expands the inline detail panel.
- ⋯ kebab menu on each row contains:
- Edit Website: opens a dialog to rename the website.
- Delete Website: opens a confirmation dialog that requires typing the exact website URL to confirm. The website is soft-deleted after confirmation. Disabled with a tooltip if: the website is the org’s only website, the website still has an active website-level subscription, or entity data is still loading.
- Add Website (empty state only): navigates to /add-website.
Data shown
All timestamps on the credit usage chart and the time-bucket table are displayed in UTC, including the range header at the top of the Credit Usage section.Common workflows
View and download an invoice
- Go to Settings › Billing.
- Org members: open the Invoices tab. Website-only members: scroll to Billing History.
- Pick the month from the dropdown (website view) or expand a month row (org view).
- Click the external-link icon on the desired invoice row to open the Stripe invoice in a new tab.
Purchase additional one-time credits
- Go to Settings › Billing.
- Click Add Credits (or Manage Credits).
- Select the One-time tab.
- Use the +/− stepper to pick the number of packages.
- Review the total cost.
- Click Buy [N] Credits; you’ll be redirected to Stripe Checkout.
- After completing payment, you’ll return to /settings/billing with a success toast and the new balance.
Add or adjust monthly recurring credits
- Go to Settings › Billing.
- Click Add Credits or Manage Credits.
- Keep the Monthly tab selected.
- Use the +/− stepper. The dialog will show a prorated “Amount due today” and the new monthly recurring cost.
- Click Add [N] Credits/month to be redirected to Stripe Checkout, or Remove [N] Credits/month / Cancel Add-on to reduce or cancel.
- Confirm payment on Stripe if applicable.
Renew a canceled subscription
- Go to Settings › Billing.
- If you see a “Canceling” badge, click Renew Plan (or Cancel downgrade if a downgrade is scheduled).
- Click Confirm in the dialog.
Update payment method
- Go to Settings › Billing.
- Click Billing portal.
- Manage payment methods, addresses, and subscription details in the Stripe portal that opens.
Empty, loading, and error states
- Initial load: a centered animated spinner displays while membership and entity data load.
- Per-card loading: skeleton placeholders show inside the plan card, credits section, summary card, and invoice tables while their data resolves.
- No paid invoices: the Billing History section is hidden entirely. The org Invoices tab shows a card with “No invoices yet.”
- No credit usage in the range: the chart area shows “No credit usage found for this range.” The two accordion tables show similar empty states.
- Credit usage fetch error: an error message with the failure reason is shown inside the Credits tab.
Linked from / links to
Linked from:- Settings sidebar item Billing.
- Settings breadcrumb navigation.
- Subscription-gate and paywall dialogs throughout the app (e.g. View Plans, Go to billing).
- Ask Athena locked-state “View Plans” button.
- Mobile Ask Athena sheet locked-state “View Plans” button.