Bank Connect

Admin Guide

Note: We will be creating a Public site to receive all the web hooks from the Plaid. Since it will be an external User, Please make sure that the external profiles does not have access to any Object or Field permissions. 

Note : Check the Webhook URL in the Postman(Application) for every Environment Before Entering the Webhook URL in plaid Credentials.

1. Introduction

BankConnect (in the Salesforce + Plaid integration world) is essentially a connector product that lets your Salesforce org securely link to customers’ bank accounts to retrieve financial data, verify account ownership, and perform related actions — all without manually exchanging bank statements or sensitive credentials.

Click here to discover the full range of features offered by the Bank Connect.


2. Intended Users

  • Salesforce Admins – Responsible for setup and configuration.

  • End Users – Business users who make verification requests.

  • Developers – Those integrating with external systems.


3. Prerequisites

System Requirements

Salesforce Professional, Enterprise, Unlimited, or Developer Edition

User Roles & Permissions

Admin Access – Required for installation and configuration


4. Installation

4.1 Using Salesforce AppExchange
  1. Go to Salesforce AppExchange

  2. Search for Bank Connect

  3. Click "Get It Now" and select the Salesforce environment (Production or Sandbox)

  4. Follow the on-screen prompts to install the package

  5. Assign user permissions during the installation process


4.2 Using Direct Package Link
  1. Reach out to support@cloudmaveninc.com for the latest managed package link.

  2. Follow the on-screen prompts to install the package

  3. Assign user permissions during the installation process


5. Post-Installation Setup

Complete the post-installation setup to ensure seamless application functionality.

5.1 Assign the Required Permission Set

  1. Navigate to Setup.

  2. Use the Quick Find box to search for "Permission Set".

  3. Locate the "Cloud Maven - Bank Connect" permission set from the list.

  4. Click on "Manage Assignments".

  5. Assign the permission set to the relevant users.

image-20250602-145629.png

5.2 Create a Salesforce Site

A Salesforce Site is required to securely expose specific Salesforce data and functionality through a custom web interface. It grants limited access to Site Guest Users, allowing them only to view or edit permitted data and complete actions such as signing documents electronically.

  1. Navigate to Setup.

  2. Use the Quick Find box to search for "Site".

  3. Click "New" to create a Salesforce Site.

  4. Enter all required details as depicted in the provided image.

  5. Click "Save".

Screenshot 2020-10-15 at 2.38.27 PM.png

5.3 Grant Required Access to the Site Guest User

Navigate to Site Guest User Profile.

image-20250602-151450.png

5.4 Provide access to the following Apex Classes

  1. Open the Profile of the Site Guest User.

  2. Assign access to the following Apex Classes:

    • bankconnect.WSProductService

    • bankconnect.PlaidCallbackService

    • bankconnect.BankVerificationController

    • bankconnect.PlaidTransactionsCallBackService

14.jpg

5.5 Grant Access to Required Visualforce Pages

  1. Stay in the Site Guest User Profile.

  2. Provide access to the following Visualforce pages:

    • bankconnect.VerifyBankConnect


5.6 Configure Lightning Action button on the Page Layout

Required only for objects other than Contact or Lead, since the Lightning actions for these two objects are provided by the managed package.

  1. Navigate to Setup.

  2. Click on “Object manager”.

  3. Navigate to the parent object from which you want to initiate the Bank Verification request.

  4. Click on Button Links and Actions.

  5. Click on New Action

Screenshot 2020-08-06 at 7.13.09 PM.png
  1. Select and Populate the fields with below Values.

    • Action Type - Lightning Component.

    • Lightning Component - bankconnect: BankVerificationRequest_Aura

    • Height - 400px

    • Standard Label Type - None

    • Label - Bank Verification Request.

    • Name - Bank Verification Request.

Update the Page Layout

  1. From the Left Panel, Click on Page Layouts

  2. Select the Page Layout where you want to place the Request button

  3. Click on Mobile & Lightning. Actions.

  4. Search for Bank Verification in Quick Find.

Screenshot 2020-08-06 at 7.22.42 PM.png
  1. Click on the Related List Section of the Page Layout.

  2. In Quick Find search for Bank Verification and Add it to the Related Section

Screenshot 2020-08-06 at 7.24.47 PM.png
  1. Select the fields for the List View. For example you can select the below fields:

    1. Consumer Name

    2. Email

    3. Plaid Products

    4. Status

    5. Created Date

    6. Total Bank Account

    7. Total Available Balance

  2. Click Save.


5.7 Configure Plaid Credentials

Set up Plaid Credentials & Features via Script

Please contact the Support Group team to get your Plaid Credentials.


5.8 Set Remote Site Settings

If the Identity Verification product is enabled, make sure to add the following two Remote Site Settings for each environment.

  1. Go to Setup in Salesforce.

  2. In the Quick Find box, search for Remote Site Settings.

  3. Click New Remote Site.

Sandbox:

  1. Provide the name in the format Identity_Sandbox

  2. Add the Remote Site URL : https://documentary-assets-production-sandbox-cognito-us-west-2.s3.us-west-2.amazonaws.com

  3. Check the Active checkbox.

  4. Click Save.

Production:

  1. Provide the name in the format Identity_Live

  2. Add the Remote Site URL : https://documentary-assets-production-live-cognito-us-west-2.s3.us-west-2.amazonaws.com

  3. Check the Active checkbox.

  4. Click Save.


5.9 Add the Cloud Maven Statistics LWC on the Parent Record Page

Ensure the feature is enabled in the Plaid Credentials; otherwise, the component will display an error message. Please note that the component will show data only for Assets product

  1. Navigate to the record page → Click the ⚙️ Gear icon → Select Edit Page.

image-20250305-111839.png
  1. In the Component Search box, search for customPlaidAnalytics.

  2. Then, drag and drop the Lightning Web Component (LWC) to your desired location on the page layout.

  3. Click Save in the top right corner. If this is a new layout or not yet activated, click Activate.


5.10 Configure Classic Email Template

Configure Classic Email Template

5.11 Configure Email Templates

  1. Go to setup and search Custom Settings

  2. Click Manage on Plaid Common Settings.

  3. If exist then edit plaidTemplateName and set the template name as the value. If it is not Click New and create the setting with plaidTemplateName label.


5.12 Create an Authentication URL field

  1. Create a Formula field for the URL that is sent out in an email(On Bank Verification Object).

  2. In Formula Field add below formula and make changes to the formula accordingly.

  3. Copy the URL of the site.

  4. Paste the site URL till force.com.

  5. Formula - HYPERLINK("https://cloudmaven-merchantone-apply.cs78.force.com/bankConnect/?bankconnect__plaidId=" + bankconnect__Encrypted_Record_Id__c , "Authentication URL")


5.13 Add Parent Record mapping

  1. Click on the Gear Icon ⚙️ and go to setup..

  2. In the quick find box search for custom settings.

  3. Search for Plaid Request Field Mapping custom settings.

  4. Click Manage

Screenshot 2020-08-06 at 7.03.24 PM.png
  • Update the Field Mapping with your Source Object Fields.

  • Here we have taken Contact as our source Object we can choose any Standard or Custom Object as our Source Object.

Screenshot 2020-08-06 at 7.07.12 PM.png

5.14 Setup Webhook for Identity verification

  1. Access the Plaid Dashboard

    1. Log in to your Plaid account and select Platform->Developers-> Webhooks from the left sidebar.

  2. Click on New Webhook

Screenshot 2025-08-08 at 1.42.49 PM.png
  1. Select the Event: Identity verification status updated

  2. Add the Webhook URL as below:

https://{site Domain}/services/apexrest/bankconnect/Plaid_Callback?


5.15: Configure Account Section in the Plaid portal

The following Link configuration options are commonly used with Auth:

  • Account select: The "Account Select: Enabled for one account" setting configures the Link UI so that the end user may only select a single account. If you are not using this setting, you will need to build your own UI to let your end user select which linked account they want to use to send or receive funds.

5.16: Configure access for Community User

If a component needs to be accessible to a Community User, the relevant Custom Setting must be updated.

Steps:

  1. Go to SetupCustom SettingsPlaid Common Settings.

  2. Create a new entry for GuestUsers.

  3. In the Value field, enter the UserType(s) that will have access to the component.

    • The entry should always begin with Guest, followed by the Community UserType(s), separated by commas.

Example:
If the Community UserType is CspLitePortal, the entry should be: Guest,CspLitePortal

This ensures that both Guest Users and the specified Community UserType can access the component seamlessly.


5.17: Enable multiple bank authentication in the same requests

Please run the below script to enable multiple bank verification in the Developer Console:

bankconnect.AdminServices.enableMultipleBankFeature( environemnt, true);

Here environment can be either ‘Sandbox’ or ‘Production’


🎉 Congratulations! Your application setup is now complete.




6. How to create Identity Template in the Plaid Portal

How to create Identity Template in the Plaid Portal



7. How to Add a CM Representative to Plaid Account

How to Add a Cloud Maven Representative to your Plaid Account



8. Setup Bank Connect via Custom Portal

Steps to Setup BankConnect via Custom Portal



9. Resend Bank Verification Request to the Customer

Setups to Resend Bank Verification requests if account disconnects



10. How to Setup Product Sequencing

How to Setup Product Sequencing



11. How to Enable Multiple Email Templates

How to Enable Multiple Email Templates