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

# Documentos de identidad

> Qué documentos de identidad acepta la API y las claves de archivo exactas que debes enviar para cada uno.

Verifica a una persona completamente a través de la API enviando las fotos de su documento de identidad en la solicitud [Crear verificación](https://docs.whop.com/es/api-reference/verifications/create-verification.md). Sin sesión alojada ni llamadas de seguimiento: un `POST` y después consultas periódicamente el resultado.

## Qué archivos enviar

Elige el `document_type` que corresponda al documento de la fotografía. Determina exactamente qué claves debe contener el objeto `documents`: ni más ni menos.

| `document_type` | Claves de `documents` obligatorias |
| - | - |
| `id_card` | `id_card_front`, `id_card_back`, `selfie` |
| `drivers` | `drivers_front`, `drivers_back`, `selfie` |
| `residence_permit` | `residence_permit_front`, `residence_permit_back`, `selfie` |
| `passport` | `passport_front`, `selfie` |

Cada valor son los bytes sin procesar del archivo, codificados en base64:

```python theme={null}
import base64

def b64(path):
    with open(path, "rb") as f:
        return base64.b64encode(f.read()).decode()
```

## Reglas de los archivos

* Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) o PDF. Whop detecta el tipo a partir de los bytes reales del archivo, así que la extensión no importa.
* El `selfie` debe ser una foto JPEG o PNG del rostro de la persona.
* 5 MB como máximo por archivo, medido antes de la codificación.
* Envía el conjunto completo en una sola solicitud. Un archivo que falte, sea demasiado grande o no se pueda leer hace que falle toda la solicitud con un error que indica la clave exacta; corrige ese archivo y vuelve a enviar la misma solicitud. Nunca se envía nada de forma parcial.

## Ejemplo completo

```bash theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_XXXXXXXX" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"first_name\": \"Jane\",
    \"last_name\": \"Doe\",
    \"date_of_birth\": \"1990-01-01\",
    \"country\": \"US\",
    \"phone\": \"+15551234567\",
    \"tax_identification_number\": \"123456789\",
    \"address\": { \"line1\": \"123 Main St\", \"city\": \"Austin\", \"state\": \"TX\", \"postal_code\": \"73301\" },
    \"business_website\": \"https://example.com\",
    \"document_type\": \"drivers\",
    \"documents\": {
      \"drivers_front\": \"$(base64 -i front.jpg)\",
      \"drivers_back\": \"$(base64 -i back.jpg)\",
      \"selfie\": \"$(base64 -i selfie.jpg)\"
    }
  }"
```

Un `201` significa que Whop aceptó todos los documentos e inició la revisión: el campo `required_documents` de la respuesta muestra cada clave como `submitted`. Consulta periódicamente [Obtener verificación](https://docs.whop.com/es/api-reference/verifications/retrieve-verification.md) hasta que `status` pase a `approved` o `rejected`.

> [!NOTE]
>
> `business_website` es opcional. Si se omite, se usa la página de whop.com de la cuenta para la configuración de pagos. Si envías uno, debe ser un sitio externo o un enlace de redes sociales. Las páginas de tienda de Whop se rechazan.

## Si Whop rechaza un documento

Cuando el revisor no puede aceptar una foto, `status` vuelve a `action_required` y las claves rechazadas aparecen en `required_documents` como `pending_upload` con un `rejection_reason`. Vuelve a enviar la misma solicitud de Crear verificación con una foto mejor; la revisión se reanuda automáticamente.

## Cobertura por país

Whop acepta `id_card`, `drivers` y `passport` para personas de la mayoría de los países. La tabla siguiente enumera las excepciones. Para un país de esta tabla, solo funcionan los valores indicados. Cualquier otro vuelve a través del flujo de rechazo anterior.

| País | Valores de `document_type` aceptados |
| - | - |
| `AD` | `drivers`, `residence_permit`, `passport` |
| `AI` | `drivers`, `passport` |
| `AQ` | `passport` |
| `AS` | `drivers`, `passport` |
| `CC` | `id_card`, `passport` |
| `CK` | `drivers`, `passport` |
| `CX` | `drivers`, `passport` |
| `EH` | `passport` |
| `ER` | `id_card`, `passport` |
| `FK` | `passport` |
| `FM` | `drivers`, `residence_permit`, `passport` |
| `FO` | `drivers`, `passport` |
| `GF` | `id_card`, `residence_permit`, `passport` |
| `GL` | `drivers`, `passport` |
| `HM` | `passport` |
| `KY` | `drivers`, `passport` |
| `MS` | `drivers`, `residence_permit`, `passport` |
| `NF` | `passport` |
| `PM` | `id_card`, `passport` |
| `SH` | `passport` |
| `SJ` | `passport` |
| `TF` | `passport` |
| `TK` | `drivers`, `passport` |
| `TV` | `drivers`, `passport` |
| `VA` | `passport` |
| `WF` | `id_card`, `passport` |
| `YT` | `id_card`, `passport` |

Whop también acepta `residence_permit` en la mayoría de los países, pero su cobertura es más limitada. Además de lo indicado en la tabla anterior, Whop **no** lo acepta para personas de:

`AG`, `AW`, `BB`, `BF`, `BI`, `BL`, `BZ`, `CV`, `CW`, `DM`, `GG`, `GI`, `GN`, `GS`, `GU`, `GY`, `IM`, `IO`, `JE`, `KI`, `KM`, `LC`, `LR`, `MF`, `ML`, `MP`, `MQ`, `MU`, `NC`, `NR`, `NU`, `NZ`, `PF`, `PG`, `PN`, `PR`, `PS`, `PW`, `SB`, `SC`, `SM`, `SR`, `ST`, `SX`, `SY`, `SZ`, `TC`, `TL`, `TO`, `VC`, `VI`, `WS`

Whop no ofrece verificación de identidad a personas de estos países y rechaza todos los tipos de documento:

`AF` (Afganistán), `BY` (Bielorrusia), `CU` (Cuba), `HT` (Haití), `IQ` (Irak), `IR` (Irán), `KP` (Corea del Norte), `LY` (Libia), `MM` (Myanmar), `MZ` (Mozambique), `RU` (Rusia), `SD` (Sudán), `SO` (Somalia), `SS` (Sudán del Sur)

> [!NOTE]
>
> Esta tabla refleja la configuración de verificación de Whop a julio de 2026. La aceptación por país se aplica durante la revisión, por lo que un tipo de documento que no es válido para el país de la persona falla con un `rejection_reason` en lugar de con un error inmediato.


## Related topics

- [Gestionar las RFI de verificación](https://docs.whop.com/es/developer/verification/rfis.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
- [Verifica la identidad de los usuarios con KYC](https://docs.whop.com/es/developer/verification/overview.md)
