---
title: "Business, team and account"
description: "Your business's details, members, payouts, billing and documents, and your own profile, API tokens and connections."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sherpo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Business, team and account

Two settings areas cover what sits above a single store. **Business settings** holds what the whole business shares: its details, its members, its API tokens, its payouts and its Sherpo plan. **Account settings** holds what is yours alone: your profile, your API tokens and your connections.

## Business settings

Open it from the business switcher in the top bar: its menu lists **Business settings**, **Members**, **API tokens**, **Payouts**, **Billing** and **Documents**. The area's sidebar groups them as **Business** (**General**, **Members**, **API tokens**) and **Money** (**Payouts**, **Billing**, **Documents**). Every page needs the **View** permission on **Business**, except **Members**, which every member can open, and **API tokens**, which needs the **View** permission on **API tokens**.

### General

**General** shows the business's details, plan and payments. A member without the **Edit** permission on **Business** sees the page read-only.

- **Details**: how your business appears to your members and to us.
  - **Name**: shown in the business switcher. Up to 120 characters. Spaces at either end are dropped, and a name that shows nothing is refused.
  - **Short name**: the business's handle. 3 to 63 characters: lowercase letters, digits and hyphens, starting and ending with a letter or digit.
  - **Email**: where we send billing and account notices.
  - **Description**: a few words about the business, for your team. Up to 2,000 characters.
- **Logo**: shown beside the business's name in the business switcher. PNG, JPEG, WebP or GIF, up to 10 MB. It replaces the logo at once, without **Save**. **Remove logo** shows the business's initials instead.
- **Plan**: the business's Sherpo plan, its status (**Active**, **Payment overdue** or **Canceled**) and when it renews or ends, with **Change plan** (or **Choose a plan** when there is none). See [Billing](#billing).
- **Payments**: the account your customers' payments go to. **Payment account** shows Stripe's status: **Connected**, **Setup not finished**, **Needs details**, **Paused**, **Can't reach** or **Not connected**. See [Payouts](#payouts).
- **Business**: the **Business ID** (with a copy button), which the API uses to find the business, and **Delete business**.

### Members

**Members** lists everyone who works on the business's stores and what they may do: **Member**, **Email**, **Access** and **Joined**. Members work on every store in the business. The header shows how many seats are used, for example "3 of 200 members used".

_Screenshot: A business's Members: each member with their email, access and when they joined._

#### Adding a member

1. Press **Add member**. It needs the **Edit** permission on **Team**.
2. Enter their **Email**. Someone without an account gets an email to set one up.
3. Under **Access**, choose **Full access** or **Choose permissions**. Full access includes managing members and the business.
4. Press **Add member**. They join right away.

A business can add one address at most 3 times a day, you at most 5 times a day across your businesses, and everyone together 10 times a day. The invite email names you by your email address.

#### Permissions

**Choose permissions** lists each area with the verbs you can grant: **View**, **Edit**, **Delete**, for reviews **Moderate** and, for **Event check-in**, **Check in**, which lets a member scan tickets at an event's door (see [Check-in](/merchant-app/products#check-in)). On its own, it opens only the store's **Check-in** page. The areas are grouped as:

| Group | Areas |
| --- | --- |
| **Catalog** | **Products**, **Prices**, **Discounts**, **Subscriptions**, **Portfolios** |
| **Content** | **Entries** (lessons, posts and episodes), **Files**, **Quizzes**, **Certificates**, **Reviews** |
| **Customers** | **Customers**, **Orders**, **Revenue**, **Affiliates**, **Event check-in** |
| **Website** | **Site**, **Pages** |
| **Store** | **Automations**, **Integrations**, **API clients**, **API tokens**, **Team**, **Business**, **Your profile** |

You can give only what you may do yourself in this business. In the list, **Access** sums each member up, for example **Full access** or "All but 2 permissions". What a member can't view is hidden from them across the app (see [Permissions](/merchant-app#permissions)).

Some things need **Full access**: billing and the plan, setting up payouts, downloading documents, and deleting the business or a store.

#### Changing and removing members

Each member's row has a menu:

- **Edit access** changes their permissions with **Save access**. Narrowing your own access asks you to confirm, since only someone who keeps access to members can give it back. Taking access away also turns off the webhook endpoints, integrations and redirects that need it and that the member's tokens and connected apps set up.
- **Make owner** (shown to the owner) hands the business over. The new owner gets full access; you keep full access as a member, so you can narrow your own access or leave afterwards. Someone who already owns another business can't own this one too.
- **Remove member** takes away their access to every store in the business right away, and their API tokens and connected apps stop working here. It needs the **Delete** permission on **Team**.
- **Leave business**, on your own row, does the same for you. A member with full access can add you back.

The owner can't be narrowed or removed and stays a member; hand the business over first. The only member with full access can't be narrowed either: someone has to keep full access.

#### App connections

Below the members, **App connections** lists the apps the members connected to the business, each acting as the member who connected it, with the member, the stores it reaches here, when it was connected and when it was last used. **Remove** stops one in this business right away and turns off the webhook endpoints, integrations and redirects it set up here; access it granted, affiliates it made or changed and automations it created stay until ended or paused, and the member can connect it again while their seat allows. It needs the **Edit** permission on **Team**. Only the owner can remove the owner's connections, and you can remove only those of members whose access is within yours.

#### How many members a plan seats

| Plan | Members |
| --- | --- |
| Lite | 1 |
| Pro | 200 |
| Sherpo One | 200 |

> **Team members need Pro or Sherpo One**
>
> Lite seats a single member, the owner, so **Add member** stays disabled with "The plan seats 1 member. Change the plan in Billing, or remove a member first." See [Plans](/merchant-app/plans).

A member who can't see the members (no **View** permission on **Business**) sees "You can't see the members", and can still leave the business.

### API tokens

**API tokens** lists the business's tokens: each belongs to the business, not to whoever made it, so integrations keep working when people leave. See [business tokens](/merchant-api/authentication#business-tokens). The list shows each token's **Name**, **Access**, **Reaches** (**All stores** or the stores it was given), **Limits**, its calls on the store you are in, **Created by** (with who last edited it), **Status** and **Last used**. Making, changing or revoking one needs the **Edit** permission on **API tokens**.

1. Press **New token**.
2. Enter a **Name**: what uses it, so you know what breaks if you revoke it.
3. For a business with more than one store, pick what it **Reaches**: **All stores**, including stores added later, or **Only some stores**, then tick them. Any other store refuses it.
4. Pick when it **Expires**.
5. Under **Access**, choose **Everything I can do**, which gives it what you hold now except managing tokens, or choose permissions. A token never gets more than you hold, and never manages tokens.
6. Optionally set **Limits**, then press **Create token** and copy it. You won't be able to see it again.

Edit a token's limits from its row. If it can do more than you, saving narrows it to what you hold, and the dialog says so first. Revoking stops it at once and turns off the webhook endpoints, integrations and redirects it set up.

A token's row also opens what it made or changed in the store you're in: the access it granted, the affiliates it made or changed and the automations it created, with **End**, **Restore** and **Pause**. Below them, the dialog links the other stores it reaches, to see what it made there. A business with more than 20 stores shows the first ones, and **Show more stores** looks through the rest.

### Payouts

**Payouts** shows money from your sales on its way to your bank, and what is still settling. Payments run through Stripe: until the business has a Stripe account set up, you can only sell free content.

#### Setting up payouts

A business with no Stripe account shows **Payouts aren't set up**.

1. Pick the **Country** the business is based in. It can't be changed later.
2. Press **Set up Stripe**. Stripe's onboarding opens.
3. Give Stripe the details it asks for, then follow its link back to the app.

Only a member with full access can set up Stripe or open it later. When you come back from Stripe, the page reads your account's status again. If the link to Stripe expired or was already used, the app makes a fresh one and sends you straight back to Stripe.

When Stripe still needs something, **Finish setup on Stripe** takes you back; once it is set up, **Update payout details** opens Stripe to change them. Notices from Stripe, such as details it still needs, show across the app's pages until you deal with them.

#### The payouts page

The figures at the top show what is **Available**, **Pending**, **In transit** and the **Next payout**, in each currency. The list shows each payout's **Arrival date**, **Amount**, **Status** (**Paid**, **Pending**, **In transit**, **Failed** or **Canceled**), **Method** (**Standard** or **Instant**), **Destination**, **Descriptor** and, for a failed one, the **Failure reason**. Filter it by status and **Currency**.

Amounts are hidden from members without the **View** permission on **Revenue**.

If payments are paused for the business, customers can't pay and subscriptions can't renew; the page tells you to contact us to turn them back on.

### Billing

**Billing** shows your Sherpo plan, its add-ons and how you pay for it. Only a member with full access can change it.

- **Your plan**: the plan and its billing period, its status, **Stores in use** (for example "2 of 3") and the **Next charge**, or when it ends. Under them, what it bills line by line: the stores at the plan's price, each add-on, and a total for each period, as add-ons bill monthly beside a yearly plan.
- **Minimum plan**: a plan Sherpo granted your business for good, billed nothing, when it has one. You can only buy a plan above it: plans at or below it stay listed to compare, but can't be chosen, and when it's already above every plan for sale, **Billing** points you to Sherpo One. If you cancel a plan you bought, your business goes back to its minimum plan once the period ends.
- **Switch plan** moves the plan to another tier or billing period, after showing what it costs and when it takes effect: right away, charged now and prorated, when it neither lowers the tier nor shortens the period, and from the end of the period otherwise. A switch waiting for the end of the period shows with when it lands, and you can keep your current plan until then. A switch to Lite only goes through while the business is within Lite's limits. See [Changing plan](/merchant-app/plans#changing-plan) and [Moving from Pro to Lite](/merchant-app/plans#moving-from-pro-to-lite).
- **Payment and invoices**: **Manage on Stripe** opens Stripe's billing portal, where you update your card, see your invoices and cancel the plan.
- **Remove a store** lowers the stores the plan pays for by one, from the end of the period. Until then it's still billed, and nothing is refunded. You can **Cancel removal** until then. The plan never pays for fewer stores than are in use, and always pays for at least one. Deleting a store doesn't do this for you: the plan keeps paying for the same number of stores until you remove one here.
- **Upgrade automatically when I go over a limit** (Lite): when a store goes over Lite's customers or storage limit, or the business over its members limit, the plan moves to Pro on the day new purchases and unlocks would pause (7 days over, or sooner when time is already counted), unless you get back under, and only when Pro has room for everything the business holds. See [What each plan allows](/merchant-app/plans#upgrading-automatically-from-lite). Pro's price is prorated and charged to your card on file. If the charge is refused, new purchases and unlocks pause at once. It never applies while the plan is canceled, in its free trial, has a failed payment, or has a change waiting for the next period, such as a store removal.
- **Add-ons** (Pro): every store's blocks of storage and AI media minutes and what each costs a month, with a link to the store's **Plan & usage**, where a member with full access changes them. A deleted store's blocks keep billing until lowered, and are lowered here. See [Add-ons](/merchant-app/plans#add-ons).
- **End the trial** (Pro, in its free trial): a member with full access pays now, for example to add blocks, after a confirmation with the exact amount. See [Ending the trial early](/merchant-app/plans#ending-the-trial-early).
- On Pro, the page tells you whether the business is within Lite's limits, so you can switch back to Lite under **Switch plan** from the end of the period, or which limits it is over. It doesn't with a minimum plan, which canceling goes back to instead. When a scheduled switch to Lite is called off because the business is over one of them, the page says so, and your plan stays as it is.
- When a payment didn't go through or waits for your bank, **Pay or confirm** pays it. If it stays unpaid for 7 days, new purchases and unlocks in your stores pause. See [What each plan allows](/merchant-app/plans#payments-and-plans-that-end).
- A business with no plan shows **Choose a plan**, billed per store. Change or cancel it any time.

For what each plan includes, see [Plans](/merchant-app/plans). To add a store, see [Add more stores](/merchant-app/getting-started#add-more-stores).

### Documents

**Documents** shows invoices and tax forms from our payment provider, Stripe, ready to download. Stripe shows them only to a member with full access. A business with no Stripe account has none yet; set one up from **Payouts**.

### Deleting a business

**Delete business**, at the bottom of **General**, deletes the business with all its stores. Only a member with full access can do it.

1. Press **Delete business** and read what it deletes.
2. Confirm. We email a code to your address.
3. Enter the code. You can ask for a new code a minute after the last one.

> **What deleting does**
>
> Every store of the business and its address stops working right away. Contact us within 30 days to restore it. After that, everything is gone for good, including your customers' access to what they bought.

The delete waits while the plan still renews (cancel it in **Billing** first), while a plan checkout is still settling, or until a canceled plan ends on its date. To delete a business that has no store yet, see [Deleting a business that has no store](/merchant-app/getting-started#deleting-a-business-that-has-no-store).

## Account

Open **Account settings**, **Passkeys**, **API tokens** or **Connections** from the account menu at the top right. The area's sidebar has **Profile**, **Passkeys**, **API tokens** and **Connections**.

_Screenshot: Your Profile: your name, picture and the email you sign in with._

### Profile

**Profile** sets how the members of your businesses see you.

- **Name**: up to 120 characters. Leave it empty to be shown by your email address.
- **Picture**: PNG, JPEG, WebP or GIF, up to 10 MB. It replaces your picture at once, without **Save**. **Remove picture** shows your initials instead.
- **Email**: where your sign-in codes and account notices go.

To change your email, press **Change email**, enter the **New email**, wait for the security check to pass, and press **Send codes**. We send one code to the new address and one to your current one; enter both within 5 minutes and press **Change email**. You can ask for codes 5 times an hour and 10 times a day, 3 of them to one new address, and one address gets codes for at most 5 changes a day, whoever asks. An ask that a code you already got answers doesn't count. One whose email to the new address fails doesn't count toward that address's limits, and doesn't count at all when neither email goes out.

> **Caution**
>
> Changing your email signs you out everywhere else, removes your passkeys and revokes all your API tokens and connections.

### Passkeys

A passkey lets you sign in with your fingerprint, face or screen lock instead of an email code. Your device or password manager keeps it; Sherpo never sees your fingerprint or face. The email code keeps working whether or not you add one.

_Screenshot: Passkeys: each passkey with its name, whether it syncs, when it was added and last used._

To add one, press **Add a passkey**, give it a **Name** you'll recognize (like the device or password manager that keeps it), press **Continue** and follow your browser's prompt. If you signed in more than 10 minutes ago, we first email you a code to confirm it's you. You can hold up to 20 passkeys.

Each passkey shows whether it's **Synced** across your devices or kept on **This device only**, when it was added and when it was last used. From its menu, **Rename** changes its name and **Remove** deletes it: you can't sign in with it anymore, and the sessions it opened on other devices are signed out. Removing it here doesn't delete it from your device; your password manager may still offer it until you delete it there too.

**Sign out everywhere** signs out your sessions but keeps your passkeys.

### API tokens

An API token lets scripts and tools work as you, through the [merchant API](/merchant-api), in the businesses and stores you pick. Only you see your tokens, and the page needs no permission.

Each row shows the token's name and **Status** (**Active**, **Expired** or **Revoked**), when it was created and last used, when it expires (or **Until revoked**), and each business it reaches with the stores it reaches there and its limits there: its rate in calls a minute and its quota.

#### Creating a token

1. Press **New token**.
2. Enter a **Name**: what uses it, so you know what breaks if you revoke it. Up to 120 characters.
3. Pick when it **Expires**: **30 days**, **90 days** (the default), **A year** or **Never**.
4. Under **Businesses it may act on**, tick each business it reaches. Open a business to pick its stores (all of them, including ones added later, or only some) and **What it may do** there.
5. Press **Create token**, then copy it. You won't be able to see it again.

A token acts as you in each business it reaches, with at most your access there, checked on every call: if your own access narrows, so does the token's. You can pick only businesses where you may manage API tokens, which is the **Edit** permission on **API tokens**; take it away and your tokens stop working in that business until it's given back. You can hold up to 100 live tokens. Apps you connect don't count toward them: they're on **Connections**, which holds up to 100 live connections of its own.

A token's menu has, for each business it reaches:

- **Edit limits in** the business: its own rate and an optional quota of calls a day or a month, for each store of the business. It needs the **Edit** permission on **API tokens** there.
- **What it made or changed in** the business: the access it granted, the affiliates it made or changed and the automations it created there that still stand, with **End**, **Restore** and **Pause**.
- **Remove from** the business: stops it there alone, offered while it reaches more than one.

Tokens you made before tokens could reach several businesses, and apps you connected before connections did, are listed under **Older tokens in** the business you're in while they still work, each with **Edit limits** and **Revoke**.

#### Revoking a token

**Revoke** stops a token in every business it reaches. Removing and revoking take effect right away and can't be undone: the webhook endpoints, integrations and redirects it set up are turned off. Access it granted to customers, affiliates it made or changed, and automations it created stay until you end or pause them, which the app lists next for the store you're in. The list also links the other stores the token reaches. For a token made before tokens could reach several businesses, in a business with more than 20 stores, **Show more stores** looks through the rest.

Removing you from a business stops your tokens there. Changing your email stops all of them, and your connections too.

### Connections

**Connections** lists the apps that act as you, each reaching the businesses you picked when you connected it from its own sign-in. Only you see yours, and the page needs no permission. For your own scripts, make an [API token](#api-tokens) instead.

Each row shows the connection's name and **Status** (**Active**, **Expired** or **Revoked**), where it can be used (**API**, **MCP**, or **API and MCP**), when it was created and last used, when it expires (or **Until revoked**), and each business it reaches with the stores it reaches there and its limits there: its rate in calls a minute and its quota.

A connection's menu has, for each business it reaches:

- **Edit limits in** the business: its own rate and an optional quota of calls a day or a month, for each store of the business. It needs the **Edit** permission on **API tokens** there.
- **What it made or changed in** the business: the access it granted, the affiliates it made or changed and the automations it created there that still stand, with **End**, **Restore** and **Pause** as for a token. It stays on the menu once the connection ended, and a business it reached again lists each time apart, by when it began: the menu holds the latest four that reach a store you can open, and the list links the rest.
- **Remove from** the business: stops it there alone, offered while it reaches more than one.

A live connection's menu also has **Revoke**, which stops it in every business it reaches. Removing and revoking take effect right away and can't be undone: the webhook endpoints, integrations and redirects it set up are turned off, and what it made or changed stays until you end or pause it, which the app lists next for the store you're in. Another business's actions open on one of its stores, under your permissions there. A connection ends once it reaches no business, as when you leave its last one or are removed from it, or once that business is gone for good, 30 days after it was deleted: it then shows **Revoked** and no longer counts toward your 100.

Source: https://docs.sherpo.io/merchant-app/business-and-team/index.mdx
