Setup Plaid

Before you can access banking data from Plaid, you need to set up a Plaid integration in the Railz Dashboard™. You'll need to:

  1. Retrieve your Plaid API keys.
  2. Add your API keys to Railz and enable integration.
  3. Customize your Plaid Link flow (optional).
  4. Enable US OAuth Institutions (Optional).


Using Live Banking Data for Testing

We recommend that you start by using Plaid's sandbox API keys to test your integration in our sandbox. Plaid's sandbox gives you access to sample banking data to test your flow through Railz Connect™.

Once you are ready to go production, you can use Plaid's development environment for testing in our sandbox, which allows you to connect to your own live bank accounts and transactions. See Plaid environments below for more details.


Plaid Account

You will need a Plaid account before proceeding with the steps below. If you already have a Plaid account, have your account details at hand. If you don't, create an account before you start your setup.

Retrieve your Plaid API Keys

  1. Go to and log in.
  2. Once logged in, from the top menu bar, select Developers > Keys. The Keys page is displayed showing the API keys you need for setup:
  • client_id
  • Production secret
  • Sandbox secret
  • Development secret

Plaid API keys page. Click to Expand.


Production Keys

If you have access to Plaid's production environment, the Keys page will show you the Production secret as well.

Add your Secure Keys to Railz and Enable Integration

  1. Open the Railz Dashboard™ and log in.
  2. In the left sidebar navigation menu, go to Integrations > Banking.
  3. Scroll down to the Plaid integration and click Configure.
Railz Banking Integrations. Click to Expand.

Banking integrations page in Railz Dashboard. Click to Expand.

  1. Find the API keys you retrieved in the previous step above and paste in your Client ID and Client Secret.
  2. For testing development or sandbox, you will need to select the Application Key Type you have the option of choosing between Sandbox and Development. Select Sandbox, then click Save & Enable
Railz Manage Banking Integration. Click to Expand.

Configure the Plaid integration modal. Click to Expand.

Customize Plaid Link (Optional)

Plaid allows you to customize the look, feel and content of Plaid Link that your business customers see when they authorize you to access their banking data. This is the customer journey you'll follow during testing.

  1. Go to and log in. From the top menu, select Customize.
  2. The Plaid Customize page will load with a left pane to customize Plaid link and a right live preview pane. See Plaid Link customization for more details.
  3. Once you are done customizing your Plaid link, select Publish and your new changes will go into effect.
  4. Decide the name you want your SMBs to see when connecting their banking information through Plaid by going to the Railz Dashboard > Account > Company page.
    1. Ensure the Company Name listed in the Railz Dashboard is what you want your SMBs to see
Configure the Plaid integration modal. Click to Expand.

Configure the Plaid integration modal. Click to Expand.

Configure the Plaid integration modal. Click to Expand.

Configure the Plaid integration modal. Click to Expand.

Configure Bank Assets

We have added a new endpoint, Bank Assets (Banking). In order to obtain data from your customers, you need to grant us access to retrieved assets for a period of 60 days. If you do not grant permission, we will not retrieve the assets. To enable access go to:

  1. Login to the dashboard
  2. Go to the Integrations > Banking Page
  3. Click Configure and enable the scope permissions to assets

Configure Plaid Link to connect to Institutions via OAuth (Optional)

Plaid requires OAuth for all financial institution integrations they connect to through data sharing agreements. To enable these institutions through Plaid Link for your business users to connect to:

  1. Go to and log in with your account.
  2. Complete the OAuth Guidelines and registration requirements
  3. From the top menu, select Team Settings and select OAuth institutions from the side navigation and enable the institutions you want your business users to connect their banking data to.