Plaid Module

Updated on 04 Dec 2023
8 Minutes to read

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

Overview

Module Details
Core or Github Module	Decisions.Plaid
Restart Required	No
Steps Exposed	Yes
Step Location	Integrations > Plaid
Settings Location	Settings > Plaid Settings

The Plaid module facilitates seamless integration with Plaid services, enabling users to securely authenticate bank accounts, retrieve account details, and perform financial transactions within workflows. Ensure you have the credentials and permissions from Plaid to establish a secure connection and access banking information effectively. For detailed information, refer to Plaid's official documentation or support resources tailored to the use case.

Prerequisites

Create a Plaid Account

Sign up for a Plaid account.
Access the Plaid Dashboard to manage applications, obtain API keys, and configure settings.

Choose a Product and Obtain API Keys

Select Plaid products suitable for the project needs (e.g., Transactions, Auth, Identity).
Obtain the unique Client ID and Secret keys for the desired environment.

Configuration

In Decisions, install the Plaid Module.
Navigate to Settings > Plaid Settings.
Set the Base URL; Plaid has three different environments (Sandbox, Development, Production).
- Sandbox: https://sandbox.plaid.com
- Development: https://development.plaid.com
- Production: https://production.plaid.com

Steps Available

Explore Plaid's comprehensive functionality through various steps available in the module:

Step Name	Description
Get Accounts	Retrieve a list of accounts associated with any linked Item. Plaid will only return active bank accounts — accounts that are not closed and capable of carrying a balance.
Get Accounts Balance	Returns the real-time balance for each of an Item's accounts.
Get Application	Retrieve information about a specific application within the Plaid integration.
List Applications	Retrieve a list of applications available in Plaid.
Update Application Scopes	Modify or update the scopes associated with a particular application in the Plaid integration.
Create Asset Report	Initiates creating an Asset Report, which can then be retrieved by passing the asset_report_token return value to the /asset_report/get or /asset_report/pdf/get endpoints.
Create Asset Report Audit Copy	Create an audit copy of the asset report in Plaid.
Filter Asset Report	Apply filters to refine the content of the asset report.
Get Asset Report	Retrieves the Asset Report in JSON format. Before calling /asset_report/get, you must first create the Asset Report using /asset_report/create (or filter an Asset Report using /asset_report/filter) and then wait for the PRODUCT_READY webhook to fire, indicating that the Report is ready to be retrieved.
Get Asset Report Audit Copy	Retrieve an audit copy of the asset report Plaid.
Get Asset Report PDF	Obtain the asset report in PDF format.
Refresh Asset Report	Create a new Asset Report based on the old one but with the most recent data available.
Remove Asset Report	Remove an Asset Report. Removing an Asset Report invalidates its asset_report_token, meaning you will no longer be able to use it to access Report data or create new Audit Copies.
Remove Asset Report Audit Copy	Remove an Audit Copy. Removing an Audit Copy invalidates the audit_copy_token associated with it, meaning you and any third parties holding the token can no longer access Report data.
Get Auth Data	Retrieve authentication-related data from Plaid.
Cancel Bank Transfer	Cancel a bank transfer transaction.
Create Bank Transfer	Initiate the creation of a bank transfer.
Get Bank Transfer	Fetches information about the transfer corresponding to the given transfer_id.
Get Bank Transfer Balance	Retrieve the balance related to a bank transfer.
Get Sweep	Fetches a sweep corresponding to the given sweep_id.
List Bank Transfer Events	Get a list of Plaid-initiated ACH or bank transfer events based on specified filter criteria.
List Bank Transfers	See a list of all transfers and their statuses.
List Sweeps	Fetches sweeps matching the given filters.
Migrate Account into Bank Transfers	Migrate known account and routing numbers to Plaid Items.
Sync Bank Transfer Events	Request up to the next 25 Plaid-initiated bank transfer events after a specific event_id.
Get Categories	Get detailed information on categories returned by Plaid. This endpoint does not require authentication.
Create Deposit Switch	Initiates the process of creating a deposit switch.
Create Deposit Switch Token	Generates a token required for creating a deposit switch.
Create Non-Plaid Deposit Switch	Similar to the "Create Deposit Switch" step but specifically designed for creating a deposit switch involving non-Plaid entities or systems.
Get Deposit Switch	Retrieves information or details about a previously created deposit switch.
Find Employer	Information about an employer associated with an account.
Get Employment Verification	Returns a list of items with employment information from a user's payroll provider verified by an end user.
Get Identity	Retrieve various account holder information on file with the financial institution, including names, emails, phone numbers, and addresses. Only name data is guaranteed to be returned; other fields will be empty arrays if not provided by the institution.
Create Income Verification	Create a new Identity Verification for the user specified by the client_user_id field.
Get Income Verification (Paystubs)	Gets payroll income information for a specific user, either as a result of the user connecting to their payroll provider or uploading a pay-related document.
Get Income Verification (Tax forms)	Gets payroll income information for a specific user, either as a result of the user connecting to their payroll provider or uploading a pay-related document.
Get Income Verification Summary	Retrieve a previously created identity verification.
Get Original Documentation	Retrieve original documentation or records associated with a specific transaction, account, or financial action.
Income Verification Precheck
Refresh Income Verification	Allow a customer to retry their identity verification.
Find Institutions	Returns a JSON response containing details for institutions that match the query parameters, up to a maximum of ten institutions per query.
Get Institution by Id	Returns a JSON response containing details on a specified financial institution currently supported by Plaid.
Get Institutions	Returns a JSON response containing details on all financial institutions currently supported by Plaid. Because Plaid supports thousands of institutions, results are paginated.
Get Investment Holdings	Receive user-authorized stock position data for investment-type accounts.
Get Investment Transactions	Retrieve up to 24 months of user-authorized transaction data for investment accounts.
Create Public Token	Create a valid public_token for an arbitrary institution ID, initial products, and test credentials.
Exchange Public Token For access_token	Exchange a Link public_token for an API access_token. Link hands off the public_token client-side via the onSuccess callback once a user has created an Item. The public_token is ephemeral and expires after 30 minutes. An access_token does not expire but can be revoked using the Remove Item step.
Get Item	Returns information about the status of an Item.
Import Item
Invalidate access_token	Rotate the access_token associated with an Item. The endpoint returns a new access_token and immediately invalidates the previous access_token.
Remove Item	Remove an Item. Once removed, the access_token, as well as any processor tokens or bank account tokens associated with the Item, is no longer valid and cannot be used to access any data that was associated with the Item.
Update Item Webhook	Update the webhook URL associated with an Item. This request triggers a WEBHOOK_UPDATE_ACKNOWLEDGED webhook to the newly specified webhook URL.
Get Liabilities	Returns various details about an Item with loan or credit accounts. Liabilities data is available primarily for US financial institutions, with some limited coverage of Canadian institutions.
Create Link Token	Creates a link_token, which is required as a parameter when initializing Link. Once Link has been initialized, it returns a public_token, which can then be exchanged for an access_token
Get Link Token	Gets information about a previously-created link_token using the /link/token/create endpoint.
Create Payment	After creating a payment recipient, use this step to create a payment to that recipient.
Create Payment Recipient	Create a payment recipient for payment initiation. The recipient must be in Europe, within a country that is a member of the Single Euro Payment Area (SEPA) or a non-Eurozone country supported by Plaid. For payments in the US, see the Transfer steps.
Create Payment Token
Get Payment Details	Check the payment status and receive basic information such as recipient and payment amount.
Get Payment Recipient	Get details about a payment recipient previously created.
List Payment Recipients	List the payment recipients previously created.
List Payments	Retrieve all created payments. By default, the 10 most recent payments are returned. You can request more payments and paginate through the results using the optional count and cursor parameters.
Reverse Payment	Reverse a settled payment from a Plaid virtual account. The original payment must be in a settled state to be refunded.
Create Apex Bank Account Token	Used to create a token suitable for sending to Apex to enable Plaid-Stripe integrations.
Create Bank Transfer as Processor
Create Processor Token	Used to create a token suitable for sending to one of Plaid's partners to enable integrations.
Create Stripe Bank Account Token	Used to create a token suitable for sending to Stripe to enable Plaid-Stripe integrations.
Get Auth Data	Used to get a processor token's product permissions. The products field will be an empty list if the processor can access all available products.
Get Balance Data	Returns the real-time balance for each of an Item's accounts.
Retrieve Identity Data	Retrieve various account holder information on file with the financial institution, including names, emails, phone numbers, and addresses.
Create Test Item	Create a valid public_token for an arbitrary institution ID, initial products, and test credentials. The created public_token maps to a new Sandbox Item.
Create Test Item and Processor Token	Create a valid processor_token for an arbitrary institution ID and test credentials. The created processor_token corresponds to a new Sandbox Item.
Fire Test Webhook	Test that the code correctly handles webhooks.
Force Sandbox Item into Error State	Forces an Item into an ITEM_LOGIN_REQUIRED state in order to simulate an Item whose login is no longer valid. This makes it easy to test Link's update mode flow in the Sandbox environment.
Manually Fire Bank Transfer Webhook	Manually trigger a TRANSFER_EVENTS_UPDATE webhook in the Sandbox environment.
Manually Fire Income Webhook	Manually trigger a Payroll or Document Income webhook in the Sandbox environment.
Save Selected Accounts for Platypus OAuth
Set Verification Status for Sandbox Account	Change the verification status of an Item in in the Sandbox in order to simulate the Automated Micro-deposit flow.
Simulate Bank Transfer Event in Sandbox
Simulate Transfer Event in Sandbox	Simulate a transfer event in the Sandbox environment. Note that while an event will be simulated and appear, no transactions will occur, and funds will not move between accounts, even within the Sandbox.
Evaluate Planned ACH Transaction	Evaluate a planned ACH transaction to get a return risk assessment (such as a risk score and risk tier) and additional risk signals.
Report ACH Transaction Initiation	Report whether you initiated an ACH transaction.
Report ACH Transaction Return	Report a returned transaction previously sent to the Evaluate Planned ACH Transaction endpoint.
Get Incremental Transaction Updates on Item	Subscribe to all transactions associated with an Item and get updates synchronously.
Get Recurring Transaction Streams	Receive a summary of the recurring outflow and inflow streams (expenses and deposits) from a user’s checking, savings, or credit card accounts. Additionally, Plaid provides key insights about each recurring stream, including the category, merchant, last amount, and more.
Get Transaction Data	Receive user-authorized transaction data for credit, depository, and some loan-type accounts (only those with account subtype student; coverage may be limited).
Refresh Transaction Data	Initiates an on-demand extraction to fetch the newest transactions for an Item.
Cancel Transfer	Cancel a transfer. A transfer is eligible for cancellation if the cancellable property is true.
Create Transfer	Initiate a new transfer.
Create Transfer Authorization	Authorize a transfer. This endpoint must be called prior to calling Create Transfer.
Get Transfer	Fetches information about the transfer corresponding to the given transfer_id.
List Transfer Events	Get a list of transfer events based on specified filter criteria.
List Transfers	List of all transfers and their statuses. Results are paginated; the count and offset query parameters retrieve the desired transfers.
Sync Transfer Events	Request up to the next 25 transfer events after a specific event_id.
Get Webhook Verification Key	Retrieve the verification key used for webhook endpoints. This verification key is used to verify the integrity and origin of the data received via webhooks, enhancing the overall security of your integration by confirming the authenticity of incoming Plaid webhook notifications.