> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Identidad verificada: verificación en el registro y step-up antes de pagos

> Didit exige una prueba de vida o una verificación de identidad completa antes de crear una cuenta, y vuelve a pedirla antes de pagos y otras acciones sensibles.

Verified identity de Didit Authentication pide... (corrected below)

Escribo la traducción completa con las tres correcciones:

La función Verified identity de Didit Authentication pide a las personas que demuestren quiénes son en los momentos que tú elijas: antes de crear su cuenta y de nuevo antes de una acción sensible, como un desembolso.
Tu aplicación recibe el resultado y las afirmaciones verificadas que hayas seleccionado, como `over_18` o un nombre verificado, en los tokens de la persona, nunca sus documentos ni sus fotos.

Configúralo en la consola en **Authentication > Verified identity**, o por API con [`verified/`](#configúralo-mediante-la-api).

![La página Verified identity de la Business Console de Didit, con los niveles de verificación al registrarse y sus precios, y las reglas de verificación adicional (step-up) antes de acciones sensibles](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: la verificación al registrarse y las reglas de verificación adicional antes de acciones sensibles.

## Cómo funciona

Cada comprobación se ejecuta como una sesión de verificación de tu aplicación, creada con el `vendor_data` de la persona.
Eso significa que aparece en tus verificaciones y está asociada a la misma persona que sus inicios de sesión y transacciones, pasa a revisión manual como cualquier otra verificación y se factura al precio de esa verificación.

| Comprobación | Qué hace la persona | Precio de lista |
| - | - | - |
| Prueba de vida | Toma una selfie, que se verifica con prueba de vida. | \$0.10 |
| Inicio de sesión con selfie | Toma una selfie que Didit compara con el rostro que ya tiene registrado para la persona. | \$0.10 |
| Identidad completa | Escanea un documento de identidad y toma una selfie: documento, prueba de vida y coincidencia facial. | \$0.33 |

Didit ejecuta cada comprobación con su flujo de verificación (workflow) predeterminado, o con uno de tus propios flujos que elijas para esa comprobación.
Consulta [precios](https://docs.didit.me/es/getting-started/pricing.md) para ver todos los precios de verificación.

## Al registrarse

Elige el nivel que una persona debe superar antes de que se cree su cuenta:

| Nivel | Valor | Significado |
| - | - | - |
| Sin verificación | `none` | Cualquier persona con un correo electrónico, un teléfono o una clave de acceso puede registrarse. Es el predeterminado. |
| Prueba de vida | `liveness` | Se registra una persona real: una selfie que se comprueba mediante la prueba de vida. |
| Identidad completa | `full_id` | Documento, prueba de vida y coincidencia facial, antes de que exista la cuenta. |

Un nivel nuevo solo se aplica a las personas que se registren a partir de ese momento, nunca a las cuentas existentes.

En las páginas de verificación alojadas, Didit guía a la persona durante la comprobación en el registro. En tus propias pantallas, la llamada de registro responde `verification_required` con un `verification_url` que es válido durante 30 minutos: envía a la persona a esa URL.
Didit emite el código de inicio de sesión solo después de que la comprobación sea aprobada.

## Step-up antes de acciones sensibles

Un step-up pide a la persona que vuelva a verificarse, pero solo cuando una acción es lo bastante arriesgada.
Tú activas las reglas, y tu app consulta a Didit antes de cada acción sensible si alguna de ellas aplica.

![Un teléfono que muestra un step-up que pide a la persona confirmar que es ella con una selfie](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

Lo que ve una persona cuando un step-up pide una selfie.

| Regla | Pregunta cuando | Comprobación por defecto |
| - | - | - |
| `payout` | Un retiro o una transferencia supera tu umbral, por ejemplo 500 en tu moneda. Un retiro o una transferencia en otra moneda siempre se comprueba. | Inicio de sesión con selfie |
| `device` | Se hace un pago en una sesión desde un dispositivo que no aparece en ninguna de las sesiones anteriores de la persona. | Inicio de sesión con selfie |
| `bank` | La persona añade o cambia una cuenta bancaria. | Verificación completa de identidad |
| `contact` | La persona cambia su correo electrónico o su número de teléfono. | Prueba de vida |

Puedes cambiar la comprobación de cada regla a prueba de vida, inicio de sesión con selfie o verificación completa de identidad.
Cuando varias reglas aplican, Didit pide la comprobación más estricta.
Cuando Didit todavía no tiene ningún rostro registrado de la persona, un inicio de sesión con selfie pasa a ser una verificación completa de identidad.

### Solicitar un step-up

Tu app llama a `POST {issuer}/step-up/` con el token de acceso de la persona, o al método `stepUp()` de los SDK:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Campo | Regla |
| - | - |
| `action` | `payout`, `bank` o `contact`. Un pago también aplica la regla `device`. |
| `amount` | Obligatorio para `payout`, con hasta dos decimales. |
| `currency` | Código ISO 4217. Por defecto, la moneda de tu regla de payout. |
| `return_to` | A dónde vuelve la persona después de verificarse. Cuando aplica una regla, debe ser una de tus [URLs de redirección](https://docs.didit.me/es/authentication/overview.md#url-de-redirección) registradas. |

* `200 {"required": false}`: ninguna regla aplica, así que puedes continuar.
* `201` con `verification_url`: envía a la persona a esa URL. El step-up sigue abierto durante 30 minutos (`expires_in: 1800`).

### Leer el resultado en tu backend

La persona vuelve a `return_to` con `step_up=<id>&status=approved` añadido, pero esa consulta no prueba nada.
Tu backend lee el step-up con `GET {issuer}/step-up/{step_up_id}/` y un token de acceso de la misma sesión, y actúa solo cuando `status` sea `approved`.

| Estado | Significado |
| - | - |
| `pending` | La persona todavía no ha terminado la comprobación. |
| `approved` | La persona la superó. Puedes continuar con la acción. |
| `review` | La comprobación espera la revisión de tu equipo. |
| `declined` | La persona no la superó. No es definitivo mientras `verification_url` siga funcionando: puede volver a intentarlo, y el step-up vuelve a `pending`. |
| `expired` | Pasaron los 30 minutos. Crea un nuevo step-up. |
| `superseded` | Otra comprobación la reemplazó, o el resultado no correspondía a este step-up. Crea uno nuevo. |

Un step-up nunca permite continuar si falla: cuando la verificación no está disponible, la acción sigue bloqueada.
Las guías de inicio rápido de [JavaScript](https://docs.didit.me/es/authentication/quickstarts/javascript.md#step-up-y-reautenticación), [Next.js](https://docs.didit.me/es/authentication/quickstarts/nextjs.md#verificación-adicional-antes-de-acciones-sensibles) e [iOS](https://docs.didit.me/es/authentication/quickstarts/ios.md#verificación-adicional-antes-de-acciones-sensibles) muestran el lado del SDK, y la [referencia de la API](https://docs.didit.me/es/authentication/api-reference/create-step-up.md) contiene el contrato completo.

## Qué recibe tu aplicación

Elige qué claims verificados se incluyen en los tokens de la persona:

| Claim | Valor |
| - | - |
| `over_18`, `over_21` | Si la persona tiene al menos 18 o 21 años, a partir de la fecha de nacimiento verificada. |
| `given_name`, `family_name` | El nombre y los apellidos verificados. |
| `birthdate` | La fecha de nacimiento del documento, en formato `YYYY-MM-DD`. |
| `nationality` | Código ISO 3166-1 alpha-2. |
| `country` | Código ISO 3166-1 alpha-2 del país del documento. |
| `document_verified` | Si se verificó un documento de identidad. |
| `liveness` | Si se superó una prueba de vida. |

El token de acceso y el token de ID incluyen estos datos en `verified`, junto con `level`, que es el nivel más alto que la persona ha superado: `liveness`, `liveness_face_match` o `full_id`.
Es `{}` cuando la persona no ha superado ninguno, y `GET /session/` devuelve `null` en su lugar.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Una verificación aprobada durante una sesión llega a los tokens en la siguiente renovación, en un plazo de 5 minutos.
* Cualquiera que tenga el token puede leer estos claims, incluido tu front end, así que selecciona solo los claims personales que necesita tu aplicación.
* Tu aplicación recibe claims, nunca el documento, el selfie ni los datos faciales.

## Configúralo mediante la API

`GET` y `PATCH` sobre `verified/` en tu [API de gestión de autenticación](https://docs.didit.me/es/authentication/set-up-by-api.md) leen y modifican la misma configuración que la consola:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Campo | Valores |
| - | - |
| `signup_level` | `none`, `liveness` o `full_id`. |
| `rules` | Una entrada por cada regla que cambies: `rule` (`payout`, `device`, `bank` o `contact`), `enabled`, `method` (`liveness`, `selfie` o `full_id`) y, solo para `payout`, `threshold` y `currency`. |
| `claims` | Las claims de la tabla anterior que se incluirán en los tokens. |
| `workflows` | Opcional: tu propio ID de flujo de verificación (workflow) para `liveness`, `selfie` o `full_id`, o `null` para usar el flujo predeterminado de Didit. |

Una regla que omitas conserva su configuración actual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.