Revenova PayIQ Installation Guide

Prev Next

Winter ‘26 PayIQ Installation Instructions

Installation and System-Level Configuration should be performed with the assistance of the System Administrator or Revenova Support.

Complete the installation of the TMS Winter ‘26 package first before installing the Winter ‘26 PayIQ package. If upgrading an existing PayIQ installation, make sure the Fall ‘25 PayIQ package is installed and configured before proceeding.

Package Installation

In order to install PayIQ onto a TMS installation, complete the following steps.

  1. Obtain the latest install link and password by contacting Revenova Support.

  2. Use the password provided, and use the Install for all Users setting.

  3. Check the acknowledgement and click Install.

  4. Wait a few minutes for the application to complete the installation process. An email is sent upon completion of the installation.

    Installation screen for TMS PayIQ app with options for user roles and installation confirmation.

Assign Licenses to User Accounts

Assign TMS PayIQ licenses to the appropriate users. Only licensed users have access to PayIQ objects and fields.

PayIQ Fields and Related Lists

Add fields and related lists to the Load record page to allow Users to view pay from the Load the pay was generated.

Navigate to Setup → Object Manager → Load object → Lightning Record Pages. Select the appropriate Load record page.

If necessary, assign the record page as the org default for all users, app default, or app/record type/profile settings. See Salesforce documentation linked in the dialog under “Learn more about Lightning page assignment” for more information.

After assigning the default, customize the Load page layout with the following lists and fields that are applicable to PayIQ.

  • Participant Matches (related list)

  • Pay Details (related list)

  • PayIQ Logs (related list)

  • PayIQ Locked (field)

  • Sales Lead (Contact) (field - only relevant if this field is used for pay)

  • Custom PayIQ Eligible Date (field - only relevant if this field is used to customize when a Load is paid)

Save the page layout when complete.

Permission Sets

One permission set is included with the PayIQ package: TMS Developer PayIQ. This permission set includes all objects and fields within the PayIQ package. Assess the business needs and develop appropriate permission sets for users based on data accessibility. See additional Salesforce documentation on Permission Sets here.

Review fields added by the installation here. Set user CRUD access as needed.

Sharing Settings

In order for Pay Estimates to appear in the Fleet Email Loop, create sharing rules for the Pay Estimate, Pay Estimate Detail, and PayIQ Program objects.

  1. From Setup, search for and select Sharing Settings.

  2. In the Manage sharing settings for: drop-down, select the Pay Estimate object.

  3. In the Sharing Rules section, click the New button.

    1. Enter a Rule Name Label to generate the

    2. Select the Guest user access, based on criteria radio button.

    3. Choose a Field from the list of Criteria and select an Operator with a nonsensical Value. See the screenshot below for an example.

      1. Avoid using a picklist field when using the not equal to operator. Salesforce expects an existing picklist value.

    4. In the Share With drop-down, select Email_Loop Site Guest User.

    5. Confirm the Access Level is set to Read Only.

    6. Click Save.

    7. The Sharing Rule also applies to the Pay Estimate Detail object. This object does not require a sharing rule as it is a Master-Detail relationship to the Pay Estimate object.

  4. Repeat the steps from the Manage sharing settings for: drop-down for the PayIQ Program object.

Setup page for sharing rules with highlighted options for guest user access.

Upgrading from a Previous Version

Follow the upgrade steps from the oldest release to the newest release, in order, for any upgrades that span multiple releases.

Complete the installation of the TMS Winter ‘26 package first before installing the Winter ‘26 PayIQ package. If upgrading an existing PayIQ installation, make sure the Fall ‘25 PayIQ package is installed and configured before proceeding.

Winter ‘26 PayIQ Upgrade Instructions

All steps below must be completed.

  1. Install and test in a sandbox environment before upgrading to the production environment.

  2. Install and completely configured the PayIQ Fall ‘25 before installing this upgrade.

  3. Obtain the Winter ‘26 installation URL and password from your Revenova representative.

    1. Install the upgrade.

      1. Select Install for All Users.

      2. Click Upgrade.

      3. Check the Yes, grant access to these third-party web sites box.

      4. Click Continue.

      5. In Setup, find Deployment Status and click the link to view the progress of the installation.

      6. Wait for the Installation succeeded email.

  4. Navigate to Setup → Object Manager.

    1. Find and select the Calculation Tier object.

    2. Select the Fields & Relationships link.

    3. Choose the Calculation Method field.

    4. From the Values section, click the New button.

    5. Add the following picklist values to the box.

      1. One-Time Payout at Target

      2. Amount per Load Contributing to Bracket

      3. Percent of Load Contribution Within Bracket

      4. Percent of Load Criteria After Burndown

    6. Click Save.

  5. From PayIQ Admin, select the Configuration tab. Click the Execute Release Update button ONCE and wait for the email indicating completion. This process completes the following tasks.

    1. Relabels the following Calculation Tier Calculation Method picklist value.

      1. One-Time Payout at Target is relabeled to One-Time Payout at Target (Bonus).

Confirm all required TMS batch jobs are running and/or scheduled. See the Batch Processes article for suggested run times.

Winter ‘26 Field Modification Summary

Review fields added by the installation. Set CRUD access as needed.

Object

Field/Field Set

Action

Notes

Calculation Tier

Amount

Modify

Updated Help Text.

Calculation Tier

Calculation Method

Modify

Added 4 new picklist values.

Calculation Tier

Revoke Payout If Dipped Under Threshold

Add

Support for Bonus payments for running aggregates.