Skip to main content
Las cuentas y los usuarios completan la verificación cuando Whop necesita confirmar su identidad antes de habilitar los pagos o los flujos de trabajo sensibles en materia de cumplimiento. Usa la API de Verifications para iniciar o reanudar una sesión de verificación alojada, comprobar el estado de la revisión y enviar los datos o documentos solicitados. Si 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

string
ID del perfil de verificación, con el prefijo idpf_.
string[]
requerido
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.
object | null
Dirección del perfil de verificación. null cuando no se ha establecido ninguna dirección.

Propiedades

string | null
string | null
Código de país ISO 3166-1 de dos letras, por ejemplo US, DE o GB.
string
Primera línea de la dirección.
string | null
Segunda línea de la dirección.
string | null
Código postal.
string | null
Código de estado, provincia o región, por ejemplo CA.
string | null
Razón social del negocio.
string | null
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.
string | null
Código de país ISO 3166-1 de dos letras, por ejemplo US, DE o GB.
string
Cuándo se creó el perfil de verificación, como marca de tiempo ISO 8601.
string | null
Con el formato YYYY-MM-DD.
string | null
Dirección de correo electrónico del perfil de verificación.
string | null
string | null
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.
string
Opciones disponibles: individual, business
string | null
object[]
requerido
Propietarios del negocio y el progreso de la verificación propia de cada uno. Vacío para verificaciones individuales.

Propiedades

string
requerido
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.
string | null
requerido
La fecha de nacimiento registrada del propietario, con el formato YYYY-MM-DD.
string | null
requerido
string | null
requerido
number | null
requerido
Participación del negocio que posee la persona, de 0 a 100.
string[]
requerido
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, selfie
object[]
requerido
Los documentos del propietario y su progreso. Vacío para un propietario añadido con verification_id.

Propiedades

string
Clave del espacio del documento, como id_card_front, id_card_back o selfie.
string | null
Por qué se rechazó el envío anterior, cuando el proveedor solicitó nuevos documentos o rechazó la verificación.
string
pending_upload hasta que el documento se haya enviado para revisión; submitted después.Opciones disponibles: pending_upload, submitted
string[]
requerido
Qué es la persona para el negocio.Opciones disponibles: ubo, director, representative, shareholder
string
requerido
El estado de la verificación propia del propietario, con los mismos estados que status. action_required cuando hay que volver a enviar sus documentos.Opciones disponibles: not_started, pending, processing, manual_review, approved, rejected, action_required
string | null
Número de teléfono del perfil de verificación.
string | null
Estado 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.
string | null
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.
object[]
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

string
requerido
ID del elemento de información solicitada, con el prefijo inrqi_.
string
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.
string
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.
string
Pregunta de seguimiento que se muestra con este requisito.
boolean
Si la respuesta de seguimiento es obligatoria cuando está visible.
string[]
Valores de opción seleccionados que hacen visible la pregunta de seguimiento.
object[]
Presente después de un envío rechazado.

Propiedades

string
Código de error estable.
string
Por qué se rechazó.
string
requerido
Instrucción para mostrar al usuario. Incluye literalmente la nota del revisor cuando la hay.
boolean
true cuando el elemento se puede omitir.
string[]
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.
string
requerido
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.
string
Formato de entrada nativo opcional para una respuesta de texto.Opciones disponibles: yes_no, yes_no_na, date, url, number, tel
string
Si una pregunta con options acepta un valor o varios valores.Opciones disponibles: single, multiple
object[]
Documentos proporcionados con el requisito como contexto.

Propiedades

string
requerido
El ID del archivo, con el prefijo file_.
string | null
requerido
Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
string | null
requerido
El tipo MIME del archivo original, por ejemplo application/pdf. Se conserva cuando la moderación elimina el archivo.
string
requerido
Cuándo se creó el archivo, como marca de tiempo ISO 8601.
number | null
requerido
Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
string | null
requerido
El nombre de archivo original, incluida su extensión.
integer | null
requerido
Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
integer | null
El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
string | null
El ID de la carga multiparte, que se devuelve a complete. Solo está presente al crear, y solo para cargas multiparte.
object[] | null
La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.

Propiedades

integer
requerido
El índice, empezando por 1, de esta parte dentro de la carga multiparte.
string
requerido
La URL prefirmada a la que enviar con PUT los bytes de esta parte.
string
requerido
El tipo de este objeto, siempre file.
boolean
requerido
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.
integer | null
requerido
El tamaño del archivo en bytes. null hasta que la carga haya terminado.
object
Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
string
requerido
En qué punto del ciclo de vida de la carga se encuentra el archivo.Opciones disponibles: pending, processing, ready, failed
string | null
URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
string | null
requerido
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.
string
requerido
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, private
string | null
requerido
URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
integer | null
requerido
Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
boolean
Si una explicación escrita puede sustituir a los archivos de soporte requeridos.
boolean
Si este requisito también necesita archivos de soporte.
string[]
Valores de opción seleccionados que hacen visible la entrada de archivos de soporte.
string
requerido
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).
object[]
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

string
Clave del espacio del documento, como id_card_front, id_card_back o selfie.
string | null
Por qué se rechazó el envío anterior, cuando el proveedor solicitó nuevos documentos o rechazó la verificación.
string
pending_upload hasta que el documento se haya enviado para revisión; submitted después.Opciones disponibles: pending_upload, submitted
string | null
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.
string
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_required
string
Cuándo se actualizó el perfil de verificación por última vez, como marca de tiempo ISO 8601.
Verification