Verificación de datos en listas oficiales

Una vez extraídos los datos del documento en el paso anterior, se procede a verificar esta información contra diversas listas oficiales que permiten validar la identidad del cliente y detectar posibles riesgos. Este paso es fundamental para garantizar que la persona no esté vinculada a actividades ilícitas o se encuentre dentro de registros de alto riesgo, al mismo tiempo que confirma su existencia en bases legítimas del gobierno.

No todas las listas tienen un enfoque restrictivo o de riesgo; algunas están diseñadas para confirmar información oficial. Por ello, en lugar de “listas negras”, nos referimos a esta etapa como verificación contra listas oficiales. Algunos ejemplos:

Listas de riesgo internacional: como Interpol o OFAC, utilizadas para detectar vínculos con actividades ilícitas o sanciones.

Listas de validación nacional: como INE, RENAPO o SAT, empleadas para confirmar la identidad y existencia legal del individuo.

Los servicios disponibles en esta etapa son: INE, Interpol, OFAC, RENAPO y SAT.

⚠️

Nota: Solo puedes consultar una lista por solicitud. Aunque la firma para consumir el servicio es la misma, cada lista requiere parámetros específicos según la naturaleza de los datos que valida.

A continuación, se detalla la estructura general de la URL para estas consultas, junto con los parámetros requeridos. Posteriormente, encontrarás una serie de tablas que indican qué campos debes enviar para cada servicio y cómo relacionarlos con los datos extraídos del documento.

URL

POST https://sandbox.api.jaak.ai/api/v2/blacklist/investigate

Header

Authorization: Bearer token-session-kyc

Request

{
    "services": {
        "ine": Boolean,
        "interpol": Boolean,
        "ofac": Boolean,
        "renapo": {
            "curp": Boolean
        },
        "sat": {
            "sat69b": Boolean
        },
        "cdc": {
            "rccFico": Boolean
        }
    },
    "payload": {
        "person": {
            "name": String,
            "secondName": String,
            "lastName": String,
            "secondLastName": String,
            "birthDate": String,
            "nationality": String,
            "additionalLastName": String
        },
        "address": {
            "address": String,
            "neighborhood": String,
            "municipality": String,
            "city": String,
            "state": String,
            "postalCode": String
        },
        "identifications": {
            "curp": String,
            "rfc": String,
            "socialSecurityNumber": String,
            "electorKey": String,
            "ine": {
                "cic": String,
                "ocr": String
            }
        },
        "extras": {
            "commonId": String,
            "wantedIn": String
        }
    }
}

Objeto services

Objeto payload

Objeto payload.person

Objeto payload.address

Objeto payload.identifications

Objeto payload.identifications.ine

Objeto payload.extras

Response

{
    "eventId": String,
    "responseId": String,
    "processTime": Double,
    "organization": String,
    "service": String,
    "result": {},
    "state": {
        "foundInService": Bolean,
        "mustBeFound": Boolean,
        "message": String
    }
}

Objeto state

A continuación, se exhibirán una serie de tablas organizadas por servicio de listas. En estas tablas, se detallarán los campos necesarios para cada lista y su correspondencia con los datos extraídos del paso anterior.

Para hacer la verificación mediante el servicio INE deberás enviar los siguientes datos:

Para hacer la verificación mediante el servicio INTERPOL deberás enviar los siguientes datos:

Para hacer la verificación mediante el servicio OFAC deberás enviar los siguientes datos:

Para hacer la verificación mediante el servicio RENAPO deberás enviar los siguientes datos:

Para hacer la verificación mediante el servicio SAT deberás enviar los siguientes datos:

A continuación, te mostraremos un ejemplo de una consulta al servicio de RENAPO

Request

{
    "services": {
        "ine": false,
        "interpool": false,
        "ofac": false,
        "renapo": {
            "curp": true
        },
        "sat": {
            "sat69b": false
        },
        "cdc": {
            "rccFico": false
        }
    },
    "payload": {
        "identifications": {
            "curp": "aqui va la curp"
        }
    }
}

Response

{
    "eventId": "749f88b9-ecce-4f4c-920a-f8ece706501a",
    "responseId": "",
    "processTime": 0.23123526573181152,
    "organization": "curp",
    "service": "validaCurp",
    "result": null,
    "state": {
        "message": "Investigation completed successfully",
        "foundInService": false,
        "mustBeFound": true
    }
}

Como se muestra en el ejemplo anterior, se realizó una consulta al servicio de RENAPO. En la solicitud, podemos observar que solo se activó un servicio, services.renapo.curp, y que únicamente se enviaron los campos necesarios para llevar a cabo la búsqueda de dicho servicio.

El campo state dentro del Response debería haber indicado que se encontró a una persona para que la búsqueda se considere exitosa. Sin embargo, el campo foundInService muestra que no se encontró a la persona.

En resumen, al contrastar los datos extraídos del documento con diversas listas negras, garantizamos la protección tanto de la empresa como de los usuarios. Este proceso asegura la integridad y el cumplimiento del sistema, ayudando a prevenir fraudes.

Una vez verificado los datos del documento en las listas negras continuemos con los siguientes pasos.