Introduction
Custom Roles are a feature of MyBridgePay whereby Reseller and Sales Agent organizations can create and manage their own custom roles for use within their own hierarchy. Custom roles are linked to a single user type during the create process and cannot be assigned to multiple user types.
User Types
Reseller
Sales Agent
Merchant Group
Merchant Account
Custom Roles can be created and applied for use in several ways, such as:
As a replacement user role(s) for the MyBridgePay default system roles.
As a functional or combined/multi-functional based role (i.e. a role with only the Recurring Billing right assigned, or a role with only Batch Management and Reporting rights assigned).
Multiple roles or a single role assigned to a user.
The use of custom roles can be as simple as creating a few functional specific roles to use in tandem with the default system roles, or can be a replacement user role structure that is customized to fit your organizational business needs. This guide will show you how to create and manage custom roles as it applies to the four available user types within MyBridgePay, but it should be noted that this is an optional feature only and is not required to use MyBridgePay.
Default Systems Roles
There are four default system roles in MyBridgePay, one for each available user type. The default system roles are listed below.
Reseller - assigned to the Reseller user type
Sales Agent - assigned to the Sales Agent user type
Merchant Group - assigned to the Merchant Group user type
Merchant Account - assigned to the Merchant Account user type
Each default system role has a list of ‘rights’ (i.e. permissions) applied to allow basic but broad-based functionality based on the assigned user types.
Default System Roles - Assigned Rights
Reseller
Virtual Terminal: Virtual Terminal Tab, Auth Only, Sale, Refund, Void, Repeat Sale, Refund (Blind), Service Fee Override
Batch Management Tab
Reporting Tab
Merchant Boarding: Boarding Tab, Merchant Account (Add, Edit, Activate/Deactivate), Merchant Group (Add, Edit, Activate/Deactivate), User (Add, Edit, Activate/Deactivate), Processing Applications (View, Configure, Activate/Deactivate), Sales Agent (Add, Edit, Activate/Deactivate)
Administration: Role (Add, Delete, Edit), Change other user's password, Admin Tab
Processors (access to the full list of processors available on MyBridgePay - more on this list of rights later)
Recurring Billing Tab
Sales Agent
Virtual Terminal: Virtual Terminal Tab, Auth Only, Sale, Refund, Void, Repeat Sale, Refund (Blind), Service Fee Override
Batch Management Tab
Reporting Tab
Merchant Boarding: Boarding Tab, Merchant Account (Add, Edit, Activate/Deactivate), Merchant Group (Add, Edit, Activate/Deactivate), User (Add, Edit, Activate/Deactivate), Processing Applications (View, Configure, Activate/Deactivate)
Administration: Role (Add, Delete, Edit), Change other user's password, Admin Tab
Processors (access to the full list of processors available on MyBridgePay - more on this list of rights later)
Recurring Billing Tab
Merchant Group
Virtual Terminal: Virtual Terminal Tab, Auth Only, Sale, Refund, Void, Repeat Sale, Refund (Blind)
Batch Management Tab
Reporting Tab
Merchant Boarding: Boarding Tab, Merchant Account (Edit) User (Add, Edit, Activate/Deactivate)
Administration: Change other user's password, Admin Tab
Recurring Billing Tab
Merchant Account
Virtual Terminal: Virtual Terminal Tab, Auth Only, Sale, Refund, Void, Repeat Sale, Refund (Blind), Adjustment
Batch Management Tab
Reporting Tab
Recurring Billing Tab
Assigning Rights to Custom Roles Explained
When creating custom roles as a Reseller or Sales Agent for your direct hierarchy, you’ll assign a group of “rights” or a singular “right” to a role. This is effectively creating a list of end-user permissions that determine what functionality a user will be able to perform in MyBridgePay.
Reseller – Can create and manage additional Reseller users on their Reseller account; can also create and manage:
Sales Agent accounts and Sales Agent users
Merchant Group accounts and Merchant Group users (both under their Reseller and Sales Agent hierarchies)
Merchant Account accounts and Merchant Account users (both under their Reseller and Sales Agent hierarchies)
Sales Agent – Can create and manage additional Sales Agent users on their Sales Agent account; can also create and manage:
Merchant Group accounts and Merchant Group users (only under their Sales Agent hierarchy)
Merchant Account accounts and Merchant Account users (only under their Sales Agent hierarchy)
List of Rights that can be assigned to Custom Roles
Reseller and Sales Agent users can create and manage custom roles assigned to the different user types available within their hierarchy structure. The rights that are assignable by user type are listed below.
Please note that while all rights display as selectable options when creating custom roles for all user types, not all rights will function on all user types. The permission rights mapping below provides a list of rights that will functionally work with the specified user type.
Reseller - permission rights options available for the Reseller user type
Module / Function | Permission Rights | Definition |
|---|---|---|
Virtual Terminal | Auth Only | Credit card authorization transaction |
| Sale | Credit card and ACH sale transactions |
| Refund | Credit card refund on settled transaction |
| Void | If enabled on a user, will allow voiding payments in the Find Transactions module. |
| Repeat Sale | Credit card authorization and sale transactions |
| Virtual Terminal Tab | Displays the Virtual Terminal payment form |
| Refund (Blind) | Credit card and ACH refund without using a previously processed sale transaction (requires additional configuration setting enabled on a Merchant Account) |
| Cash-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Sale right) |
| Cash-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Refund right) |
| Check-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Sale right) |
| Check-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Refund right) |
| Refund-Sale | Credit card and ACH refund of a Sale transaction |
| Refund-Auth | Credit card refund of an authorization transaction |
| Service Fee Override | Ability to change or remove service fee amount and convenience fee amount on payment form. |
Batch Management | Batch Management Tab | Displays the Batch Management module and allows full access to manage and settle open batches, and review settled batch information. |
| Unsettled Transaction Void | If enabled on a user, will allow voiding payments on the Batch Management Unsettled Batch tab. |
Reporting | Reporting Tab | Displays the Reporting module and allows full access to execute, display, and export all reports. |
Merchant Boarding | Boarding Tab | Displays the Account Management module |
| Merchant Account | Displays the merchant account organization level for administration purposes |
| Add | Add a merchant account |
| Activate/Deactivate | Activate and Deactivate merchant accounts |
| Edit | Make changes to a merchant account |
| Merchant Group | Displays the merchant group organization level for administration purposes |
| Add | Add a merchant group |
| Edit | Make changes to a merchant group |
| Activate/Deactivate | Activate and Deactivate merchant groups |
| User |
|
| Add | Add a user (can only add users to organizations for which you have access) |
| Edit | Make changes to a user (can only make update to users on organizations for which you have access) |
| Activate/Deactivate | Activate and Deactivate users (can only activate and deactivate users on organizations for which you have access) |
| Processing Applications |
|
| View | View the Processing Applications tab |
| Configure | Make changes to a configuration setting on the Processing Applications tab |
| Activate/Deactivate | Activate and Deactivate configuration settings on the Processing Applications tab |
| Sales Agent | Displays the sales agent organization level for administration purposes |
| Add | Add a sales agent |
| Activate/Deactivate | Activate and Deactivate a sales agent |
| Edit | Make changes to a sales agent |
Administration | Role - Add | Ability to create a custom role |
| Role - Delete | Ability to delete a custom role |
| Role - Edit | Ability to make changes to a custom role. This includes changing the user type, adding role grading, or changing permission rights. |
| Admin tab | Displays the Admin module and allows users to create, edit, and delete custom roles. |
Processors | Processors Tab | Displays the Processors list that can be enabled as a select option for the Processors tab in Account Management to configure a Merchant Account. Ex: Enable TSYS as a processor on a Reseller or Sales Agent custom role, and only TSYS will appear as a processor option. |
Recurring Billing | Recurring Billing Tab | Displays the Recurring Billing module and allows full access to create/manage customers and wallets, contracts, contact templates, billing frequency templates, and processing transactions via the Recurring Billing Virtual Terminal payment form. |
Custom Fields | Transaction Custom Fields |
|
| View | Ability to view the Custom Fields Template in Account Management. |
| Add | Ability to create new custom fields. |
| Edit | Ability to make changes to existing custom fields. |
| Activate/Deactivate | Ability to activate and deactivate custom fields from the Custom Fields Template. |
| Activate Custom Fields |
|
| Configure | Ability to mass activate custom fields via the Boarding API only. |
| Deactivate Custom Fields |
|
| Configure | Ability to mass activate custom fields via the Boarding API only. |
Sales Agent - permission rights options available for the Sales Agent user type
Module / Function | Permission Rights | Definition |
|---|---|---|
Virtual Terminal | Auth Only | Credit card authorization transaction |
| Sale | Credit card and ACH sale transactions |
| Refund | Credit card refund on settled transaction |
| Void | If enabled on a user, will allow voiding payments in the Find Transactions module. |
| Repeat Sale | Credit card authorization and sale transactions |
| Virtual Terminal Tab | Displays the Virtual Terminal payment form |
| Refund (Blind) | Credit card and ACH refund without using a previously processed sale transaction (requires additional configuration setting enabled on a Merchant Account) |
| Cash-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Sale right) |
| Cash-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Refund right) |
| Check-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Sale right) |
| Check-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Refund right) |
| Refund-Sale | Credit card and ACH refund of a Sale transaction |
| Refund-Auth | Credit card refund of an authorization transaction |
| Service Fee Override | Ability to change or remove service fee amount and convenience fee amount on payment form. |
Batch Management | Batch Management Tab | Displays the Batch Management module and allows full access to manage and settle open batches, and review settled batch information. |
| Unsettled Transaction Void | If enabled on a user, will allow voiding payments on the Batch Management Unsettled Batch tab. |
Reporting | Reporting Tab | Displays the Reporting module and allows full access to execute, display, and export all reports. |
Merchant Boarding | Boarding Tab | Displays the Account Management module |
| Merchant Account | Displays the merchant account organization level for administration purposes |
| Add | Add a merchant account |
| Activate/Deactivate | Activate and Deactivate merchant accounts |
| Edit | Make changes to a merchant account |
| Merchant Group | Displays the merchant group organization level for administration purposes |
| Add | Add a merchant group |
| Edit | Make changes to a merchant group |
| Activate/Deactivate | Activate and Deactivate merchant groups |
| User |
|
| Add | Add a user (can only add users to organizations for which you have access) |
| Edit | Make changes to a user (can only make update to users on organizations for which you have access) |
| Activate/Deactivate | Activate and Deactivate users (can only activate and deactivate users on organizations for which you have access) |
| Processing Applications |
|
| View | View the Processing Applications tab |
| Configure | Make changes to a configuration setting on the Processing Applications tab |
| Activate/Deactivate | Activate and Deactivate configuration settings on the Processing Applications tab |
Administration | Role - Add | Ability to create a custom role |
| Role - Delete | Ability to delete a custom role |
| Role - Edit | Ability to make changes to a custom role. This includes changing the user type, adding role grading, or changing permission rights. |
| Admin tab | Displays the Admin module and allows users to create, edit, and delete custom roles. |
Processors | Processors Tab | Displays the Processors list that can be enabled as a select option for the Processors tab in Account Management to configure a Merchant Account. Ex: Enable TSYS as a processor on a Reseller or Sales Agent custom role, and only TSYS will appear as a processor option. |
Recurring Billing | Recurring Billing Tab | Displays the Recurring Billing module and allows full access to create/manage customers and wallets, contracts, contact templates, billing frequency templates, and processing transactions via the Recurring Billing Virtual Terminal payment form. |
Custom Fields | Transaction Custom Fields |
|
| View | Ability to view the Custom Fields Template in Account Management. |
| Add | Ability to create new custom fields. |
| Edit | Ability to make changes to existing custom fields. |
| Activate/Deactivate | Ability to activate and deactivate custom fields from the Custom Fields Template. |
| Activate Custom Fields |
|
| Configure | Ability to mass activate custom fields via the Boarding API only. |
| Deactivate Custom Fields |
|
| Configure | Ability to mass activate custom fields via the Boarding API only. |
Merchant Group - permission rights options available for the Merchant Group user type
Module / Function | Permission Rights | Definition |
|---|---|---|
Virtual Terminal | Auth Only | Credit card authorization transaction |
| Sale | Credit card and ACH sale transactions |
| Refund | Credit card refund on settled transaction |
| Void | If enabled on a user, will allow voiding payments in the Find Transactions module. |
| Repeat Sale | Credit card authorization and sale transactions |
| Virtual Terminal Tab | Displays the Virtual Terminal payment form |
| Refund (Blind) | Credit card and ACH refund without using a previously processed sale transaction (requires additional configuration setting enabled on a Merchant Account) |
| Cash-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Sale right) |
| Cash-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Refund right) |
| Check-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Sale right) |
| Check-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Refund right) |
| Refund-Sale | Credit card and ACH refund of a Sale transaction |
| Refund-Auth | Credit card refund of an authorization transaction |
| Service Fee Override | Ability to change or remove service fee amount and convenience fee amount on payment form. |
Batch Management | Batch Management Tab | Displays the Batch Management module and allows full access to manage and settle open batches, and review settled batch information. |
| Unsettled Transaction Void | If enabled on a user, will allow voiding payments on the Batch Management Unsettled Batch tab. |
Reporting | Reporting Tab | Displays the Reporting module and allows full access to execute, display, and export all reports. |
Merchant Boarding | Boarding Tab | Displays the Account Management module |
| Merchant Account | Displays the merchant account organization level for administration purposes |
| Edit | Make changes to a merchant account (does not allow editing of the organization account, but is required to edit merchant account users by the merchant group user type) |
| User |
|
| Add | Add a user (can only add users to organizations for which you have access) |
| Edit | Make changes to a user (can only make update to users on organizations for which you have access) |
| Activate/Deactivate | Activate and Deactivate users (can only activate and deactivate users on organizations for which you have access) |
Recurring Billing | Recurring Billing Tab | Displays the Recurring Billing module and allows full access to create/manage customers and wallets, contracts, contact templates, billing frequency templates, and processing transactions via the Recurring Billing Virtual Terminal payment form. |
Custom Fields | Transaction Custom Fields |
|
| View | Ability to view the Custom Fields Template in Account Management. |
| Add | Ability to create new custom fields. |
| Edit | Ability to make changes to existing custom fields. |
| Activate/Deactivate | Ability to activate and deactivate custom fields from the Custom Fields Template. |
| Activate Custom Fields |
|
| Configure | Ability to mass activate custom fields via the Boarding API only. |
| Deactivate Custom Fields |
|
| Configure | Ability to mass activate custom fields via the Boarding API only. |
Merchant Account - permission rights options available for the Merchant Account user type
Module / Function | Permission Rights | Definition |
|---|---|---|
Virtual Terminal | Auth Only | Credit card authorization transaction |
| Sale | Credit card and ACH sale transactions |
| Refund | Credit card refund on settled transaction |
| Void | If enabled on a user, will allow voiding payments in the Find Transactions module. |
| Repeat Sale | Credit card authorization and sale transactions |
| Virtual Terminal Tab | Displays the Virtual Terminal payment form |
| Refund (Blind) | Credit card and ACH refund without using a previously processed sale transaction (requires additional configuration setting enabled on a Merchant Account) |
| Cash-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Sale right) |
| Cash-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Check-Refund right) |
| Check-Sale | Cash and Check (paper) sale transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Sale right) |
| Check-Refund | Cash and Check (paper) refund transactions; (note these transactions appear on transaction reports only and are for informational purposes. They do not settle as part of a daily batch. – interchangeable with Cash-Refund right) |
| Refund-Sale | Credit card and ACH refund of a Sale transaction |
| Refund-Auth | Credit card refund of an authorization transaction |
| Service Fee Override | Ability to change or remove service fee amount and convenience fee amount on payment form. |
Batch Management | Batch Management Tab | Displays the Batch Management module and allows full access to manage and settle open batches, and review settled batch information. |
| Unsettled Transaction Void | If enabled on a user, will allow voiding payments on the Batch Management Unsettled Batch tab. |
Reporting | Reporting Tab | Displays the Reporting module and allows full access to execute, display, and export all reports. |
Recurring Billing | Recurring Billing Tab | Displays the Recurring Billing module and allows full access to create/manage customers and wallets, contracts, contact templates, billing frequency templates, and processing transactions via the Recurring Billing Virtual Terminal payment form. |
Processors
BridgePay has a variety of processor options available, however not all of those listed on the custom roles rights/permissions settings are currently certified. The list below is comprised of the processors that are certified and available for merchant processing. A custom role can be created for Reseller and Sales Agent users to limit the processor options list display when adding processors to a merchant account.
The list of active certified processors available on BridgePay Gateway is listed below.
Processor | Payment Method |
|---|---|
GETI (PAYA) | ACH |
Eft T-TECH | ACH |
First data Omaha | Credit/Debit |
TSYS | Credit/Debit |
Vantiv Tandem | Credit/Debit |
First Data Rapid Connect | Credit/Debit |
Heartland Portico | Credit/Debit |
Elavon ViaConex4 | Credit/Debit |
SVS | Gift Card |
SPK (Sparkbase / Factor 4) | Gift Card |
TenderCard | Gift Card |
Profit Stars | ACH |
Optional Role Grading for Merchant group Custom Roles
Feature which allows optional security role grading to be applied to custom roles created by Resellers and Sales Agents for the “Merchant Group User” type. Role grading allows the Merchant Group user’s custom role to have a user security grading setting that ranks the role from 1 (highest access) to 99 (lowest access).Merchant Group users assigned a custom role may only create and manage roles of other merchant group users with the same grade ranking or lower. Multiple custom roles can be created with the same role grading number.Role graded custom roles can exist in combination with non-graded custom roles, but is not recommended.To enable the role grading security feature to function on applicable role graded custom roles for Merchant Group users, the “Use Role Grading” button must be enabled on the Merchant Group account.Please Note: If role-graded custom roles are being used in combination with non-graded custom roles, the non-graded custom roles will be applicable to all merchant group users regardless of any graded custom roles assigned to the user.Example of usage:If two custom roles are created and assigned a role-grade:
Merchant Group Admin – 1
Merchant Group Supervisor – 2
A user assigned the Merchant Group Supervisor role will not be able to assign, create, edit, activate, or deactivate users with the Merchant Group Admin custom role.
Hide System Roles Feature for Merchant Groups and Merchant Accounts
Feature which allows the default system roles to be hidden from the Roles select list when creating and managing Merchant Group and Merchant Account users. When enabled, only the custom roles created by Resellers and Sales Agents will be displayed and available for selection.The setting is located on the Business Info form.