requested_information contiene elementos, envía las respuestas con Actualizar verificación.
Sustituye al recurso Legacy Verifications. Las integraciones Legacy existentes siguen funcionando; consulta Versiones de la API para conocer el contrato de estabilidad.
Endpoints
Atributos
Cuentas para las que se leyó esta verificación, cada una con el prefijo
biz_: la cuenta por la que listaste, la cuenta o subcuenta a la que pertenece con include_subaccounts, o todas las cuentas que puedes leer a las que pertenece cuando se obtiene por ID. Normalmente una. Vacío para una verificación personal.Dirección del perfil de verificación.
null cuando no se ha establecido ninguna dirección.Estructura de entidad jurídica del negocio, como
private_corporation o sole_proprietorship. Los valores admitidos varían según el país de constitución; consulta Estructuras empresariales.Fecha de constitución del negocio, con el formato
YYYY-MM-DD, tal como consta en la verificación del negocio. Solo para verificaciones de negocios; null hasta que se envía.Propietarios del negocio y el progreso de la verificación propia de cada uno. Vacío para verificaciones individuales.
Propiedades
Propiedades
ID del propietario, con el prefijo
own_. Envíalo en owners de Update Verification para cambiar o eliminar al propietario, incluido uno añadido en la sesión alojada.Lo que rechazó el proveedor cuando se devolvió la verificación del propietario:
details (su nombre, fecha de nacimiento u otros datos no coinciden con su documento de identidad), identity_document o selfie. Corrige solo estos con Update Verification. Vacío en caso contrario.Opciones disponibles: details, identity_document, selfieLos documentos del propietario y su progreso. Vacío para un propietario añadido con
verification_id.Propiedades
Propiedades
Por qué se rechazó el envío anterior, cuando el proveedor solicitó nuevos documentos o rechazó la verificación.
Qué es la persona para el negocio.Opciones disponibles:
ubo, director, representative, shareholderEstado o región donde está constituido el negocio, tal como consta en la verificación del negocio. Solo para verificaciones de negocios;
null hasta que se envía.Número con el que se registró el negocio en su lugar de constitución, como un número de expediente estatal en EE. UU. o un Company Number en el Reino Unido. Solo para verificaciones de negocios; tal como consta en la verificación del negocio, o
null hasta que se envía.Lo que Whop aún necesita antes de que pueda continuar la revisión, con un requisito por entrada. Responde con Update Verification. No se devuelve nada de la respuesta. Se omiten las claves que no aplican. Para una verificación de negocio creada con
documents u owners, esto incluye los datos del negocio y los documentos que aún faltan antes de poder enviarla a revisión. Los documentos de cada propietario se listan bajo ese propietario.Propiedades
Propiedades
URL de una acción relacionada, como completar la verificación de prueba de vida o ver un pago. Ausente cuando no hay ninguna acción disponible.
Un documento que responde a este elemento en lugar de
value, como una carta del IRS con el EIN cuando no se pudo verificar el EIN. Envía sus páginas en files, con o sin un value corregido. Ausente cuando solo se acepta value.Instrucción para mostrar al usuario. Incluye literalmente la nota del revisor cuando la hay.
Los valores que puede tomar
value en un elemento select. En un elemento id_document son los tipos de documento de identidad aceptados, y el elegido decide qué espacios de documents enviar. Ausente cuando el elemento no requiere elegir nada.Lo que se necesita: un nombre de documento como
bank_statement, o una clave de campo como ssn o identity_document. Gestiona los valores no reconocidos según type.Formato de entrada nativo opcional para una respuesta de texto.Opciones disponibles:
yes_no, yes_no_na, date, url, number, telSi una pregunta con
options acepta un valor o varios valores.Opciones disponibles: single, multipleDocumentos proporcionados con el requisito como contexto.
Propiedades
Propiedades
Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
El tipo MIME del archivo original, por ejemplo
application/pdf. Se conserva cuando la moderación elimina el archivo.Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
El ID de la carga multiparte, que se devuelve a
complete. Solo está presente al crear, y solo para cargas multiparte.Si la moderación eliminó el archivo. Cuando es
true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.En qué punto del ciclo de vida de la carga se encuentra el archivo.Opciones disponibles:
pending, processing, ready, failedURL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca.
null hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.Los archivos
public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privateURL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
Qué enviar como respuesta, para que nunca tengas que deducirlo:
files (un documento, como una lista de sus páginas), id_document (envía documents con las claves de espacio del documento de identidad que estás subiendo), text, date, phone o select (envía value), text_with_files (envía value y files opcionales), address (envía address) o liveness (abre action_url y luego envía value como true al completarla).Documentos de una verificación por carga de documentos y su progreso. Solo presente en verificaciones individuales creadas enviando
documents. Los documentos pending_upload aún no se aceptaron: vuelve a enviar el conjunto completo con otra llamada a Create Verification.Propiedades
Propiedades
Por qué se rechazó el envío anterior, cuando el proveedor solicitó nuevos documentos o rechazó la verificación.
URL de la sesión de verificación alojada para que el usuario complete las comprobaciones de identidad. Caduca 7 días después de su creación.
Estado actual de la verificación.
not_started antes de que exista una sesión; pending mientras una sesión necesita la intervención del usuario; processing mientras se ejecutan las comprobaciones automáticas del proveedor sobre un envío nuevo; action_required cuando requested_information necesita respuestas; manual_review mientras se revisa información ya enviada (una respuesta de auditoría o un documento que tiene el proveedor de pagos): no hay nada que enviar y normalmente se completa en 3 días hábiles; approved si tiene éxito; rejected si falla. Vuelve a llamar a Create Verification para iniciar una nueva sesión.Opciones disponibles: not_started, pending, processing, manual_review, approved, rejected, action_requiredVerification

