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

# Crear Sesión KYC Bravo

> Crea una nueva sesión para el proceso de verificación de identidad KYC Bravo

## Descripción

Este endpoint crea una nueva sesión para el proceso de verificación de identidad KYC Bravo. La sesión permite iniciar un flujo de verificación de identidad para un usuario específico, asociándolo con un identificador de proveedor y configurando una URL de retorno para recibir notificaciones sobre el resultado del proceso.

El servicio de KYC Bravo proporciona:

* **Verificación de identidad**: Validación de documentos oficiales
* **Prueba de vida**: Verificación biométrica del usuario
* **Análisis de riesgo**: Evaluación de posibles fraudes
* **Experiencia digital**: Proceso optimizado para dispositivos móviles y web

## Autenticación

> [!NOTE]
>
> **¿Todavía no tienes un API token?** El campo `Authorization` del panel **Try it** espera tu token Bearer. Revisa [dónde obtener tu API token](https://developers.verifica.id/api-reference/authentication.md#dónde-obtener-tu-api-token) para conseguirlo.

Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de [Autenticación](https://developers.verifica.id/api-reference/authentication.md)):

```
Authorization: Bearer YOUR_API_KEY
```

## Parámetros de Consulta

**email** `string` *required*

Correo electrónico del usuario que realizará el proceso de verificación

**vendor\_id** `string` *required*

Identificador único del proveedor o referencia interna de tu sistema

**callback\_url** `string` *required*

URL a la que se enviará la notificación cuando el proceso de verificación haya finalizado

## Respuesta

**status** `string`

Estado de la respuesta (ej: "success")

**message** `string`

Mensaje descriptivo de la respuesta

**data** `object`

Datos de la sesión creada

**propiedades de data**

**id** `string`

Identificador único de la sesión creada

**provider\_id** `string`

Identificador único del proveedor de verificación

**status** `string`

Estado actual de la sesión (ej: "not\_started", "in\_progress", "completed")

**url** `string`

URL para acceder al flujo de verificación KYC Bravo. Esta URL debe ser proporcionada al usuario para iniciar el proceso.

**vendor\_data** `object|null`

Datos adicionales del proveedor

**metadata** `object|null`

Metadatos adicionales de la sesión

**callback** `string`

URL de retorno configurada para recibir notificaciones

**features** `array`

Lista de características de verificación incluidas en la sesión

**propiedades de features**

**feature** `string`

Nombre de la característica (ej: "ID\_VERIFICATION", "LIVENESS", "FACE\_MATCH")

**status** `string`

Estado de la característica (ej: "not\_started", "in\_progress", "completed")

**user\_info** `object|null`

Información del usuario cuando esté disponible

**id\_verification** `object|null`

Resultados de la verificación de identidad cuando esté disponible

**liveness** `object|null`

Resultados de la prueba de vida cuando esté disponible

**face\_match** `object|null`

Resultados de la comparación facial cuando esté disponible

**ip\_analysis** `object|null`

Resultados del análisis de IP cuando esté disponible

**compliance** `object|null`

Resultados de compliance cuando esté disponible

**events** `array|null`

Registro de eventos de la sesión

**decision\_made\_at** `string|null`

Fecha y hora en que se tomó la decisión final

**decision\_reason** `string|null`

Razón de la decisión final

**created\_at** `string`

Fecha y hora de creación de la sesión

**updated\_at** `string`

Fecha y hora de la última actualización de la sesión

## Estados de la Sesión

Una vez creada la sesión, el proceso de verificación puede pasar por varios estados que serán notificados a través del callback\_url:

| Estado | Nombre | Descripción |
| - | - | - |
| `not_started` | No iniciado | Sesión creada pero la persona aún no ha abierto el enlace |
| `in_progress` | En Progreso | La persona inició el proceso de verificación |
| `in_review` | En Revisión | La verificación se completó y está en revisión manual |
| `approved` | Aprobado | Verificación completada y aprobada |
| `declined` | Desaprobado | Verificación completada y rechazada |
| `expired` | Expirado | La sesión venció sin que la persona la completara |
| `kyc_expired` | KYC expirado | El documento presentado está vencido |
| `abandoned` | Abandonado | La persona inició el proceso y no lo terminó |
| `error` | Error | El proceso falló por un problema técnico |

> [!NOTE]
>
> Para saber si una persona ya pasó por un proceso y en qué estado quedó, usa [Consultar Último Proceso KYC](https://developers.verifica.id/api-reference/compliance/kyc-bravo-last-session.md).

## Ejemplo de Solicitud

```bash theme={null}
curl --request POST \
  --url 'https://api.verifica.id/api/v1/solutions/kyc-bravo/session?email=usuario%40ejemplo.com&vendor_id=orden123456&callback_url=https%3A%2F%2Ftuempresa.com%2Fcallback%2Fkyc' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {TU-API-KEY}' \
  --header 'Content-Type: application/json'
```

## Ejemplo de Respuesta Exitosa

```json theme={null}
{
  "status": "success",
  "message": "Session created successfully.",
  "data": {
    "id": "aa62043c-****-****-****-89740733d6b9",
    "provider_id": "aa62043c-****-****-****-89740733d6b9",
    "status": "not_started",
    "url": "https://bkyc.verifica.id/es/session/iahMkegZu-hu",
    "vendor_data": null,
    "metadata": null,
    "callback": "https://domain.com/operacion/1",
    "features": [
      {
        "feature": "ID_VERIFICATION",
        "status": "not_started"
      },
      {
        "feature": "LIVENESS",
        "status": "not_started"
      },
      {
        "feature": "FACE_MATCH",
        "status": "not_started"
      },
      {
        "feature": "IP_ANALYSIS",
        "status": "not_started"
      },
      {
        "feature": "COMPLIANCE",
        "status": "not_started"
      }
    ],
    "user_info": null,
    "id_verification": null,
    "liveness": null,
    "face_match": null,
    "ip_analysis": null,
    "compliance": null,
    "events": null,
    "decision_made_at": null,
    "decision_reason": null,
    "created_at": "2026-01-21T14:26:19.000000Z",
    "updated_at": "2026-01-21T14:26:19.000000Z"
  }
}
```

## Notificación de Callback

Se envía una notificación POST a la URL de webhook configurada para tu organización cuando la sesión se crea (`kyc.created`) y cada vez que cambia (`kyc.updated`). El cuerpo trae el tipo de evento y, en `payload`, la sesión completa con la misma estructura del `data` de este endpoint:

```json theme={null}
{
  "event_type": "kyc.updated",
  "payload": {
    "id": "aa62043c-****-****-****-89740733d6b9",
    "provider_id": "aa62043c-****-****-****-89740733d6b9",
    "status": "approved",
    "url": "https://bkyc.verifica.id/es/session/iahMkegZu-hu",
    "vendor_data": null,
    "metadata": null,
    "callback": "https://domain.com/operacion/1",
    "features": [
      {
        "feature": "ID_VERIFICATION",
        "status": "approved"
      }
    ],
    "user_info": {
      "full_name": "NOMBRE APELLIDO",
      "document_type": "Identity Card",
      "document_number": "12345678"
    },
    "id_verification": null,
    "liveness": null,
    "face_match": null,
    "ip_analysis": null,
    "compliance": null,
    "decision_made_at": "2026-09-01T14:40:02.000000Z",
    "decision_reason": null,
    "created_at": "2026-09-01T14:32:10.000000Z",
    "updated_at": "2026-09-01T14:40:02.000000Z"
  }
}
```

## Códigos de Error

| Código | Descripción |
| - | - |
| 400 | Solicitud inválida - parámetros faltantes o incorrectos |
| 401 | Token de autenticación inválido o faltante |
| 429 | Demasiadas solicitudes - se ha excedido el límite de rate |
| 500 | Error interno del servidor |


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