Skip to main content
Cette ressource a un successeur dans l’API Whop, 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 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. Avant de la créer, assurez-vous de disposer d’un compte 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. 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 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

Statuts

string
requis
L’identifiant numérique de l’enregistrement de vérification.Exemple : verf_xxxxxxxxxxxxx
VerificationErrorCodes | null
requis
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
string | null
requis
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.
VerificationStatuses
requis
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