Onboard users with Layer
A guide to integrating Layer with Plaid Check
Overview
This guide will walk you through how to onboard users to Plaid Check with Layer. This process involves creating a user, onboarding the user with Layer, and retrieving the user's Plaid Check data.
Integration steps
Create a user
- Create a
user_idusing the/user/createendpoint. At this stage, theidentityfield is optional.
Onboard the user with Layer
Onboard the user by following Layer's Integration Overview steps.
When creating the Link token via/session/token/create, pass in theuser_idyou created in theuser.user_idfield and be sure the template used has CRA products enabled.Call
/user_account/session/getto retrieve user-permissioned identity information.After processing the identity information, update the Plaid user record by calling the
/user/updateendpoint. Populate theidentityfield with the relevant information. At minimum, the following fields must be provided and non-empty:name,date_of_birth,emails,phone_numbers, andaddresses(with at least one email address, phone number, and address designated asprimary). Providing at least a partial SSN via theid_numbersfield is highly recommended, since it improves the accuracy of matching user records during compliance processes such as file disclosure, dispute, or security freeze requests.
Retrieve the user's Plaid Check data
Now that the identity information has been added to the user record, you can generate a Consumer Report by calling
/cra/check_report/create.Once the Consumer Report has been generated (indicated by a
USER_CHECK_REPORT_READYwebhook), retrieve the report by calling/cra/check_report/base_report/get,/cra/check_report/income_insights/get,/cra/check_report/partner_insights/get, or/cra/check_report/pdf/get.