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
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 unPATCH 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 comovalue. 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 objetoaddress:
cURL
Documentos
Sube primero el archivo y después pasa su ID enfiles:
cURL
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 listafiles, en el orden de las páginas:
Documentos de identidad
Un elementoid_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
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
value_type: "vault_token".
Respuestas rechazadas
Si Whop rechaza una respuesta enviada, el elemento vuelve arequested_information con errors establecido:
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
Elrequirement 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; ellabel le indica a tu usuario a qué cuenta corresponde.

