Crear Sesión KYC Bravo

curl --request POST \
  --url https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "message": "<string>",
  "data": {
    "id": "<string>",
    "provider_id": "<string>",
    "status": "<string>",
    "url": "<string>",
    "vendor_data": {},
    "metadata": {},
    "callback": "<string>",
    "features": [
      {
        "feature": "<string>",
        "status": "<string>"
      }
    ],
    "user_info": {},
    "id_verification": {},
    "liveness": {},
    "face_match": {},
    "ip_analysis": {},
    "compliance": {},
    "events": {},
    "decision_made_at": {},
    "decision_reason": {},
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

POST

api

solutions

kyc-bravo

session

Crear Sesión KYC Bravo

curl --request POST \
  --url https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://prd-api.verifica.id/api/v1/solutions/kyc-bravo/session")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "message": "<string>",
  "data": {
    "id": "<string>",
    "provider_id": "<string>",
    "status": "<string>",
    "url": "<string>",
    "vendor_data": {},
    "metadata": {},
    "callback": "<string>",
    "features": [
      {
        "feature": "<string>",
        "status": "<string>"
      }
    ],
    "user_info": {},
    "id_verification": {},
    "liveness": {},
    "face_match": {},
    "ip_analysis": {},
    "compliance": {},
    "events": {},
    "decision_made_at": {},
    "decision_reason": {},
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

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

¿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 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):

Authorization: Bearer YOUR_API_KEY

Parámetros de Consulta

string

required

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

string

required

Identificador único del proveedor o referencia interna de tu sistema

string

required

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

Respuesta

string

Estado de la respuesta (ej: “success”)

string

Mensaje descriptivo de la respuesta

object

Datos de la sesión creada

Show propiedades de data

string

Identificador único de la sesión creada

string

Identificador único del proveedor de verificación

string

Estado actual de la sesión (ej: “not_started”, “in_progress”, “completed”)

string

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

object|null

Datos adicionales del proveedor

object|null

Metadatos adicionales de la sesión

string

URL de retorno configurada para recibir notificaciones

array

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

Show propiedades de features

string

Nombre de la característica (ej: “ID_VERIFICATION”, “LIVENESS”, “FACE_MATCH”)

string

Estado de la característica (ej: “not_started”, “in_progress”, “completed”)

object|null

Información del usuario cuando esté disponible

object|null

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

object|null

Resultados de la prueba de vida cuando esté disponible

object|null

Resultados de la comparación facial cuando esté disponible

object|null

Resultados del análisis de IP cuando esté disponible

object|null

Resultados de compliance cuando esté disponible

array|null

Registro de eventos de la sesión

string|null

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

string|null

Razón de la decisión final

string

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

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	Descripción
`PENDING`	Sesión creada pero el usuario aún no ha iniciado el proceso
`IN_PROGRESS`	Usuario ha iniciado el proceso de verificación
`COMPLETED`	Proceso de verificación completado exitosamente
`FAILED`	Proceso de verificación fallido
`EXPIRED`	La sesión ha expirado sin completar el proceso

Ejemplo de Solicitud

curl --request POST \
  --url 'https://prd-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 YOUR_API_KEY' \
  --header 'Content-Type: application/json'

Ejemplo de Respuesta Exitosa

{
  "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

Cuando el proceso de verificación finaliza, se envía una notificación POST al callback_url configurado con el siguiente formato:

{
  "session_id": "kyc-bravo-123e4567-e89b-12d3-a456-426614174000",
  "vendor_id": "orden123456",
  "status": "COMPLETED",
  "verification_result": {
    "identity_verified": true,
    "liveness_verified": true,
    "risk_level": "LOW",
    "verification_score": 0.95
  },
  "completed_at": "2024-01-22T14:25:30Z"
}

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

Validación de Datos

Consulta Vehicular

Consulta VIN

FirmaID

Soluciones Compliance

Crear Sesión KYC Bravo

Descripción

Autenticación

Parámetros de Consulta

Respuesta

Estados de la Sesión

Ejemplo de Solicitud

Ejemplo de Respuesta Exitosa

Notificación de Callback

Códigos de Error

​Descripción

​Autenticación

​Parámetros de Consulta

​Respuesta

​Estados de la Sesión

​Ejemplo de Solicitud

​Ejemplo de Respuesta Exitosa

​Notificación de Callback

​Códigos de Error

Descripción

Autenticación

Parámetros de Consulta

Respuesta

Estados de la Sesión

Ejemplo de Solicitud

Ejemplo de Respuesta Exitosa

Notificación de Callback

Códigos de Error