React Native SDK for Plaid Link, built on Expo Modules for the v13 native architecture. The SDK supports Expo apps and bare React Native apps through the same session-based JavaScript API.
- Documentation for the latest stable release
- Documentation for the main branch
- Plaid Link documentation
- Guidance for AI coding agents
- React Native 0.76 or newer
- Expo 52 or newer, or bare React Native with Expo Modules installed
- A development build, custom native build, or bare native app
Expo Go is not supported because Plaid Link includes custom native code. Expo apps should use a development build or another app build that includes this native module.
- iOS 15.1 or newer
- Xcode 16.1 or newer
- CocoaPods for installing native dependencies
- Android Studio 4.0 or newer
- Kotlin 1.9.25 or newer for Kotlin integrations
- A package name registered in the Plaid Dashboard for Android OAuth flows
The SDK supports React Native 0.76 or newer and Expo 52 or newer. Expo support requires a development build, custom native build, or bare native app; Expo Go is not supported.
| Lane | React Native | Expo | CI coverage |
|---|---|---|---|
| Minimum supported | 0.76 | 52 | Peer install and package export smoke test |
| Current example | 0.83 | 55 | Peer install and package export smoke test, Android unit tests, iOS simulator build |
| Latest Expo | 0.85 | 56 | Packed SDK install and iOS prebuild smoke test |
The root package unit tests run against the repository's development dependencies, while the example app validates the current native integration on both platforms.
Install the package in an Expo project, then run the app in a development build or another custom native runtime.
npm install react-native-plaid-link-sdkIf you are adding the SDK to an existing Expo app, rebuild the native app after installation so the Plaid native module is included.
Bare React Native apps must install and configure the expo package before
using this SDK.
npm install react-native-plaid-link-sdk expo
npx pod-installFollow Expo's guide for installing Expo Modules in an existing React Native app if your bare app does not already use Expo Modules.
Configure the native app identifiers that your app will use with Link:
- Android package names
- iOS bundle identifiers
- OAuth redirect URIs for every environment your app supports
The link token passed to this SDK must be created by your server with the Link configuration for the flow you want to launch. Do not create link tokens in the mobile app.
Create a Link session with a link token, then open it from your UI.
import { createPlaidLinkSession } from "react-native-plaid-link-sdk";
const session = await createPlaidLinkSession({
token: "#GENERATED_LINK_TOKEN#",
onSuccess: (success) => {
console.log("Success", success);
},
onExit: (exit) => {
console.log("Exit", exit);
},
onEvent: (event) => {
console.log("Event", event);
},
onLoad: () => {
console.log("Link loaded");
},
});
await session.open();Pass true to session.open(true) to request full-screen presentation on iOS.
The default presentation is used when this argument is omitted or false.
Identity Verification sessions use a dedicated creation function because IDV
flows do not emit the Link onLoad callback.
import { createPlaidIdentityVerificationSession } from "react-native-plaid-link-sdk";
const session = await createPlaidIdentityVerificationSession({
token: "#GENERATED_IDENTITY_VERIFICATION_LINK_TOKEN#",
onSuccess: (success) => {
console.log("Success", success);
},
onExit: (exit) => {
console.log("Exit", exit);
},
onEvent: (event) => {
console.log("Event", event);
},
});
await session.open();The promise resolves as soon as the native IDV session is created. Do not wait
for onLoad before opening an Identity Verification session.
Layer uses a dedicated session object. Submit user data once the Layer session is ready, then open Link when the Layer flow emits the ready event.
import {
LinkEventName,
PlaidLayerSession,
createPlaidLayerSession,
} from "react-native-plaid-link-sdk";
let session: PlaidLayerSession;
session = await createPlaidLayerSession({
token: "#GENERATED_LINK_TOKEN#",
onSuccess: (success) => {
console.log("Success", success);
},
onExit: (exit) => {
console.log("Exit", exit);
},
onEvent: async (event) => {
if (event.eventName === LinkEventName.LAYER_READY) {
await session.open();
}
},
});
await session.submit({
phoneNumber: "415-555-0017",
dateOfBirth: "1975-01-18",
});Headless Link creates a session that starts without presenting the standard Link UI.
import { createPlaidHeadlessSession } from "react-native-plaid-link-sdk";
const session = await createPlaidHeadlessSession({
token: "#GENERATED_LINK_TOKEN#",
onSuccess: (success) => {
console.log("Success", success);
},
onExit: (exit) => {
console.log("Exit", exit);
},
onEvent: (event) => {
console.log("Event", event);
},
onLoad: () => {
console.log("Headless session loaded");
},
});
await session.start();Embedded Search is available on iOS and Android through
PlaidEmbeddedSearchView.
import { PlaidEmbeddedSearchView } from "react-native-plaid-link-sdk";
export function EmbeddedSearch() {
return (
<PlaidEmbeddedSearchView
token="#GENERATED_LINK_TOKEN#"
style={{ height: 500 }}
onLoad={() => {
console.log("Embedded Search loaded");
}}
onSuccess={(success) => {
console.log("Success", success);
}}
onExit={(exit) => {
console.log("Exit", exit);
}}
onEvent={(event) => {
console.log("Event", event);
}}
/>
);
}FinanceKit is available on iOS only. Calling syncFinanceKit on Android rejects
with an error.
import {
FinanceKitSyncBehavior,
syncFinanceKit,
} from "react-native-plaid-link-sdk";
try {
await syncFinanceKit({
token: "#GENERATED_LINK_TOKEN#",
requestAuthorizationIfNeeded: true,
syncBehavior: FinanceKitSyncBehavior.LIVE,
});
console.log("FinanceKit sync complete");
} catch (error) {
console.log("FinanceKit error", error);
}Expo Go does not include Plaid Link's native code. Use an Expo development build, another custom native runtime, or a bare React Native app.
Run npx pod-install after installing or upgrading the package. v13 ships the
required LinkKit.xcframework in the npm package.
Confirm that the Android package name in your app matches the package name configured in the Plaid Dashboard for the environment you are testing.
Confirm that the iOS bundle identifier and redirect URI are configured in the Plaid Dashboard for the environment you are testing.
v13 replaced the global create and open functions with session objects, so
pre-v13 usages no longer compile. Older v13 releases report one error per
removed import:
error TS2614: Module '"react-native-plaid-link-sdk"' has no exported member 'create'.
Did you mean to use 'import create from "react-native-plaid-link-sdk"' instead?
error TS2614: Module '"react-native-plaid-link-sdk"' has no exported member 'open'.
Did you mean to use 'import open from "react-native-plaid-link-sdk"' instead?
error TS2614: Module '"react-native-plaid-link-sdk"' has no exported member 'EmbeddedLinkView'.
Did you mean to use 'import EmbeddedLinkView from "react-native-plaid-link-sdk"' instead?
Older v13 releases reported the same error for every other removed API.
Do not follow the suggested default import. The package does have a default
export, but it is the native module object, not these functions. Rewriting the
import as import create from "react-native-plaid-link-sdk" only moves the
failure to the next line:
error TS2349: This expression is not callable.
Type 'ReactNativePlaidLinkSdkModule' has no call signatures.
Newer v13 releases retain every removed pre-v13 name — create, open,
openLink, usePlaidEmitter, submit, destroy, dismissLink, PlaidLink,
and EmbeddedLinkView — only as deprecated migration diagnostics. Their imports
resolve, but trying to use one produces TS2349 with the exact replacement in
its type:
error TS2349: This expression is not callable.
Type '{ readonly __migration_error__: "Removed in v13. Use await createPlaidLinkSession(config), then call await session.open() on the returned session."; }' has no call signatures.
Rendering PlaidLink or EmbeddedLinkView as a JSX element reports TS2786
with the same replacement:
error TS2786: 'EmbeddedLinkView' cannot be used as a JSX component.
Its type '{ readonly __migration_error__: "Removed in v13. Use PlaidEmbeddedSearchView."; }' is not a valid JSX element type.
JavaScript callers receive the same replacement and a migration-guide link in a runtime error. These diagnostic exports do not restore the pre-v13 global API.
Use the v13 replacements instead:
| Pre-v13 | v13 |
|---|---|
create(config) |
await createPlaidLinkSession(config) |
open({ onSuccess, onExit }) |
await session.open() — callbacks move to the create call |
openLink({ tokenConfig, ... }) |
createPlaidLinkSession(...), then session.open() |
<PlaidLink> component |
Build your own button and call createPlaidLinkSession |
usePlaidEmitter(listener) |
Pass onEvent to the create call |
submit(data) |
await session.submit(data) on a Layer session |
EmbeddedLinkView |
PlaidEmbeddedSearchView |
syncFinanceKit(token, bool, bool, cb) |
await syncFinanceKit({ token, ... }) |
destroy() |
Not needed — each create call resets session state |
dismissLink() |
No replacement in v13 |
The v13 migration guide has full before and after examples for every flow.
Import from the package root only:
import { createPlaidLinkSession } from "react-native-plaid-link-sdk";Do not import from build/, src/, ios/, or android/ directly.
Issues and pull requests are welcome in this repository. Include the SDK version, React Native version, Expo SDK version if applicable, platform, device or simulator, and Link Session ID when reporting bugs.