Set up your Plaid integration

Before you can access your customers' banking data from any banks supported by Plaid, you need to set up your integration. You'll need to:

  • Create your Plaid account, and test with the sandbox environment.
  • Request access to the Plaid production environment and get your secure credentials.
  • Request access to the Codat Portal.
  • Add your secure credentials to the Codat Portal.
  • Enable your Plaid integration.

📘

Plaid account details

  • If you already have a Plaid account, have your account details to hand.

  • If you don't, create an account before you start your set up.

Configuring your Plaid Application

  1. Go to Plaid's Website, choose "Get API Keys", and log in if required.
  2. On the welcome page, choose "Team Settings -> API" from the top menu bar
  3. On the "Allowed redirect URIs", choose the configure option. You will need to enter https://plaid.codat.io/oauth/callback. You may be prompted for your password when you save.
  4. On the left hand menu select the "Keys" page.
  5. Make a note of your Sandbox and Development Keys, and your Client ID.

Add your secure credentials to the Codat portal

  1. Log in to the Codat Portal.

  2. In the left panel, click Integrations > Banking.

  3. Click Manage next to the Plaid integration. The Plaid Credentials page is displayed.

  4. Select One-off or Continuous to choose what type of access to company data the integration will have.

  5. Locate the secure keys that you retrieved earlier and enter the following values:

    • client_id value into Client ID.
    • Sandbox secret value into Sandbox Secret.
    • Development secret value into Development Secret.
  6. From the Environment list, select Sandbox.

  7. Enter country codes for the countries that you operate in, and want to allow your customers to link from. This filters the list of banks in the Link authorization flow to only banks in the selected countries, which might improve your conversion rate. Enter a comma-separated list of one or more of the following codes:

  • US
  • CA
  • ES
  • FR
  • GB
  • IE
  • NL

If no country codes are entered then all the above country codes are used by default. In the Plaid Sandbox and Development environments the default values are also US,CA,ES,FR,GB,IE,NL.

  1. Click Save.

  2. Return to Integrations > Banking.

  3. Click the toggle next to Plaid to set the integration to Enabled.

Customizing the Plaid Link Journey (optional)

Plaid allows you to customise the look, feel and content of the link site that customers see when they authorize your connection to their banking data. This is the customer journey you'll follow during testing.

  1. Still on the Plaid website, from the top menu, select Customize.
    A new page is displayed with the options for the link site that you can customise in the left pane. On the right, there's a preview pane where you can see the immediate effect of any changes you've made before you publish them. See Plaid link customization for descriptions of what each option does.
  2. To update an option you're interested in, select it in the left pane.
    The customisable elements are displayed so that you can update them. Any changes you make are immediately displayed in the preview pane.
  3. When you're happy with your changes, select Publish changes, and then at the top of the left pane, select GO BACK > to return to the main options menu.
  4. Continue until you're happy with your updates.

Enabling Production Access

When you are ready to connect to live data, you will need to request access from Plaid.

  1. Go to https://dashboard.plaid.com and log in.
  2. Select Migrate to Production and follow the process to request access to the Plaid production environment, and to get your secure credentials.
  3. Once you have your Production Secret, enter it on the box for the Production Secret within the Plaid configuration page in the Codat Portal.
  4. Please note that the Country Codes default value in Plaid's Production environment is the following: US,CA

Did this page help you?