> ## 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.

# Verifica la identidad de los usuarios con KYC

> Verifica la identidad de tus usuarios antes de que puedan recibir pagos. Una sola llamada a la API inicia la verificación Know Your Customer (KYC) y Whop se encarga de todo lo demás.

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

```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]
>
> Necesitas una clave de API de Account con el scope `identity:write`. Consulta [Autenticación y claves de API](https://docs.whop.com/es/developer/guides/auth-scoping.md) para conocer los tipos de credenciales y cómo limitar su alcance. Ve a tu [panel](https://whop.com/dashboard) → 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:

```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` 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.

> [!WARNING]
>
> Whop no puede dar servicio a usuarios de un [país o región sancionados](https://docs.whop.com/es/trust-and-safety/trust-safety-overview/sanctioned-countries.md).
> 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:

```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. 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.

> [!NOTE]
>
> `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

| Tipo | `kind` | Qué verifica | Cuándo usarlo |
| - | - | - | - |
| Individual (KYC) | `individual` | La identidad de una persona | El usuario quiere retirar fondos |
| Empresa (KYB) | `business` | Una entidad empresarial | La cuenta necesita verificar su entidad jurídica |

Una cuenta puede tener una de cada: un KYC individual y un KYB de empresa.

## Próximos pasos

> [card] [Consultar el estado](https://docs.whop.com/es/developer/verification/retrieve.md)
>
> Consulta el estado de la verificación y lee los datos de identidad verificados.

> [card] [Gestionar RFI](https://docs.whop.com/es/developer/verification/rfis.md)
>
> Responde cuando Whop necesite información adicional, como un extracto bancario.

> [card] [Actualizar y eliminar](https://docs.whop.com/es/developer/verification/manage.md)
>
> Actualiza los campos de identidad o elimina una verificación.

> [card] [Referencia de la API](https://docs.whop.com/es/api-reference/verifications/verification)
>
> Referencia completa de los campos del objeto de verificación.


## Related topics

- [Verificación](https://docs.whop.com/es/api-reference/legacy/verifications/verification.md)
- [Habilitar pagos salientes de subcuentas](https://docs.whop.com/es/developer/platforms/render-payout-portal.md)
- [Gestionar las RFI de verificación](https://docs.whop.com/es/developer/verification/rfis.md)
