KYC Finalizado

JAAK provee el servicio "KYC webhooks", una herramienta que permite obtener información sobre los flujos elaborados dentro del proceso KYC de JAAK. Este servicio se activa al finalizar un flujo KYC, enviando la información recopilada a las empresas.

📝 Nota: Si deseas conocer más sobre Webhooks, por favor consulta aqui.


Empezando

Para proceder, es indispensable contar con un usuario y contraseña previamente facilitado por el equipo de JAAK, de no ser asi contacte a [email protected] o [email protected] para obtener acceso a nuestros servicios.


Detalles generales

La configuración para activar el webhook es la siguiente:

⚠️ La versión 1 no cuenta con un método de autentificación mediante headers. Se añadirá en versiones posteriores.

  • Endpoint URL: URL segura (https) donde el webhook enviará los datos recopilados.
  • Método HTTP: POST
  • Encabezados HTTP: Content-Type: application/json
  • Cuerpo de la Solicitud (Ejemplo):
{
  "detailsURL": "https://sandbox.jaak.ai/api/v1/kyc/session/<flow_id>",
  "duration": "1m",
  "endedAt": "2024-05-28T21:56:43.154761086Z",
  "id": "soy_un_id",
  "startedAt": "2024-05-28T21:55:27.884Z",
  "scores": {
    "document": 100,
    "liveness": 99.86986517906189,
    "oneToOne": 94.51668167114258,
    "total": 98.12884895006816
  },
  "shortKey": "fwgObf9",
  "validation": "AUTOMATIC"
}
CampoDescripción
detailsURLURL de detalles cuando el flujo ha finalizado
durationDuración de la sesión en formato de tiempo
endedAtFecha y hora de finalización de la sesión
idID de la sesión
startedAtFecha y hora de inicio de la sesión
scores.documentPuntaje de verificación de documentos
scores.livenessPuntaje de verificación de liveness
scores.oneToOnePuntaje de verificación uno a uno
scores.totalPuntaje total de verificación
shortKeyClave corta asociada a la sesión
validationMétodo de validación utilizado (puede ser AUTOMATIC, MANUAL)

Ejemplo de estructura del WebHook

curl -X POST "URL_SEGURA" \
     -H "Content-Type: application/json" \
     -d '{
           "detailsURL": "https://sandbox.jaak.ai/api/v1/kyc/session/<flow_id>",
           "duration": "1m",
           "endedAt": "2024-05-28T21:56:43.154761086Z",
           "id": "soy_un_id",
           "startedAt": "2024-05-28T21:55:27.884Z",
           "scores": {
             "document": 100,
             "liveness": 99.86986517906189,
             "oneToOne": 94.51668167114258,
             "total": 98.12884895006816
           },
           "shortKey": "fwgObf9",
           "validation": "AUTOMATIC"
         }'

Activadores de KYC Webhook


El Webhook de KYC Tradicional se ve activado al momento de finalizar nuestra sesión de KYC, este funciona como un activador de dicho evento, que al momento de recopilar los resultados se encargara de enviar los valores a la URL especificada en la configuración.

Para realizar la activación del Webhook deberás finalizar un proceso KYC en el dashboard correspondiente o aplicar una petición http POST al endpoint {basePath}/session/finish para dar termino y activar dicha acción.

Para conocer mas sobre nuestro proceso de KYC ve al apartado KYC


Actualización KYC Webhook WEB


1. Inicia sesión

Una vez que cuentas con tU usuario y contraseña, inicia sesión dentro de la plataforma.

Para más detalles, consulta la documentación específica de cada método disponible a través de los siguientes enlaces:

Inicia sesion con una cuenta valida

Inicia sesión con una cuenta valida

2. Ve a la sección de ajustes

Utilizando el navegador lateral del panel de administrador, dirígete a la sección de ajustes y al apartado Mi compañía.

Haz click en Ajustes

Haz click en Ajustes


Ve a Mi Compañia

Ve a Mi Compañía

3. Modifica el valor del web Hook

Utiliza el botón editar para editar los datos de tu empresa. En esta sección encontraremos el apartado de productos, donde modificaremos el valor de URL webhook en el dentro de KYC Tradicional.

Edita los valores

Edita los valores


Edita el campo de KYC Tradicional y haz click en guardar cambios.

Edita el campo de KYC Tradicional y haz click en guardar cambios.