Cómo funciona
1
Inicia una verificación
Llama a
POST /api/v1/verifications con la cuenta que quieres verificar. Recibirás una session_url.2
Envía al usuario a completar el KYC
Redirige a tu usuario a la
session_url. Sube su documento de identidad, se hace un selfie y verifica su identidad en una página alojada. No tienes que crear ninguna interfaz para esto.3
Escucha el resultado
Suscríbete al webhook
identity_profile.updated: se activa con cada cambio en el perfil (aprobado, rechazado, requiere acción, o una revisión que se abre o se resuelve). El webhook te indica qué perfil cambió, no su nuevo estado, así que llama a GET /api/v1/verifications?account_id={biz_ tag} para leer el estado actual y los datos de identidad verificados.Ejemplo rápido
cURL
Response
Necesitas una clave de API de Account con el scope
identity:write. Consulta Autenticación y claves de API para conocer los tipos de credenciales y cómo limitar su alcance. Ve a tu panel → Settings → API Keys para crear una.Rellena previamente el formulario de verificación de identidad
Pasa campos de identidad para ahorrarle pasos a tu usuario. Estos rellenan el formulario de verificación para que no tenga que volver a escribir su nombre y su dirección:cURL
tax_identification_number es el número de identificación fiscal de la persona
(su SSN en el caso de personas de EE. UU.) y es obligatorio cuando country es US:
la cuenta de pagos no se puede crear sin él. Envíalo tal cual. Se tokeniza en tránsito
y el valor sin procesar nunca se almacena en los sistemas de Whop.Reutiliza una verificación que ya tienes
Si ya verificaste a esta persona con Sumsub, envía su token de compartición en lugar de hacerle pasar el KYC por segunda vez. Whop importa la identidad que certificó tu cuenta de Sumsub y la comprueba con los requisitos propios de Whop:cURL
Response
1
Acuerda el KYC reutilizable con Whop
Sumsub solo comparte datos de solicitantes entre clientes que tienen un acuerdo de KYC reutilizable. Whop
te da el ID de cliente con el que compartir una vez que el acuerdo está vigente.
2
Genera un token de compartición para el solicitante
Llama a
POST https://api.sumsub.com/resources/accessTokens/shareToken en tu propia cuenta de Sumsub
con el ID del solicitante y el ID de cliente de Whop como forClientId.3
Envíalo a Whop
Pasa el token como
share_token. Cada token funciona una sola vez.approved significa que tu verificación cubrió todo lo que Whop
necesita y no queda nada por hacer. pending con una session_url significa que cubrió una parte:
envía al usuario a esa URL para completar solo lo que falta. Whop rechaza con un 400 un token cuyos datos
no cubren ninguno de los requisitos.
share_token no se puede combinar con documents ni con document_type: cada uno es una
alternativa completa al flujo alojado.Dos tipos de verificación
Una cuenta puede tener una de cada: un KYC individual y un KYB de empresa.
Próximos pasos
Consultar el estado
Consulta el estado de la verificación y lee los datos de identidad verificados.
Gestionar RFI
Responde cuando Whop necesite información adicional, como un extracto bancario.
Actualizar y eliminar
Actualiza los campos de identidad o elimina una verificación.
Referencia de la API
Referencia completa de los campos del objeto de verificación.

