Skip to content
YusrDocs

Team roles and permissions#

Invite the people who build, run and support your payments to your Yusr dashboard. Each team member has one role per business, and the role decides what they can see and do. The same rules are enforced by the dashboard and the API behind it, so hiding a button is never the only protection.

Roles#

RoleWho it is for
OwnerThe account holder. Everything, including transferring ownership. Each business has exactly one Owner.
AdminSenior staff who run the account day to day: team, settings, settlement account, keys and verification. Everything except transferring ownership.
DeveloperEngineers integrating Yusr: API keys, webhooks, request logs, test-mode simulation and cancelling pending transactions. No access to business settings, the settlement account or the team.
SupportCustomer support and operations: find transactions, export reports, check webhook deliveries and resend events. Read-only otherwise.
ViewerRead-only access to the dashboard, transactions, settlements and webhook endpoints, for example for finance or auditors.

Permission matrix#

This table is generated from the same permission definitions the platform enforces.

Permissions granted to each team role. A check mark means the role has the permission.
PermissionOwnerAdminDeveloperSupportViewer
View dashboard and reportsdashboard.viewAllowedAllowedAllowedAllowedAllowed
View transactionstransactions.viewAllowedAllowedAllowedAllowedAllowed
Export transactions and settlements as CSVtransactions.exportAllowedAllowedAllowedAllowedNot allowed
Cancel pending transactionstransactions.cancelAllowedAllowedAllowedNot allowedNot allowed
Simulate payments in test modetransactions.simulateAllowedAllowedAllowedNot allowedNot allowed
View settlements and balancessettlements.viewAllowedAllowedAllowedAllowedAllowed
View webhook endpoints and delivery logswebhooks.viewAllowedAllowedAllowedAllowedAllowed
Create, edit and delete webhook endpointswebhooks.manageAllowedAllowedAllowedNot allowedNot allowed
Resend webhook eventsevents.resendAllowedAllowedAllowedAllowedNot allowed
View API keys (masked)keys.viewAllowedAllowedAllowedNot allowedNot allowed
Create, roll and revoke API keyskeys.manageAllowedAllowedAllowedNot allowedNot allowed
View API request logslogs.viewAllowedAllowedAllowedNot allowedNot allowed
View business settingssettings.viewAllowedAllowedAllowedAllowedAllowed
Change business profile, branding and payment behavioursettings.manageAllowedAllowedNot allowedNot allowedNot allowed
Change the settlement bank accountsettlement_account.manageAllowedAllowedNot allowedNot allowedNot allowed
View team membersteam.viewAllowedAllowedAllowedAllowedAllowed
Invite, remove and change roles of team membersteam.manageAllowedAllowedNot allowedNot allowedNot allowed
Submit business verification (KYC)kyc.manageAllowedAllowedNot allowedNot allowedNot allowed
View the account audit logaudit.viewAllowedAllowedNot allowedNot allowedNot allowed
Transfer account ownershipownership.transferAllowedNot allowedNot allowedNot allowedNot allowed
Two-factor authenticationRequired to sign inRequiredRequiredOptionalOptionalOptional

Two-factor authentication#

Owners and Admins must sign in with two-factor authentication (six-digit codes from any authenticator app that supports TOTP). If they have not set it up yet, they are asked to do so at their next sign-in, and they cannot turn it off while they hold that role. For every other role, 2FA is optional but strongly recommended; each person can enable it under Settings → Security.

Recovery codes are shown once when 2FA is enabled. Store them safely: they are the way back in if a phone is lost.

Inviting your team#

  1. Go to Team in the dashboard (you need the team.manage permission: Owner or Admin).
  2. Choose Invite member, enter their email address and pick a role.
  3. They receive an email with a link to accept. New users set a password; people who already have a Yusr login simply join your business, and can switch between businesses from the dashboard.

Pending invitations can be cancelled from the same page. You can change a member's role or remove them at any time; removing someone ends their access to your business.

Transferring ownership#

Only the current Owner can transfer ownership, to an existing team member. After the transfer, the previous Owner becomes an Admin. The new Owner must use two-factor authentication.

Audit log#

Changes to keys, webhooks, settings, the settlement account and the team are recorded in the account audit log with who made the change, when, from which IP address, and the values before and after. Owners and Admins can read it in the dashboard (the audit.view permission).

API keys are not people#

Secret keys act for the business, not for a team member, and are not limited by roles. Treat them like a password to the whole account: keep them on your servers, give access only to the people and systems that need it, and roll a key when someone with access leaves. See Authentication.