Skip to main content

Configuring ProcessingHub

ProcessingHub enables bulk processing in FinDock, from bulk collection runs to bank statement parsing. This is accomplished using FinDock ProcessingHub and ProcessingEngine, which is part of the Salesforce App Platform.


The procedure to connect the ProcessingHub to a Salesforce environment underwent a major change in the May ‘20 release. If you have an existing working connection, no additional actions are required to use the new configuration and connection flows. Please contact support if you run into any issues with connectivity on environments existing before this release.

Activate ProcessingHub in FinDock#

Before you can start the ProcessingHub configuration, you need to activate the package first.

To activate the ProcessingHub package:

  1. Launch the FinDock app and click the Setup tab.
  2. Click the Activate/Deactivate tab.
  3. Use the toggle in the STATUS column to activate ProcessingHub.

FinDock packages installed before the October 2019 release may use the name ‘StepOrange CPM’ or ‘PaymentHub.’

Connecting ProcessingHub and Salesforce#

To establish connections with Salesforce to and from ProcessingHub:

  1. Go to the Setup tab in the FinDock App in Salesforce.
  2. Click the ProcessingHub tile.
  3. Click the Connect tab and follow the instructions to connect the ProcessingHub.
    The user account used to connect with the ProcessingHub needs the following permission sets:
    • PaymentHub Integration Base
    • PaymentHub Operations
    • ProcessingHub Operations For more information about permissions, please see our Permissions article.
  4. Click Connect with ProcessingHub.
  5. If the user account is not yet logged in, you are prompted by Salesforce to enter the Integration User credentials.
  6. Once the account is authenticated, Salesforce asks you to grant FinDock access to your Salesforce environment. Click Allow.
  7. You are redirected back to the ProcessingHub Connect tab where you should see a Green bar saying the connection was set up successfully.
  8. Please confirm the correct user account was used for the connection. If it was the wrong account, disconnect the user and connect again with the correct account.

If for step 5 you logged in with a different (Integration) user than you have used for an ongoing FinDock setup, you get a Salesforce permission error when clicking the Back button. Please log in again with the initial user account or go to your homepage to browse Salesforce as usual.

Configure file exchanges#

Depending on the payment extensions you configure, the ProcessingHub might need to exchange files with FinDock through a Salesforce Chatter Group.

To set up a Chatter Group for file exchanges:

  1. Open the Salesforce App Launcher, search for “Groups” and click on the Groups search result.
  2. On the Groups page, click New.
  3. Enter a name such as “ProcessingHub File Exchange” (we use this name to refer to this group) and description.
  4. Scroll down to Access type and select “Private.” This limits access to group members and System Administrators. The files exchanged through this group may contain private information, therefore access should be limited.
  5. Click Save & Next to create the group.
  6. On the next page, search for the integration user you used for ProcessingHub and click Add to make it a member of this group.
  7. Add the other users that require access (usually finance staff).
  8. Click Done when you have added all users.

After the group is created, you need to instruct ProcessingHub to use this group for file exchanges.

To set up ProcessingHub file change to Chatter:

  1. Launch the FinDock app and click on the Setup tab.
  2. Click on the ProcessingHub tile to open up the ProcessingHub setup page.
  3. Click General Settings.
  4. In the Group Id drop-down list, select the ProcessingHub File Exchange Group you just created.

At this point you can also define other settings related to the ProcessingEngine.

  1. Set the Multiple Installment Handling to one of the provided settings, or if you are unsure, choose Manual Review.
  2. Set the Overpaid Installment Handling and Overpaid Installment Handling options as need, or if you are unsure, leave the defaults.
  3. Configure the Bulk API batch sizes and concurrency modes separately for Installment, Payment and Transaction objects if necessary. You can also specify the default batch size for other objects. If you are unsure, leave the default as is.
  4. Click Save to store the settings.

For more information on Multiple installment Handling and Overpaid Installment Handling, see Automated bank statement matching.

Disconnecting ProcessingHub#


FinDock requires a working ProcessingHub connection to function properly. Disconnecting a user should always be done with caution.


Disconnecting and reconnecting, even with the same user, causes FinDock to wipe all data associated with the Salesforce environment in ProcessingHub. A full data sync is performed before processes like Payment Schedules can be run. Especially for Salesforce environments with Large Data Volumes (LDV), this sync could take several hours or longer.

If you wish to disconnect the current user from the ProcessingHub:

  1. Launch the FinDock app and open the Setup tab.
  2. Click the ProcessingHub tile.
  3. Go to the Connect tab.
  4. Click the Disconnect user button.
  5. You are prompted to confirm the disconnection. Click Disconnect if you are certain you want to disconnect.

You are redirected back to the Connect tab, and ProcessingHub is disconnected.


If the connection with the ProcessingHub has been disconnected, please check the following:

  • Is the integration user still active?
  • Does the integration user have all the needed permission sets?

Deprecated components & connection process#

Several components that were part of the connection process before the May ‘20 release are no longer used by FinDock when you have set up a connection with the new process. This includes:

  • The RefreshTokenScheduleSchedule is no longer required to refresh access tokens. Token refresh is now handled automatically.
  • The following Remote site settings are replaced with a named credential, which is packaged and shipped with FinDock Core: