Nothing's plumb meaningless

    @exodus/react-native-plaid-link-sdk

    3.1.2-no-android.3 • Public • Published

    Getting Started

    In your react-native project directory:

    npm install --save react-native-plaid-link-sdk
    

    Updating from previous versions.

    When upgrading from a previous major version of this library, see the notes here for additional instructions.

    iOS

    Add Plaid to your project’s Podfile as follows (likely located at ios/Podfile). The latest version is version.

    pod 'Plaid', '~> <insert latest version>'
    

    Then install your cocoapods dependencies:

    (cd ios && pod install)
    

    Add a Run Script build phase (after the [CP] Embed Pods Frameworks step) to your target as described in Plaid Link for iOS documentation. This strips simulator symbols from App Store release builds.

    That's it if using a recent react-native version with autolinking support.

    Manual Integration

    If using a version of react-native without autolinking support, then you will need to:

    react-native link react-native-plaid-link-sdk
    

    followed by

    1. In Xcode, in the project navigator, right click LibrariesAdd Files to [your project's name]
    2. Go to node_modulesreact-native-plaid-link-sdkios and add RNLinksdk.xcodeproj
    3. In Xcode, in the project navigator, select your project. Add libRNLinksdk.a to your project's Build PhasesLink Binary With Libraries
    4. Run your project (Cmd+R)<

    Android

    1. Register your app id

    1. Log into your Plaid Dashboard at the API page
    2. Next to Allowed Android package names click "Configure" then "Add New Android Package Name"
    3. Enter your package name, for example com.plaid.example
    4. Click "Save Changes", you may be prompted to re-enter your password

    2. Add PlaidPackage to your application

    1. Go to android/app/src/main/java/<AppName>/MainApplication.java
    2. Add import com.plaid.PlaidPackage; to the imports section
    3. Add packages.add(new PlaidPackage()); to List<ReactPackage> getPackages();

    3. Configure Gradle

    1. Go to the project level android/app/build.gradle
    2. Make sure you are using a min sdk >= 21
    3. Use the latest Android link version version
    4. Add the following dependencies:
    dependencies {
        ...
        implementation project(':react-native-plaid-link-sdk')
        implementation 'com.plaid.link:sdk-core:<insert latest version>'
    1. Go to android/settings.gradle
    2. Add the following lines:
    include ':react-native-plaid-link-sdk'
    project(':react-native-plaid-link-sdk').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-plaid-link-sdk/android')

    PlaidLink

    In your app:

    import { Text } from 'react-native';
    import PlaidLink from 'react-native-plaid-link-sdk';
     
    const MyPlaidComponent = () => {
      return (
        <PlaidLink
         // Replace any of the following <#VARIABLE#>s according to your setup,
         // for details see https://plaid.com/docs/quickstart/#client-side-link-configuration
     
          publicKey='<# Your Public Key #>'
          clientName='<# Your Client Name #>'
          env='<# Environment #>'  // 'sandbox' or 'development' or 'production'
          product={['<# Product #>']}
          onSuccess={data => console.log('success: ', data)}
          onExit={data => console.log('exit: ', data)}
          onCancelled = {(result) => {console.log('Cancelled: ', result)}}
     
          // Optional props
          countryCodes={['<# Country Code #>']}
          language='<# Language #>'
          userEmailAddress='<# User Email #>'
          userLegalName='<# User Legal Name #>'
          userPhoneNumber='<# User Phone Number #>'
          webhook='<# Webhook URL #>'
        >
          <Text>Add Account</Text>
        </PlaidLink>
      );
    };
    

    To receive onEvent callbacks:

    The React Native Plaid module emits onEvent events throughout the account linking process — see details here. To receive these events in your React Native app, wrap the PlaidLink react component with the following in order to listen for those events:

    import React from 'react';
    import { Text, NativeEventEmitter, NativeModules } from 'react-native';
     
    class PlaidEventContainer extends React.Component {
     
      componentDidMount() {
        const emitter = new NativeEventEmitter(Platform.OS === 'ios' ? NativeModules.RNLinksdk : NativeModules.PlaidAndroid);
        this._listener = emitter.addListener('onEvent', (e) => console.log(e));
      }
     
      componentWillUnmount() {
        if (this._listener) {
          this._listener.remove();
        }
      }
     
      render() {
        return (
          <PlaidLink
            clientName='##YOUR CLIENT NAME##'
            publicKey='#YOUR PUBLIC KEY##'
            env='sandbox'
            onSuccess={data => console.log('success: ', data)}
            onExit={data => console.log('exit: ', data)}
            onCancelled = {(result) => {console.log('Cancelled: ', result)}}
            product={['transactions']}
            language='en'
            countryCodes={['US']}
          >
            <Text>Add Account</Text>
          </PlaidLink>
        );
      }
    }
    

    Customizing the PlaidLink component

    By default, PlaidLink renders a TouchableOpacity component. You may override the component used by passing component and componentProps. For example:

          <PlaidLink
            clientName = "Component Test"
            publicKey = "##YOUR PUBLIC KEY##"
            products = {["transactions"]}
            env = "sandbox"
            component= {Button}
            componentProps = {{title: 'Add Account'}}
            onSuccess = {(result) => {console.log('Success: ', result)}}
            onError = {(result) => {console.log('Error: ', result)}}
            onCancelled = {(result) => {console.log('Cancelled: ', result)}}
            product = {["transactions"]}
            language = "en"
            countryCodes = {["US"]}
        >
    

    Install

    npm i @exodus/react-native-plaid-link-sdk

    DownloadsWeekly Downloads

    47

    Version

    3.1.2-no-android.3

    License

    MIT

    Unpacked Size

    37 kB

    Total Files

    11

    Last publish

    Collaborators

    • ezenwankwogabriel
    • meniem
    • mzndako
    • ianertson
    • kevva
    • jumokeolads
    • aaronloexodus
    • vikgmdev
    • iamcrazycoder
    • kewde_
    • cassapula
    • wjbeau
    • feri42
    • jprichardson
    • farisissa
    • dooglio
    • ryanzim
    • headfire
    • kklash
    • gutenye
    • mosesbot
    • roccomuso
    • dcastagnoli
    • sonaye
    • nareg_exodus
    • ves
    • tenaciousmv
    • asyakost
    • maxogden
    • bulgakovk
    • sekhmet
    • andrewtoth
    • chalker
    • andrejb
    • gordonel
    • richayotte
    • jaydp17
    • olistic
    • joepie91
    • merlz
    • jadechip
    • vbonini
    • cooncesean
    • devopsrobot
    • jenish-sojitra
    • unidwell
    • nachoalvarez
    • giovannirco
    • ilyavf
    • rec
    • dncabal
    • r1oga
    • diegomura
    • danilsergeev
    • lanre-mark
    • sunilagrawal
    • guillecura
    • timztos
    • motorina0
    • chadstrat
    • mariosvlad
    • federico-po
    • pagan404