Seleccionar Perfiles de Verificación

SpherePay habilita un conjunto de perfiles de verificación para tu aplicación. enabledVerificationProfiles te permite elegir, por cliente, contra cuáles de esos perfiles se evalúa. Un cliente solo se verifica para los perfiles que selecciones, y solo asume el costo de verificación de esos.

El campo

enabledVerificationProfiles es un arreglo de letras de perfil en POST /v2/customer y PATCH /v2/customer/{id}. Aplica a los clientes incorporados a través de la API; los clientes incorporados mediante enlaces KYC alojados se inscriben en los perfiles predeterminados de tu aplicación.

{
  "type": "individual",
  "email": "jane.smith@example.com",
  "enabledVerificationProfiles": ["a", "c"]
}

Envías	Resultado
`["a"]`	El cliente se evalúa solo contra el perfil A.
`["a", "c"]`	El cliente se evalúa contra A y C. Los requisitos compartidos se satisfacen una sola vez para ambos.
Campo omitido	El cliente se inscribe en todos los perfiles habilitados para tu aplicación al momento de la creación. Los perfiles que SpherePay habilite para ti más adelante no se agregan.
`["d"]` sin `c`	Rechazado — el perfil D requiere el perfil C en el mismo cliente. Envía `["c", "d"]`, o agrega `d` a un cliente que ya tiene `c`.
`[]`	Rechazado — un cliente debe tener al menos un perfil.
Una letra no habilitada para tu aplicación	Rechazado con `customer/verification-profile-family-not-enabled-for-application`.
Una letra repetida	Rechazado como error de validación.

SpherePay recomienda enviar siempre un arreglo explícito. Hace visible la inscripción del cliente en tus propios registros y la mantiene independiente de cambios posteriores en la configuración de tu aplicación.

El conjunto de perfiles que tu aplicación puede usar lo configura SpherePay. Para solicitar un perfil adicional para tu aplicación, contacta a support@spherepay.co.

Qué devuelve la API

GET /v2/customer/{id} devuelve dos campos relacionados:

enabledVerificationProfiles — los perfiles en los que el cliente está inscrito, siempre como un arreglo explícito. Si omitiste el campo al crear, es el conjunto para el que tu aplicación estaba habilitada en ese momento.
verificationProfiles — los perfiles que realmente se están evaluando, cada uno con su status y criteria. Seleccionar un perfil no garantiza que aparezca aquí: un perfil para el que el cliente no es elegible se omite (ver abajo).

Elegibilidad por país

La elegibilidad sigue el país de residencia del cliente (address.country). Los residentes de EE. UU. solo pueden usar el perfil A. Los residentes fuera de EE. UU. pueden usar los perfiles A, C y D. Un perfil seleccionado para el que el cliente no es elegible se omite de verificationProfiles; si ninguno de los perfiles seleccionados aplica, la solicitud se rechaza.

Residencia del cliente	Perfil A	Perfil C	Perfil D
Estados Unidos	✓	—	—
Fuera de Estados Unidos	✓	✓	✓

Un residente de EE. UU. creado con ["a", "c"] se acepta, pero solo kyc_profile_a aparece en verificationProfiles.
Un residente de EE. UU. creado con ["c"] o ["d"] se rechaza con 422 customer/verification-profile-not-enabled, porque ningún perfil seleccionado aplica.

Cambiar la selección más tarde

Envía el arreglo nuevo completo en PATCH /v2/customer/{id}. Omitir el campo deja la selección sin cambios.

Agregar un perfil expone sus requisitos pendientes en criteria.required del nuevo perfil. Los requisitos ya satisfechos para otro perfil se trasladan como complete. Consulta Agregar un perfil más tarde.
Eliminar un perfil solo está permitido mientras ese perfil esté en incomplete. Consulta Eliminar un perfil.

Agregar un perfil nunca vuelve a revisar los perfiles existentes del cliente. Los campos que esos perfiles ya evaluaron permanecen bloqueados mientras estén en pending o approved — consulta Cuándo se pueden actualizar los datos del cliente.

Clientes empresariales

Define enabledVerificationProfiles en la empresa al crearla. Cada representante de empresa que agregues se evalúa contra los mismos perfiles, como ubo_kyc_profile_*; los representantes no llevan su propia selección. Cambiar la selección de una empresa después de la creación aún no es compatible mediante PATCH. Contacta a tu representante de SpherePay si una empresa existente necesita un nuevo perfil.

Referencia de errores

Código	HTTP	Significado
`customer/verification-profile-family-not-enabled-for-application`	422	El arreglo nombra un perfil para el que tu aplicación no está habilitada.
`customer/verification-profile-not-enabled`	422	Ninguno de los perfiles seleccionados aplica a este cliente, por ejemplo un residente de EE. UU. que selecciona solo C o D.
`validation/failed`	422	El arreglo está vacío, contiene duplicados, contiene una letra desconocida o incluye `d` sin `c`.
`customer/field-locked-by-verification-profile`	400	Un campo, documento o eliminación de perfil está bloqueado por un perfil en `pending` o `approved`. El cuerpo lista cada elemento bloqueado. Consulta Cuándo se pueden actualizar los datos del cliente.
`customer/operation-not-allowed`	400	Solo clientes empresariales: la selección aún no se puede cambiar después de la creación.

Incorporación

Transferencias

Automatización

Webhooks

Datos de referencia

Operacional

Seleccionar Perfiles de Verificación

El campo

Qué devuelve la API

Elegibilidad por país

Cambiar la selección más tarde

Clientes empresariales

Referencia de errores

Guías relacionadas

Descripción general de perfiles de verificación

Incorporar un cliente con perfiles

​El campo

​Qué devuelve la API

​Elegibilidad por país

​Cambiar la selección más tarde

​Clientes empresariales

​Referencia de errores

​Guías relacionadas

Descripción general de perfiles de verificación

Incorporar un cliente con perfiles

El campo

Qué devuelve la API

Elegibilidad por país

Cambiar la selección más tarde

Clientes empresariales

Referencia de errores

Guías relacionadas