> For a complete page index, fetch https://docs.transak.com/llms.txt

# How to Share Sumsub KYC with Transak

If your users have already completed KYC with Sumsub, you can share that verification with Transak using a **KYC share token** — so users don't have to repeat KYC. Follow these steps to generate the token in Sumsub and pass it to Transak.

#### Log in to Sumsub Dashboard

Access your Sumsub dashboard at [cockpit.sumsub.com](https://cockpit.sumsub.com/) and open your project.

#### Retrieve Applicant ID

Retrieve your `APPLICANT_ID` (e.g., 665xxxxxxxxxxxx6a0) from the dashboard.

#### Generate KYC Share Token

Generate your KYC share token using the Sumsub API with the following parameters:

<table>
  <tbody>
    <tr>
      <td>
        **`applicantId`** `string` — required

        The Applicant ID retrieved from Step 2

        ---
      </td>
    </tr>

    <tr>
      <td>
        **`forClientId`** `string` — required

        Must be set to `transak` to share data with Transak

        ---
      </td>
    </tr>

    <tr>
      <td>
        **`ttlInSecs`** `number` — required

        Token validity in seconds (e.g., 600 for 10 minutes). Maximum 1200 seconds (20 minutes).

        ---
      </td>
    </tr>
  </tbody>
</table>

**API Request:**

```bash
curl --request POST \
  --url https://api.sumsub.com/resources/accessTokens/shareToken \
  --header 'content-type: application/json' \
  --data '{
    "applicantId": "APPLICANT_ID",
    "forClientId": "transak",
    "ttlInSecs": "600"
  }'
```

#### Pass KYC share token to Transak (Embed Integration)

Include the KYC share token in your [Create Widget URL](/api/public/create-widget-url) with the following parameters:

<table>
  <tbody>
    <tr>
      <td>
        **`kycShareTokenProvider`** `string` — required

        Set to `SUMSUB` (hardcoded value for Sumsub provider)

        ---
      </td>
    </tr>

    <tr>
      <td>
        **`kycShareToken`** `string` — required

        The secured KYC share token generated in Step 3

        ---
      </td>
    </tr>
  </tbody>
</table>

**API Request:**

```bash
curl --request POST \
  --url https://api-gateway-stg.transak.com/api/v2/auth/session \
  --header 'accept: application/json' \
  --header 'access-token: YOUR_ACCESS_TOKEN' \
  --header 'authorization: YOUR_USER_AUTH_TOKEN' \
  --header 'content-type: application/json' \
  --data '{
  "widgetParams": {
    "apiKey": "YOUR_API_KEY",
    "referrerDomain": "yourdomain.com",
    "kycShareTokenProvider": "SUMSUB",
    "kycShareToken": "eyJhbGciOiJub25lIn0..."
  }
}'
```

> Generate a Sumsub KYC share token and pass it to Transak to skip re-verification