> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Seleccionar Perfiles de Verificación
> Usa enabledVerificationProfiles para elegir contra qué perfiles de verificación se evalúa un cliente, y entiende qué acepta y devuelve la API.
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](/es/concepts/onboarding/kyc-via-link) se inscriben en los perfiles predeterminados de tu aplicación.
```json theme={"dark"}
{
"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](mailto: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](/es/concepts/onboarding/verification-profiles/onboard-new-customer#agregar-un-perfil-más-tarde).
* **Eliminar un perfil** solo está permitido mientras ese perfil esté en `incomplete`. Consulta [Eliminar un perfil](/es/concepts/onboarding/verification-profiles/remove-profile).
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](/es/concepts/onboarding/verification-profiles/updating-customer-data).
## 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](/es/concepts/onboarding/verification-profiles/updating-customer-data). |
| `customer/operation-not-allowed` | 400 | Solo clientes empresariales: la selección aún no se puede cambiar después de la creación. |
***
## Guías relacionadas
Qué perfiles existen, qué requiere y desbloquea cada uno.
Elige perfiles al crear y agrega uno más tarde.