Solicitar Device Check

Após a criação da transaction id, enviando os parâmetros de entrada CPF e session id, obrigatórios para a geração do device check.

Chamada do componente de Device Check:

> 📘 Endereço dos nossos serviços:
> 
> **Homologação**: **POST** <https://datatrustapihml.clearsale.com.br/v1/transaction/{id}/devicecheck>  
> **Produção**: **POST** <https://datatrustapi.clearsale.com.br/v1/transaction/{id}/devicecheck>
> 
> Acesse aqui a **[Docmentação Técnica](<>)**

POST https://datatrustapihml.clearsale.com.br/v1/transaction/{id}/devicecheck  HTTP/1.1
Content-Type: application/json
Accept:application/json
Authorization:Bearer {Token}

POST https://datatrustapi.clearsale.com.br/v1/transaction/{id}/devicecheck  HTTP/1.1
Content-Type: application/json
Accept:application/json
Authorization:Bearer {Token}

Response

A resposta da transação será dividida em dois momentos:

Uma resposta será retornada com alguns dados do dispositivo como, por exemplo, o identificador, a idade na base Clearsale e os device signals, que são os insights das características do dispositivo.
Já a segunda resposta será notificada através de um webhook. Assim, serão enviados os insights referentes ao histórico do dispositivo e possíveis fraudes. Esses insights podem ser verificados em nossa Lista de Insights.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "externalID": 82309203,
  "deviceID": "25432df56bf24f15hd928374",
  "smartID": "25432df56bf24f15hd928374",
  "deviceAge": 24,
  "deviceRisk": "low",
  "score": 0.21142755651978073,
  "requestID": "req-1234567890",
  "deviceSignals": [
        "DFPAT012", 
        "DFPAH004"
    ]
}

HTTP/1.1 204 No Content

HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
{    "Title": "BadRequest",    
     "Status": 400,     
     "Detail": "Invalid Body Request.",    
     "Instance": "/api/v3/Insights",    
     "Extensions": {       
 "traceId": "b4068ddd57f96acb19d7cdb25aa9sg01"    
     }
}

HTTP/1.1 401 Unauthorized

HTTP/1.1 404 NotFound

HTTP/1.1 500 Internal Server Error
Content-Type: application/json; charset=utf-8
{    
"Title": "Internal Server Error",    
"Status": 500,    
"Detail": "An error occurred while processing your request",    
"Instance": "/api/v3/Insights",    
"Extensions": {        
"traceId": "b4068ddd57f96acb19d7cdb25aa9fd312"    
    }  
}

Dicionário de Variáveis

Response

Nome	Descrição	Tipo
ExternalID	Identificador único da transação do integrador.	String
DeviceID	Identificador único do dispositivo.	String
SmartID	Identificador de redundância não único.	String
DeviceAge	Idade do dispositivo na base Clearsale (em horas).	Int
Score	Score de risco de propensão a fraude da dupla CPF + Device. O valor do score de risco é um decimal entre 0 e 1. Quanto mais próximo de 0, menor a propensão a fraude.	Double
DeviceRisk	Risco associado ao dispositivo em questão. Os níveis de risco do dispositivo podem ser: baixo (low), médio (medium), alto (high). Quanto menor o risco, menor propensão a fraude.	String
DeviceSignals	Retorno em insights das caracterísiticas do dispositivo utilizado na transação. Os retornos estão disponíveis na lista de insights podendo ser filtrados pela categoria "Device Signals".	List<String>
RequestID	Identificador transacional da DeviceCheck.	String

Clique aqui para saber como o webhook faz a notificação da segunda resposta de transação do DeviceCheck

Lista de Insights

🔗
Baixe o arquivo para visualizar todos os insights.

FAQ

🔗
Acesse nosso FAQ Clicando Aqui

Updated about 1 month ago