> ## Documentation Index
> Fetch the complete documentation index at: https://rain-sandbox-trial.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Persona Token Sharing

> Reuse a customer's existing Persona inquiry with a share token instead of re-collecting their KYC.

<Info>
  Persona token sharing is only available for Consumer Card Programs.
</Info>

<Warning>
  **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.
</Warning>

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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:

    | Verification step | Requirement                                                                                                              |
    | ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
    | **Government ID** | The user must upload a government-issued ID (for example, a passport or driver's license) and it must pass verification. |
    | **Selfie**        | The user must complete a selfie check and it must pass verification.                                                     |

    ### Required fields

    Your inquiry template must also collect the following information. Rain pulls these fields directly from the completed inquiry.

    | Persona field           | Description                                                                        |
    | ----------------------- | ---------------------------------------------------------------------------------- |
    | `email-address`         | The person's email address                                                         |
    | `name-first`            | The person's first name                                                            |
    | `name-last`             | The person's last name                                                             |
    | `birthdate`             | The person's date of birth                                                         |
    | `identification-number` | The person's national ID number (9-digit SSN if the country of issue is US)        |
    | `phone-number`          | The person's phone number (including country code, for example, `+1 555-123-4567`) |
    | `address-street-1`      | Address line 1                                                                     |
    | `address-street-2`      | Address line 2 (optional)                                                          |
    | `address-city`          | City                                                                               |
    | `address-subdivision`   | State or region                                                                    |
    | `address-postal-code`   | Postal code                                                                        |
    | `country-code`          | Country code (ISO 3166-1 alpha-2 or alpha-3 format, for example, `US` or `USA`)    |

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

    <Info>
      Make sure all required fields are enabled in your Persona inquiry template before generating inquiries. Missing fields will cause the application to fail.
    </Info>
  </Step>

  <Step title="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.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="Use the share token in your application">
    When creating a [consumer application](/reference/applications/create-a-consumer-application-for-a-user), 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](/reference/applications/create-a-consumer-application-for-a-user).
  </Step>
</Steps>

## What's next

<Columns cols={3}>
  <Card title="Share a Sumsub token" icon="arrows-rotate" href="/docs/sumsub-token-sharing">
    Do the same with Sumsub instead of Persona.
  </Card>

  <Card title="Create a consumer application" icon="code" href="/reference/applications/create-a-consumer-application-for-a-user">
    Submit the application with your inquiry ID.
  </Card>

  <Card title="Reuse an existing verification" icon="arrows-rotate" href="/docs/reuse-existing-verification">
    Compare this against the other ways to avoid re-collecting identity.
  </Card>

  <Card title="Verification requirements" icon="shield-check" href="/docs/verification-requirements">
    Fields and screening Rain still applies.
  </Card>
</Columns>