La regla
Un campo o documento está bloqueado cuando es un criteriocomplete de un perfil de verificación cuyo estado es pending o approved. Todo lo demás se puede cambiar con PATCH /v2/customer/{id} o POST /v2/document.
Los criterios compartidos por varios perfiles están bloqueados si cualquiera de esos perfiles está en
pending o approved. Los criterios que ningún perfil bloqueante del cliente evaluó siguen siendo editables, y eso es lo que permite agregar un perfil a un cliente en pending o approved. Los documentos que ya subiste para un perfil anterior se vuelven a revisar para un perfil recién agregado y aparecen en su criteria.pending hasta que termine esa revisión; los campos de datos se trasladan como complete de inmediato.
Un PATCH rechazado devuelve 400 customer/field-locked-by-verification-profile y no aplica nada. El cuerpo nombra cada campo bloqueado y el perfil que lo bloquea:
parameter: "documentType" y nombra el perfil bloqueante en detail. Eliminar un perfil de enabledVerificationProfiles mientras está en pending o approved devuelve el mismo código con pointer: "/enabledVerificationProfiles".
Siempre inmutables
firstName, lastName, dateOfBirth, email y phone no se pueden cambiar después de la creación en ningún estado. Crea un cliente nuevo si estos datos son incorrectos.
Clientes individuales
Los bloqueos siguen las entradaskyc_profile_* del cliente. La tabla muestra qué perfiles evalúan cada criterio; un criterio está bloqueado mientras cualquier perfil marcado esté en pending o approved.
Ejemplo — perfil A en pending o approved, agregando el perfil C. Todo lo de la columna A está bloqueado.
gender, countryOfBirth y nationality (para un cliente fuera de EEA+), más las cargas de comprobante de domicilio y W-8BEN, están abiertos porque solo C los evalúa. Una vez proporcionados, kyc_profile_c pasa a pending y también los bloquea.
Ejemplo — perfil A rechazado. Nada está bloqueado. Corrige los campos listados en criteria.errors, vuelve a subir documentos si se solicita, y el perfil se vuelve a enviar automáticamente.
Clientes empresariales
PATCH /v2/customer/{id} aún no está disponible para clientes empresariales, incluidos los cambios a enabledVerificationProfiles; devuelve 400 customer/operation-not-allowed. Las cargas de documentos de la empresa y sus representantes no se ven afectadas. Contacta a support@spherepay.co si una empresa existente necesita un nuevo perfil.
Guías relacionadas
Descripción general de perfiles de verificación
Estados, criterios y requisitos por perfil.
Incorporar un cliente con perfiles
Elige perfiles al crear y agrega uno más tarde.