Solicitar Biometria Comportamental

Parâmetro obrigatório

Para que a transação seja concluída com sucesso, é obrigatório enviar o navigationID no momento da criação da transação. Este é o parâmetro utilizado para a solicitação do Device Comportamental.

Chamada do componente de Device Comportamental

Endpoints

POST https://datatrustapihml.clearsale.com.br/v1/transaction/{id}/behavioral-biometrics

POST https://datatrustapi.clearsale.com.br/v1/transaction/{id}/behavioral-biometrics

Request

POST https://datatrustapi.clearsale.com.br/v1/transaction/{id}/behavioral-biometrics

HTTP/1.1Content-Type: application/json

Accept: application/json

Authorization: Bearer {Token}

POST https://datatrustapi.clearsale.com.br/v1/transaction/{id}/behavioral-biometrics

HTTP/1.1Content-Type: application/json

Accept: application/json

Authorization: Bearer {Token}

Response

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

{
    "navigationId": "abc123xyz”, 
    "timeStamp": "2026-01-28T16:00:00Z”, 
    "similarityScore": 0.15, 
    "anomalies": [
           "bot_detected”, 
           “uncommon_region"
      ], 
    "recommendation": "review” 
}

HTTP/1.1 204 No Content

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”
  } 
}

Dicionário de Variáveis

Nome	Descrição	Tipo
navigationId	Identificador único da interação do usuário	String
timeStamp	Horário que a interação foi efetuada	String
similarityScore	Resultado da análise da similaridade do dispositivo (de 0 a 1), onde mais próximo a 0 mais confiável e 1 menos confiável.	Double
anomalies	Lista de anomalias identificadas que auxiliam na tomada do score	Array
recommendation	Recomendação indicada para autenticação do usuário, sendo “approve”, “reject” ou “review”	String

Lista de Anomalias

Código	Descrição
bot_detected	Navegação automatizada detectada
uncommon_time	Horário de uso incomum
uncommon_time_weekend	Dia de semana de uso incomum
uncommon_region	Região de uso (geolocalização) incomum
geolocation_was_not_collected	Geolocalização não coletada
operating_system_never_observed_in_history	Sistema operacional nunca observado no histórico do usuário
Browser_never_observed_in_history	Navegador nunca observado no histórico do usuário
insufficient_behavioral_data	Dados insuficientes para análise