Installing FinDock packages

This article describes how to install FinDock packages in your Salesforce org. If the packages are already installed, you can skip this step and move on to Configuring FinDock Core. Installing FinDock packages can be done in two ways:

  • Using the FinDock Installer
  • Using an installation link provided to you (mainly for packages not available in the installer)

Before you start

Please make a list of all packages to be installed. This should include, for example:

  • FinDock Core (mandatory)
  • ProcessingHub (mandatory)
  • One or more payment extensions
  • One or more source connectors

Prerequisites

Before you can start installing FinDock packages, you need to have:

Using FinDock Installer

FinDock provides an Installer to guide you through the installation process. Installing FinDock packages is essentially the same as installing other AppExchange solutions. The Installer just saves time by allowing you to install all the needed packages at once.

To install packages using the FinDock Installer:

  1. Open the FinDock Installer in your browser.
  2. Select the environment (production or sandbox) for the installation.
    paymenthub_installer_login-1024x382
  3. Log in to the environment with your own credentials.
  4. Review the Organization analysis and click Continue if correct.
    paymenthub_installer_organization-analysis-1024x462
  5. Select the packages you need to install or want to update and click Continue. FinDock Core and ProcessingHub are mandatory and therefore selected by default.
    paymenthub_installer_select-packages-1024x527
  6. Read the installation information carefully and confirm you are ready with the checkboxes below, and then click Install.
    paymenthub_installer_review-1024x357
  7. Wait for the packages to be completely installed. Do not close the window while installing!!
    paymenthub_installer_installing-1024x282
  8. When packages are installed, the orange notification turns green to confirm everything is done.
    paymenthub_installer_confirmation-1024x317
  9. Log in to your Salesforce org and go to Setup > Installed Packages to verify the selected FinDock packages have been installed successfully.

Now you’re ready to start [configuring FinDock].(/configuring-findock-core.md)

Using installation links

Installing FinDock packages is essentially the same as installing other AppExchange solutions. Packages may have different prerequisites, but the overall installation process is the same.

Installing FinDock Core

Prerequisites

To install FinDock Core package:

  1. Click on the FinDock installation link provided to you.
  2. Select the intended user profile for the installation. We recommend installing for all users. If you chose another option, you need to manually add FinDock objects and fields to various profiles.
    package-installation-screen-300x194
  3. Click Install to start the installation.
  4. Click Done to complete the installation process.

You will receive an email when the installation is complete, after which the new package is shown on the Installed Packages page in your Salesforce org.

note

If you are unsure what profile option to choose, please have a look at Salesforce Help. Should you choose to install for specific profiles, ensure all profiles that have access to the source package can also access FinDock.

Installing ProcessingHub

Pre-requisites

  • FinDock Core successfully installed

To install the ProcessingHub package:

  1. Go to the AppExchange listing for ProcessingHub or click on the installation link provided to you.
  2. Select the 'Install for All Users' option.
  3. Click Install to start the installation.
  4. Click Done to complete the installation process.

You will receive an email when the installation is complete, after which the new package is shown on the Installed Packages page in your Salesforce org.

Installing source connectors

Not every FinDock implementation needs separate source connector packages. If you use FinDock Standalone, you can skip this step and continue with installing payment extensions.

Prerequisites

  • FinDock Core successfully installed
  • ProcessingHub successfully installed
  • Corresponding source app (e.g. Salesforce NPSP) successfully installed

To install source connector package(s):

  1. Go to the AppExchange listing for the chosen source connector or click on the installation link provided to you.
  2. Select the 'Install for All Users' option. We recommend installing for all users. If you chose another option, you need to manually add FinDock objects and fields to various profiles.
  3. Click Install to start the installation.
  4. Click Done to complete the installation process.

You will receive an email when the installation is complete, after which the new package is shown on the Installed Packages page in your Salesforce org.

note

If you are unsure what profile option to choose, please have a look at Salesforce Help. Should you choose to install for specific profiles, ensure all profiles that have access to the source app can also access FinDock Core and the source connector.

Installing payment extensions

Prerequisites

  • FinDock Core successfully installed
  • ProcessingHub successfully installed

To install payment extension package(s):

  1. Go to the AppExchange listing for the chosen payment extension or click on the installation link provided to you.
  2. Select the 'Install for All Users' option. We recommend installing for all users. If you chose another option, you need to manually add FinDock objects and fields to various profiles.
  3. Click Install to start the installation.
  4. Click Done to complete the installation process.

You will receive an email when the installation is complete, after which the new package is shown on the Installed Packages page in your Salesforce org.

note

If you are unsure what profile option to choose, please have a look at Salesforce Help. Should you choose to install for specific profiles, ensure all profiles that have access to FinDock Core can also access the payment extension.