Plaid Integration

​

Prerequisites

• Access to dashboard.herondata.io and via your username and password, and also an api_key to call our API.
• A working Plaid Link implementation including storing item_ids and access_tokens in your system.
• A unique identifier for each of your customers (which can have many Plaid connections) that you can send to us. We call this the end_user_id.

​

Integration steps

1. Log in to dashboard.herondata.io
2. Go to Settings on the sidebar menu then scroll to the Integrations section.
3. Select “Plaid” as an integration type and give your integration a meaningful name.
4. Go to your Plaid dashboard (https://dashboard.plaid.com/team/keys) and copy over the client_id and secret. :::note Ensure the secret is for the environment (Development, Sandbox, Production) you intend to use :::
5. Enter the Plaid keys from above into the Heron Dashboard, and then submit the form.
6. Once created you will see your integration in a table. Click View to get the webhook URL and link URL which you will need in the next steps.
7. In your code, set the webhook parameter of /link/token/create to the webhook URL. (Alternatively, if you want to keep your webhook handling, forward all Plaid incoming webhooks including headers to the webhook URL)
8. New Requirement: When creating a link token with the /link/token/create endpoint, you must now include the transactions.days_requested field to specify the desired historical transaction length. The default is 90 days, but you should now set the transaction.days_requested field to 730 days.
9. In your code, after calling /item/public_token/exchange send the resulting Plaid item_id and access_token, along with your end_user_id as a POST request to the link URL, documented here.

​

Final result