Skip to main content

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.
Whop no puede dar servicio a usuarios de un país o región sancionados. La solicitud falla con un 400 y el código de error address_country_sanctioned.

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.
La respuesta te indica el resultado. 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.