Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
  • Home
  • Admin

Managing Users, Roles and Permissions

Written by Chris Joyce

Updated at May 15th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Patient Portal
  • Admin
    Config Reports Onboarding
  • Integration
  • Release Notes
+ More

Table of Contents

Add New User Edit User Clone User Activate / Deactivate User Managing Roles/Permissions Permissions System Default Roles Download User List

User Management gives administrators the ability to add, edit, clone, deactivate and re-activate users. You can also edit roles/permissions. Lastly, you can download a list of users for auditing purposes and view the User Activity Log.

Figure 162 - User Management

Filters at the top allow you to filter users by practice(s), role(s) or status. The default shows only Active users and is sorted by Username. You can also type any criteria into the Search field, and it will automatically filter for users that match your criteria.

The listing of users includes the following columns:

  • First Name
  • Last Name
  • Username
  • Email
  • Role
  • Status
  • Actions

The Bulk Edit feature lets you deactivate multiple users or send welcome emails at once. NOTE: When sending welcome email, each user will be forced to reset password upon receiving the welcome email.

Figure 164 - Bulk Edit

Both Send Welcome Email and Deactivate Users will confirm the user wants to perform this action to prevent accidentally deactivating or sending a welcome email to too many users.

Figure 163 - Deactivate Users Confirmation

The Download feature, lets you export the user list to CSV for audits. To add a new user, press Add New User. To edit a user, click the pencil icon next to the user.
 

Add New User

The Add New User dialog prompts you for the basic information on a new user including first and last name, email, mobile number, username, role, password, practice and reports. We require that each username be unique. You should also make the username unique across all environments (Prod, UAT, Demo, etc.) so that Okta single sign-on works properly.

The admin can assign a default password or choose to have the user create their own password on their first login. Additionally, if the admin wants the user to receive a welcome email with a link to PatientPay Admin, they can check this box. Otherwise, no notification is sent to the user upon account creation.

NOTE: The password must be at least 8 characters and contain at least one special character or digit.

Figure 165 - Add New User

If “Allow user to create own password” is checked, the first time they login to PatientPay, they will be prompted to create a password per our policy.

Figure 166 - New User Password Creation

NOTE: Any new user will remain in status Inactive until they login for the first time.
 

Edit User

By clicking the pencil icon next to a user, you can edit the user’s details. Press Save to commit your changes or Cancel to dismiss the dialog and abandon your changes. If the admin wants to send the user a welcome email to give them an easy way to login after account creation, they can check “Send welcome email” and press Save.

Figure 167 - Edit User
 

Clone User

You can use the Clone User button to clone an existing user and avoid user errors with configuring the Practices and Reports. You are required to enter a unique First Name, Last Name, Email, Username and Password before pressing Save.

Figure 168 - Clone User
 

Activate / Deactivate User

To disable a user from logging into the system, you can edit the user using the pencil icon and choose the Deactivate User button. If you ever want to re-activate them, choose the Activate User button. The user will receive a “Welcome to PatientPay” email with their PatientPay username and a link to activate their account. Our system will consider them Inactive/deactivated until they click that invitation and set up a password.

Figure 169 - Okta SSO Welcome Email
 

Managing Roles/Permissions

Users with the PatientPay System Administrator role can edit the roles/permissions including adding custom roles. This can be helpful in situations where user requirements are unique and outside the three default system roles: PatientPay System Administrator, Practice Administrator and Practice User. To edit roles/permissions, choose the Roles button from the main screen.

Figure 170 - Role Management

NOTE: Users are not permitted to edit the permissions of the PatientPay System Administrator role or give any role the Configuration permission.

The user has the following options on this screen:

Add New Role
This will create a new role. The role is given a default name but you are encouraged to give it a more descriptive name. Simple check off the desired permissions and press Save.

Clone Role
This will clone the existing roles permissions and create a new role. This is helpful if you want to customize one of the existing roles with unique permissions. The role is given a default name but you are encouraged to give it a more descriptive name. Simple check off the desired permissions and press Save.

Delete
Choose this option if you wish to delete a custom role. Ensure that no users are assigned to this role before deleting.

Save
Choose this option to save changes to your role.
 

Permissions

The permission for a role are broken into four sections: Modules, Features, Onboarding and Security. The following represents the available permissions for custom roles and their purpose:

Permission Description
Modules  
Search Can view/access Search menu
Analytics Can view/access Analytics menu
Create Payment Can view/access Create Payment menu
Cash Register Can view/access Cash Register menu
User Management Can view/access User Management menu
Onboarding Can view/access Onboarding menu
Configuration Can view/access Configuration menu
Reports Can view/access Reports menu
Features  
Bill Payments Can access Bill Payments function
Now Payments Can access Now Payments function
Insurance Payments Can access Insurance Payments function
Subscriptions Can access Subscriptions function
Partial payments Can issue partial payments
Voids/refunds Can issue voids/refunds
Partial refunds Can issue partial refunds
Payment Plan Custom Installments Can customize payment plans
Download Statement Can download statement JSON
View SMS Responses Can view SMS responses from patients
Onboarding  
Create Application Can initiate/start a new onboarding application
Delete Application Can delete an onboarding application
Underwriting Approval Can access the Underwriting section and Approve/Reject application
MID Request Can access Request MID button in Merchant ID section
Security  
Security System Admin Can create System Admin roles
Security Practice Admin Can create Practice Admin roles
Security Practice User Can create Practice User roles
Security Manage Roles Can access Role Management

 

System Default Roles

Below is a breakdown of the permissions available to each system role:

Permission System Admin Practice Admin Practice User
Modules      
Search X X X
Analytics X    
Create Payment X X X
Cash Register X X X
User Management X X  
Onboarding      
Configuration X    
Reports X X X
Features      
Bill payments X X X
Now payments X X X
Insurance payments X X X
Subscriptions X X X
Partial payments X X  
Voids/refunds X X  
Partial refunds X X  
Payment Plan Custom Installments X X  
Download Statement X    
View SMS Responses X X X
Onboarding      
Create Application      
Delete Application      
Underwriting Approval      
MID Request      
Security      
Add/Edit users of role System Admin X    
Add/Edit users of role Practice Admin X X  
Add/Edit users of role Practice User X X  
Add/Edit roles X    


PatientPay System Administrator
The System Administrator has all rights in PatientPay including:

  • Can create additional user roles
  • Can add additional System Administrators, Practice Administrators and Practice Users
  • Can access Configuration to manage system configuration settings
  • Can access all reports and Analytics
  • Can access Download Statement(s) on Bill Detail
  • Can complete patient transactions for any practice

Practice Administrator
Practice Administrators are given higher levels of access to specific practices:

  • Can add additional admins and users to their practices
  • Can deactivate other admins and users in their practices
  • Can update User Management details such as username, password, role, reports, etc.
  • Can look up transactions and complete refunds for patients that belong to their practices
  • Can complete patient transactions including partial payments for patients belonging to their practices
  • Report access is granted in User Management

Practice User
Practice Users are given basic levels of access to specific practices:

  • Can complete patient transactions for their practice(s), including partial payments
  • Can look up transactions for their practice(s), but are unable to issue refunds
  • Cannot access Configuration
  • Cannot access User Management
  • Can only update their own user details under My Account
  • Can only view reports as assigned in User Management
     

Download User List

It is often helpful to export the user list for SOX audits that require evidence of access controls. The Download feature on the main user listing provides easy access to a CSV export of the users in your profile. For example, Practice Admins will only be able to export users that belong to their practice(s). To export your user list to CSV, simply select Download and CSV from the menu.

NOTE: The Download operation can take a few seconds to load so give it some time before the CSV will automatically download to your browser.

The downloaded file will be a comma-delimited (CSV) file with a header record in the first row containing the following columns:

  • First Name
  • Last Name
  • Username
  • Email
  • Role
  • Practices
  • Reports
  • Status

The Practices and Reports values will represent a pipe-delimited list of the practice and report names in the user’s profile. PatientPay System Administrators will have their Practices and Reports values blank representing all. The Status column will have a value of Active or Inactive depending on the status of the user account. All values will be enclosed in double quotes to preserve spacing and special characters. It may be helpful to load the CSV into a common application like Microsoft Excel or Google Sheets for easier viewing.

user management roles custom roles permissions

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Login
  • Multi-factor Authentication (MFA)
  • Accessing Account Preferences

Copyright 2025 – PatientPay.

Knowledge Base Software powered by Helpjuice

Expand