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

# Gestionar las RFI de verificación

> Responde cuando Whop necesite más información: un documento, un número de identificación fiscal o un dato del negocio.

Whop emite una **solicitud de información (RFI)** cuando necesita algo adicional de un usuario: un documento, un número de identificación fiscal o un dato del negocio. Cada RFI abierta aparece en el array `requested_information` de la verificación. El `status` de la verificación sigue siendo `action_required` hasta que el usuario responde a todos los elementos.

Cada elemento representa una cosa que recopilar, y se responde con una sola escritura. Un `requirement` indica qué se necesita, un `type` de entrada te indica cómo recopilarlo y un `label` proporciona el texto que se muestra al usuario. La respuesta omite las claves que no se aplican a un elemento. Consulta [todos los requisitos](#every-requirement) para ver el catálogo completo.

## Cómo funcionan las RFI

**1. Se solicita información**

Whop indica que se necesita algo. El estado de la verificación cambia a `action_required` y se activa un webhook `identity_profile.updated`. (`identity_profile.needs_action` también se activa en esta transición, pero `identity_profile.updated` es el evento general que cubre todos los cambios de estado: suscríbete a él y vuelve a obtener la verificación para ver qué está pendiente).

**2. Lees los elementos**

Llama a `GET /api/v1/verifications?account_id={biz_ tag}`. El array `requested_information` de cada verificación enumera lo que se necesita y qué tipo de respuesta recopilar.

**3. Recopilas y envías**

Obtén la información de tu usuario y devuélvela mediante `PATCH /api/v1/verifications/{id}` con un array `requested_information`. Whop dirige cada respuesta al lugar correcto.

**4. La revisión continúa**

Los elementos respondidos salen del array. Cuando queda vacío, la verificación pasa a `processing` mientras se revisan las respuestas; en ese estado no hay nada que enviar. Termina en `approved`, o en `manual_review` si se abre una revisión de cumplimiento. Si se rechaza una respuesta, el elemento vuelve a `action_required` con `errors` que explican el motivo. Vuelve a enviarla.

## Leer las RFI

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

Cuando hay RFI pendientes, la verificación tiene este aspecto:

```json theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "action_required",
  "requested_information": [
    {
      "id": "inrqi_xxxxxxxxxxxxx",
      "requirement": "date_of_birth",
      "type": "date",
      "label": "Date of Birth"
    },
    {
      "id": "inrqi_yyyyyyyyyyyyy",
      "requirement": "business_structure",
      "type": "select",
      "label": "Business Structure",
      "options": ["single_member_llc", "multi_member_llc", "sole_proprietorship", "private_corporation"]
    },
    {
      "id": "inrqi_zzzzzzzzzzzzz",
      "requirement": "bank_statement",
      "type": "files",
      "label": "Bank Statement for account ending in 4242"
    }
  ]
}
```

### Campos de los elementos

| Campo | Descripción |
| - | - |
| `id` | El identificador del elemento, con el prefijo `inrqi_`; inclúyelo al enviar una respuesta |
| `requirement` | Lo que Whop necesita, como `ssn` o `bank_statement`; consulta [todos los requisitos](#every-requirement) |
| `type` | Lo que debes devolver: `files`, `id_document`, `text`, `date`, `phone`, `select` o `address` |
| `label` | Lo que debes mostrar a tu usuario. Incluye la nota del propio revisor cuando la hay |
| `options` | Valores permitidos para un elemento `select`, o los tipos de documento de identidad aceptados en un elemento `id_document` |
| `optional` | Aparece como `true` cuando el usuario puede omitir el elemento |
| `errors` | Presente después de una respuesta rechazada, cada uno con un `code` estable y un `reason` legible |

La respuesta devuelve solo las claves que se aplican a un elemento, así que un elemento nunca incluye un array vacío ni un `null` que tengas que comprobar.

La respuesta devuelve solo los elementos abiertos: los elementos respondidos salen del array, de modo que el usuario aún debe todo lo que aparezca. La verificación sigue en `action_required` hasta que el array está vacío.

## Responder a las RFI

Envía un `PATCH` a la etiqueta `idpf_` de la verificación con un array `requested_information`. Cada entrada necesita el `id` del elemento y exactamente un payload de respuesta que corresponda al `type` del elemento:

| `type` del elemento | Payload de respuesta |
| - | - |
| `files` | `files`: un documento, como una lista de sus páginas |
| `id_document` | `documents`: las claves de ranura del documento de identidad que subes |
| `text`, `date`, `phone`, `select` | `value` |
| `address` | Objeto `address` |

La respuesta no repite nada más del elemento: ni categorías ni tipos de documento. El `id` del elemento le indica a Whop a dónde pertenece la respuesta.

Puedes responder a varios elementos en una sola solicitud:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "1990-01-15" },
      { "id": "inrqi_yyyyyyyyyyyyy", "value": "single_member_llc" }
    ]
  }'
```

### Valores de texto, fecha, teléfono y selección

Pasa la respuesta como `value`. Las fechas usan `YYYY-MM-DD`, los números de teléfono usan el formato E.164 (`+12125550123`) y los valores de selección deben ser una de las `options` del elemento.

### Direcciones

Pasa un objeto `address`:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_xxxxxxxxxxxxx",
        "address": {
          "line1": "123 Spring Street",
          "city": "New York",
          "state": "NY",
          "postal_code": "10012",
          "country": "US"
        }
      }
    ]
  }'
```

No se aceptan apartados de correos para direcciones personales ni de empresa.

### Documentos

[Sube primero el archivo](https://docs.whop.com/es/developer/guides/upload-files.md) y después pasa su ID en `files`:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_zzzzzzzzzzzzz", "files": ["file_xxxxxxxxxxxxx"] }
    ]
  }'
```

Cada entrada acepta un ID `file_` del [flujo de subida](https://docs.whop.com/es/developer/guides/upload-files.md) o un `direct_upload_id` de una subida directa. Los documentos deben ser archivos Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) o PDF de hasta 32 MB. Un documento de una página es una lista de un elemento: no hay un campo separado para un solo archivo.

El `requirement` indica el documento que Whop necesita, y Whop se encarga del resto: nunca indicas qué tipo de documento has subido.

#### Documentos con varias páginas

Un documento con varias páginas va en la misma lista `files`, en el orden de las páginas:

```json theme={null}
{ "id": "inrqi_aaa", "requirement": "business_verification_document", "type": "files",
  "label": "Company Verification Document" }
```

```json theme={null}
{ "id": "inrqi_aaa", "files": ["file_page1xxxxxx", "file_page2xxxxxx"] }
```

#### Documentos de identidad

Un elemento `id_document` pregunta de qué documento de identidad se trata. Incluye `options` con los tipos de documento de identidad que acepta la revisión, y la respuesta nombra cada ranura con las mismas claves que acepta [Crear verificación](https://docs.whop.com/es/api-reference/verifications/create-verification.md):

```json theme={null}
{
  "id": "inrqi_bbb",
  "requirement": "identity_document",
  "type": "id_document",
  "label": "Identity Document",
  "options": ["ID_CARD", "DRIVERS", "RESIDENCE_PERMIT", "PASSPORT"]
}
```

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_bbb",
        "documents": {
          "drivers_front": "file_frontxxxxxxx",
          "drivers_back": "file_backxxxxxxxx"
        }
      }
    ]
  }'
```

La clave nombra a la vez el documento y la cara, así que no hay un campo separado para indicar qué documento de identidad representa: Whop lo deduce de las claves. Envía todas las ranuras del documento que subes:

| Tipo de documento | Ranuras |
| - | - |
| `PASSPORT` | `passport_front` |
| `ID_CARD` | `id_card_front`, `id_card_back` |
| `DRIVERS` | `drivers_front`, `drivers_back` |
| `RESIDENCE_PERMIT` | `residence_permit_front`, `residence_permit_back` |

Whop rechaza ranuras mezcladas de dos documentos o un documento incompleto antes de almacenar nada. Las `options` del elemento indican qué tipos de documento de identidad acepta esa revisión.

Si un elemento de archivo no tiene `options`, no necesita `value`.

### Valores sensibles

Envía los números fiscales y de identificación oficial (`ssn`, `ein`, `company_tax_id`, `personal_id_number`) como cualquier otro valor. Whop los sustituye por tokens seguros en tránsito y almacena solo la referencia segura:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "123-45-6789" }
    ]
  }'
```

Si ya tokenizas los valores tú mismo (Basis Theory), pasa en su lugar el ID del token con `value_type: "vault_token"`.

## Respuestas rechazadas

Si Whop rechaza una respuesta enviada, el elemento vuelve a `requested_information` con `errors` establecido:

```json theme={null}
{
  "id": "inrqi_xxxxxxxxxxxxx",
  "requirement": "business_website",
  "type": "text",
  "label": "Business website or social profile",
  "errors": [
    {
      "code": "invalid_url_website_inaccessible",
      "reason": "The website provided could not be reached."
    }
  ]
}
```

Muestra `reason` a tu usuario y ramifica según `code` si lo necesitas. Trata los códigos no reconocidos como un rechazo genérico.

Corrige el problema de fondo y vuelve a enviar con el mismo `id` de elemento. La verificación sigue en `action_required` hasta que Whop acepta la respuesta corregida.

### Códigos de rechazo de documentos

Cuando Whop rechaza un documento subido, `code` indica qué estaba mal. Estos son los códigos que puedes recibir:

| Código | Significado |
| - | - |
| `bad_proof_of_identity` | Whop no acepta el comprobante de identidad; proporciona un documento de identidad oficial con foto |
| `expiration_date` | El documento ha caducado |
| `unsatisfactory_photos` | Demasiado poco claro para leerlo |
| `problematic_applicant_data` | Los datos enviados no coinciden con el documento |
| `screenshots` | El usuario subió una captura de pantalla en lugar de una foto del documento |
| `graphic_editor` | El documento parece editado |
| `digital_document` | El usuario subió una copia digital. Proporciona una foto del documento físico |
| `document_damaged` | Dañado o parcialmente ilegible |
| `document_page_missing` | Falta una página |
| `document_missing` | No se recibió el documento |
| `not_document` | El archivo no es un documento |
| `id_invalid` | El documento de identidad no es válido |
| `incompatible_language` | Idioma no admitido. Proporciona una traducción certificada |
| `bad_selfie` | El selfie no era claro |
| `bad_face_matching` | El selfie no coincidía con la foto del documento |
| `bad_proof_of_address` | No es un comprobante de domicilio aceptado |
| `wrong_address` | La dirección no coincide con el documento |
| `incorrect_social_number` | El número de identificación fiscal no coincide con el documento |
| `company_incorrect_data` | Los datos de la cuenta no coinciden con el documento de registro |
| `company_data_mismatch` | Los datos de la cuenta no coinciden con los registros de Whop |
| `company_inactive_entity` | La cuenta no figura como activa en el registro |
| `additional_document_required` | Whop necesita otro documento |
| `more_documents_required` | Whop necesita más documentos |
| `db_data_mismatch` | Los datos enviados no coinciden con los registros oficiales |
| `spam` | Whop no pudo procesar el envío |

Todos estos códigos describen un problema de la subida que se puede corregir. Un rechazo que Whop no puede atribuir a ninguno de ellos no devuelve `errors`, en lugar de devolver un código inútil. Gestiona siempre un elemento sin `errors` y usa preferentemente `reason` para el texto que ve el usuario.

## Todos los requisitos

El `requirement` de cada elemento es uno de los valores siguientes.

### Datos personales

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `first_name` | `text` | Nombre legal, con mayúscula inicial (`Jane`) |
| `last_name` | `text` | Apellido legal, con mayúscula inicial (`Doe`) |
| `creator_legal_name` | `text` | Nombre legal completo tal como figura en los documentos oficiales |
| `date_of_birth` | `date` | `YYYY-MM-DD` |
| `email` | `text` | Dirección de correo electrónico |
| `creator_email_address` | `text` | Una dirección de correo electrónico en la que Whop pueda contactar con el usuario |
| `phone_number` | `phone` | Formato E.164 con código de país (`+12125550123`) |
| `personal_address` | `address` | Dirección de residencia actual; sin apartados de correos |
| `occupation` | `text` | Código de la Standard Occupational Classification (`15-1132`), o `SELFEMP`, `STUDENT`, `RETIRED`, `UNEMPLO`, `OTHERXX` |
| `annual_salary` | `text` | Ingresos anuales aproximados en dólares estadounidenses, solo dígitos |

### Números de identificación fiscal y oficial

Whop sustituye estos valores por tokens seguros en tránsito; consulta [valores sensibles](#sensitive-values).

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `ssn` | `text` | Número de la Seguridad Social de EE. UU., `XXX-XX-XXXX` |
| `ein` | `text` | Número de identificación del empleador de EE. UU., `XX-XXXXXXX` |
| `company_tax_id` | `text` | Número de identificación fiscal de la cuenta en el formato del país emisor |
| `personal_id_number` | `text` | Número de identificación personal oficial (pasaporte, permiso de conducir, documento nacional de identidad) |
| `personal_id_number_country` | `select` | País que emitió el número de identificación; elige entre las `options` |
| `country_of_issue` | `text` | Código de dos letras del país emisor (`US`) |

### Documentos de identidad

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `identity_document` | `id_document` | Documento de identidad oficial con foto. Envía `documents` con las claves de ranura del documento que sube el usuario |
| `selfie` | `files` | Foto del usuario sosteniendo su documento de identidad |

### Datos del negocio

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `business_name` | `text` | El nombre legal registrado del negocio |
| `trade_name` | `text` | Nombre público si es diferente del nombre legal (nombre comercial) |
| `company_title` | `text` | El nombre de la cuenta |
| `business_structure` | `select` | Estructura jurídica: una de las `options`, p. ej., `single_member_llc`, `sole_proprietorship`, `private_corporation` |
| `account_type` | `select` | `individual`, `company` o `non_profit` |
| `business_representative_title` | `select` | Cargo del representante: una de las `options`, p. ej., `CEO`, `Owner`, `Manager` |
| `industry_type` | `text` | Sector en el que opera el negocio |
| `business_description` | `text` | Entre 100 y 1000 caracteres: qué se vende, qué reciben los clientes después del pago y dónde acceden a ello |
| `product_description` | `text` | El producto o servicio que se vende |
| `business_phone_number` | `phone` | Formato E.164 con código de país |
| `business_address` | `address` | Dirección registrada del negocio; sin apartados de correos |
| `business_website` | `text` | URL del sitio web del negocio |
| `social_media_or_website` | `text` | Sitio web o un perfil social público que represente lo que se vende |
| `store_page_url` | `text` | Enlace a la tienda o a la página del producto |
| `expected_monthly_volume` | `text` | Volumen de procesamiento mensual previsto en dólares estadounidenses, solo dígitos |
| `account_purpose` | `text` | Para qué se usa principalmente la cuenta |

### Documentos del negocio

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `business_verification_document` | `files` | Documento que confirme la identidad jurídica de la cuenta: carta 147C del Internal Revenue Service (IRS), SS-4 o carta de asistencia del Employer Identification Number (EIN) |
| `business_incorporation_papers` | `files` | Documentos oficiales de constitución |
| `ownership_structure` | `files` | Documentos que muestren quién es propietario del negocio |
| `processing_statements` | `files` | Extractos de un procesador de pagos anterior que muestren el historial de procesamiento; no extractos bancarios |
| `proof_of_fulfillment` | `files` | Captura de pantalla, grabación o archivo que muestre lo que reciben los clientes después de la compra |
| `proof_of_funnel` | `text` o `files` | De dónde vienen los clientes: una cuenta social, un sitio web o una landing page |

### Documentos de la cuenta de pagos

Un documento solicitado para verificar un destino de pago nombra el propio documento. Sube un archivo; el `label` le indica a tu usuario a qué cuenta corresponde.

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `bank_statement` | `files` | Extracto bancario reciente de la cuenta de pagos |
| `paper_check` | `files` | Cheque en papel anulado |
| `wallet_screenshot` | `files` | Captura de pantalla del saldo de una billetera o cuenta |
| `government_id` | `files` | Documento de identidad oficial |
| `proof_of_address` | `files` | Comprobante de domicilio emitido en los últimos 3 meses |
| `utility_bill` | `files` | Factura de suministros emitida en los últimos 3 meses |
| `insurance_card` | `files` | Tarjeta de seguro emitida en los últimos 3 meses |
| `company_documents` | `files` | Documentos de la cuenta o de la entidad |

### Preguntas de la revisión

| Requisito | Tipo | Qué enviar |
| - | - | - |
| `anything_else` | `text` o `files` | Cualquier otra cosa que deba saber el equipo de revisión |
| `accept_tos` | `text` | Confirmación de que el usuario acepta los términos del servicio |
| `signature` | `files` | Imagen de la firma para un acuerdo |


## Related topics

- [Consultar el estado de una verificación](https://docs.whop.com/es/developer/verification/retrieve.md)
- [Verificación](https://docs.whop.com/es/api-reference/legacy/verifications/verification.md)
- [RfiElement](https://docs.whop.com/es/elements/latest/verifications/rfi.md)
