> ## 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érification

> Une session de vérification d'identité utilisée pour confirmer l'identité d'une personne ou d'une entité afin de déterminer l'éligibilité à un compte de versement.

> [!NOTE]
>
> Cette ressource a un successeur dans l'[API Whop](https://docs.whop.com/fr/api-reference/legacy/verifications/verification.md), l'API versionnée sur laquelle les nouvelles intégrations doivent s'appuyer. Cette page reste entièrement prise en charge.

Une Verification guide une personne ou une entreprise à travers les contrôles d'identité requis pour qu'un compte puisse recevoir des versements. Les particuliers effectuent les contrôles Know Your Customer (KYC) et les entreprises les contrôles Know Your Business (KYB). Par exemple, créez une Verification avant le premier versement d'un utilisateur. Vous pouvez préremplir son nom et son adresse afin qu'il puisse remplir le formulaire hébergé sans interface de vérification personnalisée. Plus tard, utilisez la même Verification pour récupérer ses données d'identité vérifiées et répondre aux [RFI](https://docs.whop.com/fr/developer/verification/rfis.md) des prestataires de versement en aval.

Créez une Verification lorsqu'un compte doit être vérifié avant d'effectuer des transactions — généralement avant son premier [versement](https://docs.whop.com/fr/api-reference/payouts/payout). Avant de la créer, assurez-vous de disposer d'un [compte](https://docs.whop.com/fr/api-reference/accounts/account) avec un compte de registre (créé automatiquement lorsque vous créez le compte). Ne créez pas plusieurs Verifications du même `kind` sur le même compte — chaque compte prend en charge au plus un profil individuel (KYC) et un profil entreprise (KYB) actifs. La Verification passe par plusieurs statuts à mesure que l'utilisateur avance dans le processus : `pending` pendant qu'il effectue le KYC, `approved` une fois l'identité confirmée, `rejected` si le prestataire refuse, et `action_required` lorsqu'un prestataire de versement a besoin d'informations supplémentaires, comme un relevé bancaire ou un numéro d'identification fiscale.

Les Verifications réussies aboutissent à une identité entièrement vérifiée avec nom, date de naissance, pays et adresse confirmés — ce qui débloque le compte pour les [versements](https://docs.whop.com/fr/api-reference/legacy/payout-accounts/payout-account.md). Si vous créez une Verification avec des champs de préremplissage (`first_name`, `address`, etc.), ceux-ci alimentent automatiquement à la fois la vérification et le formulaire KYC hébergé, afin que l'utilisateur n'ait pas à ressaisir des informations dont vous disposez déjà. Nous recommandons d'écouter les [webhooks](https://docs.whop.com/fr/api-reference/legacy/webhooks/webhook.md) `identity_profile.approved` et `identity_profile.rejected` plutôt que d'interroger l'API, afin de réagir aux changements de statut en temps réel. Grâce aux Verifications, vous pouvez intégrer des utilisateurs aux versements via une seule intégration d'API, même lorsque les prestataires KYC sous-jacents et les exigences de conformité évoluent au fil du temps.

## Endpoints

| Méthode | Chemin | Description |
| - | - | - |
| `GET` | `/verifications?account_id={biz_ tag}` | [Lister les vérifications](https://docs.whop.com/fr/developer/verification/retrieve.md) d'un compte |
| `GET` | `/verifications/{verification_id}` | [Récupérer une vérification](https://docs.whop.com/fr/developer/verification/retrieve.md) par son tag `idpf_` |
| `POST` | `/verifications` | [Créer une vérification](https://docs.whop.com/fr/developer/verification/overview.md) et démarrer une session KYC/KYB |
| `PATCH` | `/verifications/{verification_id}` | [Mettre à jour les champs d'identité ou répondre aux RFI](https://docs.whop.com/fr/developer/verification/manage.md) |
| `DELETE` | `/verifications/{verification_id}` | [Supprimer de manière réversible](https://docs.whop.com/fr/developer/verification/manage.md) et dissocier du compte |

## Statuts

| Statut | Description | Étape suivante |
| - | - | - |
| `not_started` | La vérification existe, mais aucune session KYC n'a été démarrée | Appelez `POST /verifications` pour démarrer |
| `pending` | L'utilisateur doit effectuer le KYC sur la `session_url` | Redirigez l'utilisateur vers `session_url` |
| `approved` | KYC validé — le compte peut effectuer des transactions | Aucune action requise |
| `rejected` | Le KYC a été refusé par le prestataire | Appelez `POST /verifications` avec `restart: true` |
| `action_required` | Un prestataire de versement a besoin d'informations supplémentaires | Consultez le tableau `rfis` et [répondez](https://docs.whop.com/fr/developer/verification/rfis.md) |

```json Example theme={null}
{
	"id": "verf_xxxxxxxxxxxxx",
	"last_error_code": "abandoned",
	"last_error_reason": "Document image was too blurry to read.",
	"status": "requires_input"
}
```

**id** `string` *required*

L'identifiant numérique de l'enregistrement de vérification.

Exemple : `verf_xxxxxxxxxxxxx`

**last\_error\_code** `VerificationErrorCodes | null` *required*

Le code d'erreur le plus récent renvoyé lors de la vérification. Null si aucune erreur ne s'est produite.

Options disponibles : `abandoned`, `consent_declined`, `country_not_supported`, `device_not_supported`, `document_expired`, `document_type_not_supported`, `document_unverified_other`, `email_unverified_other`, `email_verification_declined`, `id_number_insufficient_document_data`, `id_number_mismatch`, `id_number_unverified_other`, `phone_unverified_other`, `phone_verification_declined`, `selfie_document_missing_photo`, `selfie_face_mismatch`, `selfie_manipulated`, `selfie_unverified_other`, `under_supported_age`

**last\_error\_reason** `string | null` *required*

Une explication lisible de l'erreur de vérification la plus récente. Null si aucune erreur ne s'est produite.

Exemple : `Document image was too blurry to read.`

**status** `VerificationStatuses` *required*

Le statut actuel de cette session de vérification.

Options disponibles : `requires_input`, `processing`, `verified`, `canceled`, `created`, `started`, `submitted`, `approved`, `declined`, `resubmission_requested`, `expired`, `abandoned`, `review`, `action_required`, `manual_review`
