Plaid Integration

How does Cybrid integrate with Plaid?

Overview

Plaid lets customers link their bank accounts to financial institutions. Plaid handles the integration with banks across North America, giving customers access to:

  • Bank account information (PII)
  • Balance checking
  • Debits and credits

Cybrid integrates Plaid into the embedded experience to simplify customer onboarding and bank account connection. Partners can leverage Cybrid's Plaid integration to enable end-customers to connect their bank accounts and deposit or withdraw fiat currency on the Cybrid Platform.

⚠️

Instant Verification (Instant Auth) not supported

Cybrid's Plaid integration does NOT support Plaid's Instant Verification (Instant Auth) feature. Only the standard Plaid Link flow is supported. Account ownership is confirmed by matching the bank account holder name to the customer's KYC name.

From API version 2026-09-01, this match runs while the external bank account is created. If the match is inconclusive (such as a first name provided as an initial), the account stays pending while the customer completes a Persona inquiry, where they can upload a bank statement. When the customer completes the inquiry, the account moves to reviewing, then ends completed, failed with ownership_mismatch, or expired if the verification lapses. Do not create a type: bank_account identity verification for these accounts; the request returns 422 with deprecated.

On earlier API versions, an additional bank account identity verification is required after the customer links their bank account. Accounts may remain unverified if this verification is not completed, if there is a name mismatch, if the user does not upload requested documents (like a bank statement), or if the verification expires. To resolve this, ensure the identity verification is triggered after linking and guide users to complete any required document uploads.

How it works

Connect customer bank accounts and drive deposits and withdrawals on the Cybrid Platform using Plaid Link with Cybrid: initiate the Plaid process via the /api/workflows endpoint, then drive the user experience with the Plaid Link SDK. This gives you control over the user experience and integration at the app level, using Cybrid's Plaid account.

For step-by-step instructions, see Add Customer External Bank Accounts.

⚠️

FBO account limitations

If a bank account is opened for a customer via Cybrid (such as an FBO account), the customer cannot be provided with online banking credentials to link that account to other platforms via Plaid. Only accounts where the customer has their own online banking access can be linked via Plaid Link.

ℹ️

Data-sharing consent screens

During Plaid Link, Plaid or the customer's financial institution may show a data-sharing consent screen that lists categories such as credit limits, loans, or investments. Cybrid does not control the content of these screens. Cybrid's Plaid Link sessions are limited to checking and savings accounts and do not request credit, loan, or investment data.

Integration lifecycle

A typical Plaid integration on the Cybrid Platform follows this sequence:

  1. Link the customer's bank account with Plaid Link. See Add Customer External Bank Accounts.
  2. Verify ownership of the linked bank account against the customer's KYC information. See Verify External Bank Accounts.
  3. Refresh the connection when Plaid expires it and the account enters the refresh_required state. See Refresh External Bank Accounts.

Next steps

Related resources


Did this page help you?