User Management
Manage who on your team can access the TransFi Checkout dashboard and what they can do.
Where to find it: Dashboard β Settings β Teams
Only Admin users can invite, edit roles, or remove team members
Roles & Team Management
There are 4 roles available in the TransFi Dashboard.
Each role has a fixed set of permissions : custom roles are not supported.
Available Roles
| Role | What they can do |
|---|---|
| Admin | Full view and edit access to all dashboard features including user management |
| Developer | Create/edit Checkout Widget, create/update support tickets, view API keys, view transactions, view settlements |
| Operations | View and download transactions and settlements, view settlement account details |
| View only | Read-only access to transactions, settlements, and settings. Intended for TransFi support team to debug issues |
Permission Breakdown
| Permission | Admin | Developer | Operations | View only |
|---|---|---|---|---|
| Widget Create / Update | β | β | β | β |
| Support Ticket Create / Update | β | β | β | β |
| API Key Read | β | β | β | β |
| Transaction Read | β | β | β | β |
| Transaction Download | β | β | β | β |
| Settlement Read | β | β | β | β |
| Settlement Download | β | β | β | β |
| Settings Read | β | β | β | β |
| User Management (full) | β | β | β | β |
How to Invite a Team Member
From Dashboard
- Go to
Settings β Teams - Click
+ Invite User - Enter the user's email address
- Select a role
- Click
Send Invite
The user will receive an email invitation.
The invite appears as pending in the Teams table until accepted.
Via API
POST /checkout/user-management/invite{
"email": "[email protected]",
"roleId": "developer"
}[!TIP] Only Admin users can call this endpoint. Requests from non-admin roles will be rejected.
How to Edit a Team Member's Role
From Dashboard
- Go to
Settings β Teams - Click the edit (pencil) icon next to the user
- Select the new role from the dropdown
- Click
Update Role
Via API
PUT /checkout/user-management/users/{cxId}/role{
"roleId": "operations"
}[!NOTE] Admin users cannot have their role changed or be removed. The edit and delete actions are disabled for Admin accounts.
How to Remove a Team Member
From Dashboard
- Go to
Settings β Teams - Click the delete (trash) icon next to the user
- Confirm the removal
Via API
DELETE /checkout/user-management/users/{cxId}Managing Pending Invites
Invites that haven't been accepted yet can be revoked.
List Pending Invites
GET /checkout/user-management/invitesRevoke an Invite
DELETE /checkout/user-management/invites/{inviteId}In the dashboard, pending invites appear in the Teams table.
Clicking the delete icon on a pending invite revokes the invite rather than removing a user.
Accepting an Invite
When a user receives an invite email, they click the invite link which calls:
POST /checkout/user-management/accept-inviteThis completes onboarding and grants dashboard access with the assigned role.
Other Endpoints
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /checkout/user-management/roles | List all available roles |
| GET | /checkout/user-management/me | Get current authenticated user's details and role |