Skip to main content
Este recurso tiene un sucesor en la API de Whop, la API versionada sobre la que deben construirse las nuevas integraciones. Esta página sigue teniendo soporte completo.
Una Verification guía a una persona o empresa a través de las comprobaciones de identidad necesarias para que una cuenta pueda recibir pagos. Las personas físicas completan comprobaciones Know Your Customer (KYC) y las empresas completan comprobaciones Know Your Business (KYB). Por ejemplo, crea una Verification antes del primer pago de un usuario. Puedes rellenar previamente su nombre y dirección para que complete el formulario alojado sin una interfaz de verificación personalizada. Más adelante, usa la misma Verification para recuperar sus datos de identidad verificados y responder a las RFI de los proveedores de pagos posteriores. Crea una Verification cuando una cuenta necesite verificarse antes de realizar transacciones, normalmente antes de su primer pago. Antes de crearla, asegúrate de tener una cuenta con una cuenta contable (que se crea automáticamente al crear la cuenta). No crees varias Verifications del mismo kind en la misma cuenta: cada cuenta admite como máximo un perfil individual (KYC) y un perfil de empresa (KYB) activos. La Verification pasa por varios estados a medida que el usuario completa el proceso: pending mientras realiza el KYC, approved una vez confirmada la identidad, rejected si el proveedor la rechaza y action_required cuando un proveedor de pagos necesita información adicional, como un extracto bancario o un número de identificación fiscal. Las Verifications completadas correctamente dan como resultado una identidad totalmente verificada con nombre, fecha de nacimiento, país y dirección confirmados, lo que habilita la cuenta para recibir pagos. Si creas una Verification con campos precargados (first_name, address, etc.), estos se usan automáticamente tanto en la verificación como en el formulario de KYC alojado, para que el usuario no tenga que volver a introducir información que ya tienes. Recomendamos escuchar los webhooks identity_profile.approved e identity_profile.rejected en lugar de hacer sondeos, para reaccionar a los cambios de estado en tiempo real. Con Verifications, puedes incorporar usuarios para recibir pagos mediante una única integración de API, aunque los proveedores de KYC subyacentes y los requisitos de cumplimiento cambien con el tiempo.

Endpoints

Estados

string
requerido
El ID numérico del registro de verificación.Ejemplo: verf_xxxxxxxxxxxxx
VerificationErrorCodes | null
requerido
El código de error más reciente devuelto durante la verificación. Null si no se ha producido ningún error.Opciones disponibles: abandoned, consent_declined, country_not_supported, device_not_supported, document_expired, document_type_not_supported, document_unverified_other, email_unverified_other, email_verification_declined, id_number_insufficient_document_data, id_number_mismatch, id_number_unverified_other, phone_unverified_other, phone_verification_declined, selfie_document_missing_photo, selfie_face_mismatch, selfie_manipulated, selfie_unverified_other, under_supported_age
string | null
requerido
Una explicación legible del error de verificación más reciente. Null si no se ha producido ningún error.Ejemplo: Document image was too blurry to read.
VerificationStatuses
requerido
El estado actual de esta sesión de verificación.Opciones disponibles: requires_input, processing, verified, canceled, created, started, submitted, approved, declined, resubmission_requested, expired, abandoned, review, action_required, manual_review