Skip to main content
Layer uses Plaid to connect to your customers’ accounts at external financial institutions. Once an account is connected, Layer ingests its transactions and balances and incorporates them into the customer’s books. There are two ways to connect Plaid accounts, depending on whether your platform already has a Plaid integration:
  • Use Layer’s Plaid connection - Layer manages the Plaid relationship on your behalf. Best if you don’t already integrate with Plaid.
  • Use your own Plaid connection - Keep your existing Plaid relationship and grant Layer access to the data.

​
Use Layer’s Plaid connection

Your customers link their accounts through a Layer-powered flow, and Layer handles credential management, connection health, and data ingestion. You can present the linking flow in two ways:

Embedded components

Drop Layer’s prebuilt, white-labeled account linking component into your app.

Custom Plaid Link UI

Build your own account linking experience on top of Plaid Link, powered by Layer’s Plaid connection.
Both options grant Layer read-only access to the customer’s bank account and credit card activity. Once accounts are connected, transactions begin flowing into Layer automatically.

​
Use your own Plaid connection

If your platform already integrates with Plaid, you don’t need to ask customers to link their accounts again. Grant Layer access to your existing Plaid data using processor tokens.
1

Create a processor token

Link a customer’s bank account with Plaid as usual, obtaining an access_token. Then create a processor token for each account via Plaid’s /processor/token/create endpoint, specifying layer as the processor.
Request
2

Attach the tokens to a business

Pass the processor tokens when creating a business, or update an existing business with them. Layer begins ingesting data from the associated accounts immediately.
Request
Updates replace the full list of processor tokens on the business. Include every token you want associated, since any existing tokens omitted from the request are removed.
If a Plaid account’s access token changes, its processor tokens are invalidated. Create a new processor token and update the business with the refreshed list. To see which processor tokens are currently associated with a business, call List Plaid Accounts. For the full walkthrough, see the bank data guide.