> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Vérifier l'identité des utilisateurs avec le KYC

> Vérifiez l'identité de vos utilisateurs avant qu'ils puissent recevoir des versements. Un seul appel API lance la vérification Know Your Customer (KYC), et Whop s'occupe du reste.

## Fonctionnement

**1. Lancez une vérification**

Appelez `POST /api/v1/verifications` avec le compte que vous voulez vérifier. Vous obtenez en retour une `session_url`.

**2. Envoyez l'utilisateur effectuer le KYC**

Redirigez votre utilisateur vers la `session_url`. Il y téléverse sa pièce d'identité, prend un selfie et vérifie son identité sur une page hébergée. Vous n'avez aucune interface à construire pour cela.

**3. Écoutez le résultat**

Abonnez-vous au webhook `identity_profile.updated` — il se déclenche à chaque modification du profil (approuvé, refusé, action requise, ou ouverture ou clôture d'un examen). Le webhook vous indique *quel* profil a changé, et non son nouvel état : appelez donc `GET /api/v1/verifications?account_id={biz_ tag}` pour lire le statut actuel et les données d'identité vérifiées.

## Exemple rapide

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "pending",
  "session_url": "https://in.sumsub.com/websdk/p/sbx_xxxxxxxxxxxxx",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

> [!NOTE]
>
> Vous avez besoin d'une clé API de compte avec le scope `identity:write`. Consultez [Authentification et clés API](https://docs.whop.com/fr/developer/guides/auth-scoping.md) pour connaître les types d'identifiants et la façon de limiter leur portée. Rendez-vous dans votre [tableau de bord](https://whop.com/dashboard) → Settings → API Keys pour en créer une.

## Préremplir le formulaire de vérification d'identité

Transmettez des champs d'identité pour épargner des étapes à votre utilisateur. Ils alimentent le formulaire de vérification afin qu'il n'ait pas à ressaisir son nom et son adresse :

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "individual",
    "first_name": "Jane",
    "last_name": "Doe",
    "date_of_birth": "1995-01-15",
    "country": "US",
    "tax_identification_number": "123-45-6789",
    "address": {
      "line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105"
    }
  }'
```

> [!NOTE]
>
> `tax_identification_number` est le numéro d'identification fiscale de la personne — son SSN pour les
> particuliers aux États-Unis — et il est **obligatoire lorsque `country` vaut `US`** : le compte de versement
> ne peut pas être créé sans lui. Envoyez-le tel quel. Il est tokenisé pendant le transit, et
> la valeur brute n'est jamais stockée dans les systèmes de Whop.

> [!WARNING]
>
> Whop ne peut pas prendre en charge les utilisateurs situés dans un [pays ou une région sous sanctions](https://docs.whop.com/fr/trust-and-safety/trust-safety-overview/sanctioned-countries.md).
> La requête échoue avec un `400` et le code d'erreur `address_country_sanctioned`.

## Réutiliser une vérification existante

Si vous avez déjà vérifié cette personne avec Sumsub, envoyez son jeton de partage au lieu de lui faire
passer le KYC une seconde fois. Whop importe l'identité attestée par votre compte Sumsub et la contrôle
au regard de ses propres exigences :

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual", "share_token": "_act-sbx-jwt-eyJhbGciOiJub25l"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "approved",
  "first_name": "Jane",
  "last_name": "Doe",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

**1. Concluez un accord de KYC réutilisable avec Whop**

Sumsub ne partage les données des demandeurs qu'entre clients ayant conclu un accord de KYC réutilisable (Reusable KYC). Whop
vous fournit l'ID client avec lequel partager une fois cet accord en place.

**2. Générez un jeton de partage pour le demandeur**

Appelez `POST https://api.sumsub.com/resources/accessTokens/shareToken` sur votre propre compte Sumsub
avec l'ID du demandeur et l'ID client de Whop dans `forClientId`.

**3. Envoyez-le à Whop**

Transmettez le jeton dans `share_token`. Chaque jeton ne fonctionne qu'une seule fois.

La réponse vous indique le résultat. `approved` signifie que votre vérification couvrait tout ce dont Whop
a besoin et qu'il n'y a plus rien à faire. `pending` avec une `session_url` signifie qu'elle en couvrait une partie —
envoyez l'utilisateur vers cette URL pour terminer uniquement ce qui manque encore. Whop refuse avec un `400` un jeton dont les données
ne couvrent aucune des exigences.

> [!NOTE]
>
> `share_token` ne peut pas être combiné avec `documents` ou `document_type` — chacun constitue une
> alternative complète au flux hébergé.

## Deux types de vérification

| Type | `kind` | Ce qui est vérifié | Quand l'utiliser |
| - | - | - | - |
| Particulier (KYC) | `individual` | L'identité d'une personne | L'utilisateur veut retirer des fonds |
| Entreprise (KYB) | `business` | Une entité commerciale | Le compte doit vérifier son entité juridique |

Un compte peut avoir une vérification de chaque type — un KYC individuel et un KYB d'entreprise.

## Et ensuite

> [card] [Vérifier le statut](https://docs.whop.com/fr/developer/verification/retrieve.md)
>
> Vérifiez le statut d'une vérification et lisez les données d'identité vérifiées.

> [card] [Traiter les RFI](https://docs.whop.com/fr/developer/verification/rfis.md)
>
> Répondez lorsque Whop a besoin d'informations supplémentaires, comme un relevé bancaire.

> [card] [Mise à jour et suppression](https://docs.whop.com/fr/developer/verification/manage.md)
>
> Mettez à jour les champs d'identité ou supprimez une vérification.

> [card] [Référence de l'API](https://docs.whop.com/fr/api-reference/verifications/verification)
>
> Référence complète des champs de l'objet vérification.


## Related topics

- [Vérifier le statut d'une vérification](https://docs.whop.com/fr/developer/verification/retrieve.md)
- [Vérification](https://docs.whop.com/fr/api-reference/legacy/verifications/verification.md)
- [Activer les versements des sous-comptes](https://docs.whop.com/fr/developer/platforms/render-payout-portal.md)
