Chuyển tới nội dung chính

Account Types in xperise

xperise supports two types of accounts: a Personal Account and a Corporate Account. Every user begins with a Personal Account. A Personal Account becomes a Corporate Account when it gains active membership in a business.


1. Personal Account​

A Personal Account is any authenticated identity in xperise that is not currently linked to an active business. It is the base identity layer for every user in the system.

Attributes​

InformationDescription
Full nameThe display name of the account holder.
Email addressUsed to log in and receive notifications. At least one of email or phone number is required. Each email address can only belong to one account.
Phone numberVietnam phone numbers only. Can be used instead of or alongside an email address. Each number can only belong to one account.
PasswordSet when the user chooses password-based login. Not required for users who log in with Google.
Account statusWhether the account is active, locked, or deactivated.
Email verification statusWhether the email address has been verified. Unverified addresses cannot be used for security-sensitive actions.
Phone verification statusWhether the phone number has been verified. Unverified numbers cannot be used for security-sensitive actions.
Login methodThe ways the account can authenticate: password, OTP, or Google.

Login Methods​

A Personal Account supports login by password, OTP, or Google. See Login Flow for step-by-step instructions on each method, OTP delivery channels, password reset, and password rules.

What a Personal Account Can Do​

  • Log in and access the platform.
  • Create a new business (becoming a Corporate Account upon success).
  • Receive and accept a business invitation (also becoming a Corporate Account).
  • Exist independently without joining any business.

2. Corporate Account​

A Corporate Account is a Personal Account that holds an active membership in a business. The account identity itself does not change — the Corporate Account is the combination of the underlying Personal Account and its active Business Membership record.

Business Membership Attributes​

When an account joins a business, a membership record is created that holds the following information:

InformationDescription
AccountThe user this membership belongs to.
BusinessThe business this user is a member of.
RoleThe user's role within the business: Admin, Accountant, or Normal User.
DepartmentThe department the user belongs to within the business. Optional.
Membership statusWhether the membership is currently active or has been deactivated.
Date joinedWhen the membership became active.
Date removedWhen the membership was deactivated, if applicable.

Business Roles​

RoleWho it isWhat they can do
AdminBusiness administratorManage business profile, departments, users, roles, and security settings.
AccountantAccountantPerforms accounting-related work. No administrative rights.
Normal UserStandard team memberUses the platform within the assigned business. No administrative permissions.

Business Attributes​

Every business that a Corporate Account belongs to has the following information:

InformationDescription
Tax codeA unique code that identifies the business. No two businesses can share the same tax code.
Full nameThe legal name of the business.
Short nameThe display name shown across the platform in day-to-day screens.
Business statusWhether the business is currently active, suspended, or removed.
Mandatory two-step verificationWhether all members must complete an extra verification step after logging in. Off by default.

Additional Security: Business-Level Two-Step Verification​

When a business turns on mandatory two-step verification, every Corporate Account must confirm their identity a second time after logging in — regardless of whether they used a password or Google. The verification code can be sent to a verified email address, a verified Vietnam phone number, or a linked Zalo account.


3. Relationship Between Account Types​

┌────────────────────────────────┐
│ Personal Account │
│ │
│ Full name │
│ Email address │
│ Phone number │
│ Password │
│ Account status │
│ Login method │
└───────────────┬──────────────────┘
│
│ may have 0 or 1 active membership
│
▼
┌────────────────────────────────┐
│ Business Membership │
│ (makes it a Corporate Account) │
│ │
│ Role (Admin / Accountant / │
│ Normal User) │
│ Department (optional) │
│ Membership status │
└───────────────┬──────────────────┘
│
│ belongs to 1 Business
│
▼
┌────────────────────────────────┐
│ Business │
│ │
│ Tax code (unique) │
│ Full name / Short name │
│ Business status │
│ Two-step verification setting │
└────────────────────────────────┘

Key Rules​

RuleDescription
One business at a timeAn account can belong to at most one active business at any given time.
One role per membershipA user has exactly one role within their business.
One department per userA user can be assigned to at most one department within their business.
Creator becomes AdminWhen an account creates a business, it automatically becomes the first Admin.
Account remains after leavingWhen a membership is removed, the personal account is preserved and the user may join or create another business.
Two-step verification cannot be skippedA Corporate Account using Google login must still complete two-step verification when the business requires it.

State Transition Summary​

Personal Account (no business)
│
├─── Creates a business ──────────────► Corporate Account (ADMIN)
│
└─── Accepts a business invitation ──► Corporate Account (ADMIN / ACCOUNTANT / NORMAL_USER)

Corporate Account
│
└─── Membership deactivated ─────────► Personal Account (no active business)

4. Quick Comparison​

Personal AccountCorporate Account
Business membershipNoneActive membership in one business
RoleNoneAdmin, Accountant, or Normal User
DepartmentNoneOptional (one per membership)
Can create a businessYesNo (already in a business)
Subject to two-step verificationNoYes, when the business enables it
Can receive a business invitationYesNo
What it isA standalone accountA personal account with an active business membership