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

# Team Roles & Permissions

> What each permission on the Manage Team page controls, and what the default roles can do.

Roles decide what each teammate can do in the dashboard. Every teammate has one role.

<Card title="Open Manage Team" icon="users" horizontal href="https://app.xpaycheckout.com/settings">
  Manage your team and their permissions in the dashboard.
</Card>

## Default roles

Every account starts with three roles.

| Permission                       | Owner | Admin | Sales |
| -------------------------------- | :---: | :---: | :---: |
| Transactions: Create             |   ✅   |   ✅   |   ✅   |
| Transactions: Refund & Cancel    |   ✅   |   ✅   |   —   |
| Transactions: Dispute Management |   ✅   |   ✅   |   —   |
| Transactions: Receive Mail       |   ✅   |   ✅   |   —   |
| Balances: View                   |   ✅   |   ✅   |   —   |
| Virtual Bank Account: View       |   ✅   |   ✅   |   —   |
| Settings: Manage                 |   ✅   |   ✅   |   —   |
| Team management: Manage          |   ✅   |   —   |   —   |
| Developer: Manage                |   ✅   |   ✅   |   —   |
| Onboarding: Manage               |   ✅   |   —   |   —   |

* **Owner** — full access. Can't be edited.
* **Admin** — everything except team and onboarding.
* **Sales** — payment links only.

<Info>
  Every teammate can view transactions and Merchant Details, whatever their role.
</Info>

## Creating a new role

Need something in between? Create a role with exactly the permissions you want.

<Steps>
  <Step title="Open Manage Team">
    Go to [Settings › Manage Team](https://app.xpaycheckout.com/settings).
  </Step>

  <Step title="Click + New Role">
    Name the role. The name can't be changed later.
  </Step>

  <Step title="Tick the permissions">
    Everything starts off. Tick only what the role needs.
  </Step>

  <Step title="Save and assign">
    Assign the role to teammates from the team list below the table.
  </Step>
</Steps>

You can also edit Admin, Sales and your own roles with **Edit**. Owner can't be changed, and roles can't be renamed or deleted. Anyone with an edited role has to sign in again.

## What each permission means

### Transactions

| Permission             | What turning it on means                                                                 |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| **Create**             | Create, expire, capture and void payment links.                                          |
| **Refund & Cancel**    | Refund payments in full or in part, and manage subscriptions.                            |
| **Dispute Management** | Open the Disputes page and respond to chargebacks.                                       |
| **Receive Mail**       | Receive email alerts about payments, refunds, payouts and disputes. No dashboard access. |

<Tip>
  Teammates also pick which emails they want under **Profile › Email Preferences**. New teammates start with only dispute emails on. Customer emails, such as receipts, are set in **Settings › Customer Communication**.
</Tip>

### Account & funds

| Permission                     | What turning it on means                                                |
| ------------------------------ | ----------------------------------------------------------------------- |
| **Balances: View**             | View balances, payouts and statements, and download exports. Read-only. |
| **Virtual Bank Account: View** | View your account details, balance and incoming transfers. Read-only.   |

### Administration

| Permission                  | What turning it on means                                    |
| --------------------------- | ----------------------------------------------------------- |
| **Settings: Manage**        | Edit Customer Communication, Payment Methods and your logo. |
| **Team management: Manage** | Invite teammates and manage roles. Treat as full access.    |
| **Developer: Manage**       | View and create API keys, and manage webhooks.              |
| **Onboarding: Manage**      | Complete business verification (KYB) and upload documents.  |
