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
- 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.
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.
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.