Skip to main content
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 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

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

Campos de los elementos

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: 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:
cURL

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:
cURL
No se aceptan apartados de correos para direcciones personales ni de empresa.

Documentos

Sube primero el archivo y después pasa su ID en files:
cURL
Cada entrada acepta un ID file_ del flujo de subida 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:

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:
cURL
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: 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:
cURL
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:
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: 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

Números de identificación fiscal y oficial

Whop sustituye estos valores por tokens seguros en tránsito; consulta valores sensibles.

Documentos de identidad

Datos del negocio

Documentos del negocio

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.

Preguntas de la revisión