Skip to main content
Persona token sharing is only available for Consumer Card Programs.
Persona integration:If you have your own Persona account, integration with Rain will work with API key version 2023-01-05 and kebab-case key inflection.
This flow has two phases: connect Persona to Rain and configure your inquiry template once (steps 1-2), then generate and send an inquiry ID for each applicant you verify (steps 3-4).
1

Activate Persona in your Rain dashboard

Before you can share Persona data with Rain, you need to connect the two systems.
  1. In your Rain developer dashboard, go to Config > External Integrations.
  2. Find Persona in the list of available providers and click the plus icon to activate it.
  3. You will be asked to provide your Persona API key. You can find this in your Persona dashboard under Settings > API Keys.
One connection per program: each program on Rain has its own Persona connection. If you manage multiple programs, activate and provide an API key for each one separately.
2

Configure your Persona inquiry template

You must set up your Persona inquiry template to collect all of the information Rain needs and to run the required verification checks. If any of these are missing, Rain rejects the application.

​
Required verification checks

Your inquiry template must include both of the following verification steps:

​
Required fields

Your inquiry template must also collect the following information. Rain pulls these fields directly from the completed inquiry.Where the country comes from: either the Persona account-level country-code field or a custom field on your inquiry template. If you use a custom field, name it country-code for best compatibility.
Make sure all required fields are enabled in your Persona inquiry template before generating inquiries. Missing fields will cause the application to fail.
3

Generate an Inquiry ID

Once your inquiry template is configured, use the Persona API to create an inquiry for each user. After the user completes the inquiry and it reaches an approved status, retrieve the inquiry ID (it looks like inq_xxxx). This inquiry ID is what you will pass to Rain as the share token.
The inquiry must have a status of approved before you pass it to Rain. Rain rejects inquiries that are still pending, in review, or declined.
4

Use the share token in your application

When creating a consumer application, pass the inquiry ID from Step 3 in the personaShareToken field.You will still need to provide a few additional fields that are not pulled from Persona, such as the user’s occupation and salary. You can find the full list of required fields on the endpoint reference page.

​
What’s next

Share a Sumsub token

Do the same with Sumsub instead of Persona.

Create a consumer application

Submit the application with your inquiry ID.

Reuse an existing verification

Compare this against the other ways to avoid re-collecting identity.

Verification requirements

Fields and screening Rain still applies.