Skip to main content
Settings → Billing opens with a banner saying where your plan stands, then your usage against its limits, the four plans side by side, and your invoices.

The trial

Every new organization starts on a 14-day trial of Growth, with no card. The banner says how many days are left, with Choose a Plan. Choosing a plan during the trial ends it: you’re charged straight away, and the plan starts that day.

Choosing or changing plan

Toggle between Monthly and Yearly to see both prices. Yearly is 10% off and is shown per month, with the yearly total underneath.
  • With no paid subscription — on the trial, or after one ended — choosing a plan opens a Stripe checkout. You’re returned to Surnex when it completes, and the plan is applied within a few seconds.
  • With a paid subscription, the plan is changed in place, with no checkout. The change takes effect straight away and is prorated on your next invoice. Switching between monthly and yearly works the same way.
Choosing a plan also undoes a pending cancellation.

Who can change it

Admins and owners can choose a plan or open the billing portal, and only from the dashboard — an API key can’t. Members can see the current plan and usage — they need that to know whether they can run an audit — but can’t change what you pay. See Roles and permissions.

Billing portal

Once something has been bought, a Billing Portal button appears at the top right of the page. It opens Stripe’s portal, where you can:
  • Update the card on file
  • Download invoices
  • Cancel the subscription
This is where cancellation happens — there’s no cancel button inside Surnex. Deleting the organization also cancels its subscription, immediately.

The plan banner

The banner at the top of Settings → Billing changes with your plan’s state. Amber needs your attention soon; red means billing has stopped, or will. Only admins and owners see the buttons. Keep My Plan keeps the billing period you already pay, monthly or yearly.

Upgrading

Takes effect immediately. New limits apply at once, so a blocked Add Keywords button unblocks as soon as you’re back.

Downgrading

Check your current usage first. A move to a plan the organization already holds more of than it allows — say 300 tracked keywords onto Starter’s 200 — is refused, listing what’s over. Remove the extra first, then change plan. Only held allowances block a downgrade: tracked keywords, AI prompts and local locations. What you’ve already spent this month isn’t undone; the smaller monthly allowance applies to what’s left of the month.
Removing keywords, prompts or locations is permanent for their history. Export or report anything you need before downgrading.

When a trial or subscription ends

The organization keeps reading everything already collected, but nothing billable runs — no scheduled checks, no new projects, no lookups, no audits. Choose a plan to start collecting again. A run skipped while there was no plan isn’t made up afterwards. A subscription whose renewal payment failed keeps its access while Stripe retries the payment. Update the card in the billing portal to keep the plan.

Per organization

Subscriptions belong to an organization. If you own two, you pay for two — and upgrading one changes nothing about the other. Switch organizations in the sidebar switcher before checking billing so you’re looking at the right one.

Through the API

A checkout to a plan the organization holds more than answers CONFLICT (409) with the overages in details. Checkout and portal need the admin or owner role and refuse API keys. success_url, cancel_url and return_url must be addresses on the Surnex app, app.surnex.io. Anything else answers BAD_REQUEST (400), “Return addresses must be on the Surnex app.”, so a billing page can never send someone on to a site that isn’t Surnex.