Plaid logo
Docs
ALL DOCS

Link

  • Overview
Libraries
  • Web
  • iOS
  • Android
  • React Native
  • Webview
Core Link flows
  • OAuth guide
  • Remember Me
  • Update mode
  • Preventing duplicate Items
  • Data Transparency Messaging migration
  • Link Token migration guide
  • Legacy public key integrations
Optimizing Link
  • Optimizing Link conversion
  • Measuring Link conversion
  • Pre-Link messaging
  • Customizing Link
  • Choosing when to initialize products
  • Embedded institution search
  • Returning user experience
  • Modular Link (UK/EU only)
Errors and troubleshooting
  • Troubleshooting
  • Handling an invalid Link Token
  • Institution status in Link
Plaid logo
Docs
Close search modal
Ask Bill!
Ask Bill!
Hi! I'm Bill! You can ask me all about the Plaid API. Try asking questions like:
    Note: Bill isn't perfect. He's just a robot platypus that reads our docs for fun. You should treat his answers with the same healthy skepticism you might treat any other answer on the internet. This chat may be logged for quality and training purposes. Please don't send Bill any PII -- he's scared of intimacy. All chats with Bill are subject to Plaid's Privacy Policy.
    Plaid.com
    Log in
    Get API Keys
    Open nav

    Introduction to Link Remember Me

    A faster and easier Link experience for existing Plaid users

    Link Remember Me allows users to fast track account connections across thousands of Plaid-powered apps and services.

    Overview

    Link Remember Me enables users to associate their phone number with the accounts they're connecting to a financial app or service. Once users have opted-in to being 'remembered' by Plaid, they'll be able to quickly connect those same accounts to other financial apps and services in the future using a one-time password.

    After the Consent screen in Link, users can input their phone number and verify it using a one-time password sent to their device. Next, the user will proceed to select an institution and connect their account(s). Once account verification is completed, Plaid will associate the institution and accounts with the user's phone number.

    First Time Remember Me Experience in Plaid Link
    Link Remember Me User Experience

    When users want to connect their saved institutions and accounts to additional Plaid-powered apps or services, Plaid runs security checks to detect that they are a returning user with the same phone number and device used when opting-in to Link Remember Me.

    A returning user can access their saved institutions and accounts with Plaid the next time they open Link. The user can select from a list of previously connected institutions or connect a new institution after verifying their identity through OTP.

    Some previously linked institutions do not require users to authenticate again using credentials for a frictionless experience, designated by the lightning bolt in the institution selection pane. This is based on a variety of factors such as whether the user's device is trusted and the institution supports OTP authentication. A previously connected institution without a lightning bolt will require authentication using credentials with the financial institution.

    If there is only one previously linked institution that exists and the institution is eligible for the streamlined experience using OTP, the institution will be automatically selected —- enabling the user to go directly to selecting which accounts to share with an app or service.

    Returning User Remember Me Experience in Plaid Link

    Link Remember Me is enabled by default for customers in the US and Canada.

    Testing Link Remember Me in Sandbox

    Link Remember Me can only be tested in the Sandbox or Production environments, not Development. To enable a Sandbox Link session for Link Remember Me, use the Link customization name REMEMBER_ME_SANDBOX when creating a Link token.

    Real phone numbers do not work in Sandbox. Instead, Sandbox has been seeded with a test user whose phone numbers may be used to trigger different scenarios. To explore each scenario, enter the corresponding phone number and correct OTP. For all scenarios, the correct OTP is 123456.

    Returning User: A user who has previously enrolled in Link Remember Me by confirming their identity through OTP and successfully linking an Item.

    Link Remember Me Sandbox ScenariosSeeded Phone Number
    New User415-555-0010
    Verified Returning User415-555-0011
    Verified Returning User: linked new account415-555-0012
    Verified Returning User: linked OAuth institution415-555-0013
    Verified Returning User + new device415-555-0014
    Verified Returning User: automatic account selection415-555-0015

    Tracking Link Remember Me events

    Link emits events to indicate whether or not users opt-in to being 'remembered' by Plaid:

    Remember Me events
    EventMeaning
    SUBMIT_PHONEUser has provided their phone number to be remembered by Plaid
    VERIFY_PHONEUser has verified their phone number using OTP
    SKIP_SUBMIT_PHONEUser has opted to not provide their phone number to be remembered by Plaid
    CONNECT_NEW_INSTITUTIONUser chose to connect a new institution
    Remember Me view names

    The following can be found in the view_name field in the TRANSITION_VIEW event for Link Remember Me panes:

    View nameMeaning
    SUBMIT_PHONEUser was prompted to provide their phone number to be remembered by Plaid
    VERIFY_PHONEUser was prompted to verify their phone number using OTP
    SELECT_SAVED_ACCOUNTUser was prompted to select the underlying account from the saved Item
    SELECT_SAVED_INSTITUTIONUser was prompted to select one of multiple saved Items
    Remember Me match reasons

    The match_reason field in the SELECT_INSTITUTION event adds the following values for Remember Me:

    Match reasonMeaning
    AUTO_SELECT_SAVED_INSTITUTIONThe SELECT_SAVED_INSTITUTION pane was skipped
    SAVED_INSTITUTIONUser selected a saved institution
    SAVED_ACCOUNTUser selected a saved account
    Error events

    Link will emit the ERROR event when the user submits an invalid phone number or an invalid OTP. The error_code will be INVALID_PHONE_NUMBER or INVALID_OTP, respectively.

    For more details, see Link SDK documentation. For more information on tracking Link conversion in general, see Improving Link conversion.

    Was this helpful?
    Developer community
    GitHub
    GitHub
    Stack Overflow
    Stack Overflow
    YouTube
    YouTube
    Discord
    Discord