Objeto Device Validation

A validação de um dispositivo por identificação única deve ser realizada através do endpoint de Event Type Device Validation. Os dados enviados deverão ser os dados gerados na api de Cadastro de Dispositivos, juntamente com um id de sessão de Device Scan, isto é, para realizar uma validação de dispositivo a aplicação deve utilizar a sdk para gerar um identificador único e deve ser realizado o cadastro do dispositivo para que ele possa ser identificado posteriormente.

Dinâmica dos Status - analysis_status

O status analysis_status indica o status da decisão do motor de fraude e possui uma máquina de estados bastante simples:

• automatically_approved
• automatically_reproved
• in_manual_analysis
• manually_approved
• manually_reproved
• pending

Definição do Objeto Device Validation

Request Body

{
  "event_id": "12345678",
  "account_id": "12345678",
  "person_id": "12345678",
  "session_id": "12345678",
  "created_at": "2019-12-11T11:37:15.12-03:00"
}

Todas as trocas de informação de uma validação utilizam a seguinte definição para este objeto. Em alguns casos, para facilitar a implementação e diminuir o fluxo de dados entre as partes, algumas informações poderão ser omitidas.

nome	tipo	descrição
event_id	string	Identificador do evento. É essencial que este número seja único para cada requisição (obrigatório)
account_id	string	Identificador da conta cadastrada no sistema de cadastro de dispositivo. Para realizar mais de uma análise referente a um mesmo cadastro, apenas utilize o mesmo account_id nas diferentes análises.(obrigatório)
person_id	string	Identificador do usuário associado a conta cadastrada no sistema de cadastro de dispositivo. Para realizar mais de uma análise referente a um mesmo cadastro, apenas utilize o mesmo person_id nas diferentes análises.(obrigatório)
session_id	string	Identificador da sessão de análise da Device Scan.(obrigatório)
tradiface_recognition_keyng_name	string	Identificador da imagem gerada na sdk para identificação facial.
created_at	datetime	Data e hora o evento (obrigatório)

Enviar um Device Validation

Request Body

  {
    "id": "12345",
    ...
  }

Response Body

  {
    "id": "12345",
    "analysis_status": "automatically_approved",
    "reason": "rule_decision_enum"
  }

Para realizar a validação de um Dispositivo, basta enviar um objeto do tipo Device Validation ao seguinte endpoint:

POST https://api.caas.qitech.app/account_event/event_type/device_validation/event