Este manual é para desenvolvedores que desejam fazer uso da ferramenta de identificação de dispositivos (também conhecida como Device Fingerprint e Behavior Analytics). Através desse recurso é possível identificar se uma máquina já é conhecida pela ClearSale e qual o seu histórico de ações.

A ClearSale respeita as políticas de privacidade para a captura dos dados e o nível de permissão atribuído pelo usuário do dispositivo.

Nossos algoritmos coletam informações públicas do dispositivo, tais como IP, sistema operacional, entre outras, com a finalidade de identificar se um dispositivo já é conhecido pela ClearSale e qual o seu histórico de ações. A ClearSale tem interesse legítimo em fornecer serviços de prevenção a fraude a partir de formação de perfis comportamentais, os quais são lícitos e representam uma finalidade legítima, considerada a partir de situações concretas, tal como exigido pela LGPD.

Mais informações de como estamos preocupados e atuando para cumprimento da LGPD, veja o link.

Uso de dados

Todas as informações coletadas pelo SDK da ClearSale são com exclusiva finalidade de prevenção à fraude e proteção ao próprio usuário, aderente à política de segurança e privacidade das plataformas Google e Apple e à LGPD. Por isso, estas informações devem constar na política de privacidade do aplicativo.

Tipo de dados coletados

O SDK da ClearSale coleta as seguintes informações do dispositivo :

• Localização precisa (quando habilitada permissão pelo usuário);
• Identificadores de publicidade do dispositivo (quando habilitada permissão pelo usuário);
• Características físicas do dispositivo/ hardware (Como tela, bateria, teclado, espaço livre em disco, modelo, nome do dispositivo);
• Características de software (Como versão, idioma, build, controle parental);
• Informações de rede (Como Conexões, IP);
• Operadora do SimCard.

SessionID é o parâmetro que identifica a sessão do usuário no website e aplicativo. Toda vez que o usuário deixar a página sem concluir a transação e retornar posteriormente esse valor deve ser atualizado, pois haverá uma nova captura de informações. Este parâmetro é extremamente relevante e o mesmo valor de SessionID passado no parâmetro da coleta do Behavior Analytics deverá ser enviado para a ClearSale no campo "SessionID" da API de envio da transação/pedido.

Recomendação

O ideal é que seja utilizado a funcionalidade de gerar SessionID do próprio Behavior Analytics, caso deseje realizar sua própria implementação, sugerimos que seja utilizado um GUID, pois o SessionID precisa ser um valor único.

Plataforma	Documentação
Android latest	Clique Aqui
Browser ou Webviewlatest	Clique Aqui
Flutter latest	Clique Aqui
IOS latest	Clique Aqui
React Native latest	Clique Aqui

API	Documentação
Device CheckWebhook (v3)	Clique Aqui
Device CheckFull Response (v2)	Clique Aqui

Os módulos do produto Device Check são extensões que podem ser contratadas para obter resultados personalizados.

Módulos	Documentação
Eventoslatest	Clique Aqui
Device Comportamental*latest	Clique Aqui

* Somente v3

This guide is for developers who wish to make use of the device identification tool (also known as Device Fingerprint and Behavior Analytics). Through this resource is possible to identify if a machine is known by ClearSale and its action history.

ClearSale respects privacy policies regarding data collection and the permission level set by the device user.

Our algorithms collects public device information, such as IP, operational system, among others ones, for the prupose of identify if a device is known by Clearsale and its action history. ClearSale has the legimate interest in provide fraud detecction services through the formation of behavioral profiles, which is licit and represents a legitimate purpose, considerate through concrete situations, as required by LGPD (Brazilian General Data Protection Law).

For more information on how we are concerned and acting to comply with the LGPD, see the link.

Data Usage

All information collected by ClearSale's SDK are exclusively for the purpose of fraud prevention and user protection, adherent to the security and privacy policies of Google and Apple platfoms and the LGPD. Therefore, this information must be in the application privacy policy.

Data Type Collected

ClearSale's SDK collects the following device information:

• Precise location (when allowed by user);
• Device advertising identification (when allowed by user);
• Device physical/hardware characteristics (such as display, battery, keyboard, disk space, model, device name);
• Device software characteristics (such as version, language, build, parental control);
• Network information (such as connections, IP);
• SimCard carrier.

SessionID is the parameter which identifies the user session in the website and application. Everytime the user lefts the page without finishing the transaction and returns later, this value should be updated, because there will be a new information capture. This parameter is extremely relevant and the same SessiondID value passed as parameter of Behavior Analytics collect should be send to ClearSale in the "SessionID" field of the send transaction/order API.

Recommendation

Ideally, the Behavior Analytics generate SessionID functionality should be used, if you wish to carry out your own implementation, we suggest to use a GUID, because the SessionID must be an unique value.

Platform	Documentation
Android latest	Click Here
Browser or Webviewlatest	Click Here
Flutter latest	Click Here
IOS latest	Click Here
React Native latest	Click Here