Financial Fraud Radar

Última atualização: 22 de Setembro de 2021

Introdução

Com a nossa API para Fintechs você obterá um índice, reports e attack alerts sobre determinado cliente, com base na análise de histórico, contexto e comportamento do mesmo.

Fingerprint

Para a utilização do módulo Fintech é necessário que o Fingerprint esteja integrado ao seu website.

Para maiores informações sobre as configurações do Fingerprint clique aqui.

Envio de Proposta

Este método é utilizado para enviar as propostas a ser analisadas pela ClearSale.

Requisição
POST https://api.clearsale.com.br/v1/fintech/fraud/score HTTP/1.1
Content-Type:application/json
Accept:application/json
Authorization: Bearer {Token}
{
    "OrderID" : "FINTECH_20171205",
    "OrderDate": "2017-12-28T13:20:24",
    "SessionID" : "cd161347af40806c",
    "ReferenceDate" : null, 
    "BirthDate" : null, 
    "Email" : "teste@teste.com",
    "Cpf" : "01234567890",
    "ValidatedTokenEmail": 1,
    "ValidatedTokenSMS": 1,
    "Name" : "Teste",
    "Addresses":[
    {
       "Street" : "Rua teste",
       "Number" : "12355",
       "Complement" : "Esquina 3",
       "District" : "B13",
       "City" : "São Paulo",
       "State" : "SP",
       "Country" : "Brasil",
       "ZipCode" : "00000000",
       "TypeID": 1
    }],
    "Phones":[
    {
       "TypeID": 1,
       "DDI": "55",
       "DDD": "11",
       "Number": "999999999"
    }]
}
POST https://homologacao.clearsale.com.br/api/v1/fintech/fraud/score HTTP/1.1
Content-Type:application/json
Accept:application/json
Authorization: Bearer {Token}
{
    "OrderID" : "FINTECH_20171205",
    "OrderDate": "2017-12-28T13:20:24",
    "SessionID" : "cd161347af40806c",
    "ReferenceDate" : null, 
    "BirthDate" : null, 
    "Email" : "teste@teste.com",
    "Cpf" : "01234567890",
    "Name" : "Teste",
    "ValidatedTokenEmail": 1,
    "ValidatedTokenSMS": 1,
    "Addresses":[
          {
           "Street" : "Rua teste",
           "Number" : "12355",
           "Complement" : "Esquina 3",
           "District" : "B13",
           "City" : "São Paulo",
           "State" : "SP",
           "Country" : "Brasil",
           "ZipCode" : "00000000",
           "TypeID": 1
          }
        ],

        "Phones":[
          {
           "TypeID": 1,
           "DDI": "55",
           "DDD": "11",
           "Number": "99999999"
          }
        ]
}
Resposta
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
{
      "ID": 1234,
      "OrderID": "FINTECH_20171205",
      "Score": 0-99,
      "Name": "Teste",    
      "Cpf": "01234567890",   
      "Email": "teste@teste.com",
      "Diagnostics":[
           "E-mail de Alto Risco",
           "Cliente Digital"
      ]
}
Dicionário de variáveis
Nome Descrição Tipo Tamanho Obrigatório
OrderID ID da proposta String 50 Sim
OrderDate Data da proposta DateTime (yyyy-MM-dd hh:mm:ss) - Não
SessionID Identificador único da sessão do usuário. String 128 Não
ReferenceDate Data de Referencia da proposta DateTime (yyyy-MM-dd) - Não
BirthDate Data de nascimento do cliente da proposta DateTime (yyyy-MM-dd) - Não
Email E-mail do cliente da proposta String 150 Sim
CPF CPF do cliente da proposta String 20 Sim
Name Nome do cliente da proposta String 200 Sim
ValidatedTokenEmail Valor binário indicando se o token foi validado via email.
Valores possiveis:
  • 1 - quando o cliente validou o Token
  • 0 - quando o cliente não validou o Token ou não usa Token para Email.
 bit 1 Não
ValidatedTokenSMS Valor binário indicando se o token foi validado via SMS.
Valores aceitos:
  • 1 - quando o cliente validou o Token
  • 0 - quando o cliente não validou o Token ou não usa Token para SMS.
 bit 1 Não
Addresses Os endereços armazenados no cadastro do cliente. Lista de Endereços - Não
Street Logradouro do cliente da proposta String 150 Sim (se enviado lista de endereços)
Number Número do endereço do cliente da proposta String 10 Sim (se enviado lista de endereços)
Complement Complemento do endereço do cliente da proposta String 50 Não
District Bairro do endereço do cliente da proposta String 70 Sim (se enviado lista de endereços)
City Cidade do endereço do cliente da proposta String 70 Sim (se enviado lista de endereços)
State Sigla do estado do endereço do cliente da Proposta String 2 Sim (se enviado lista de endereços)
Country País do endereço do cliente da proposta String 30 Sim (se enviado lista de endereços)
ZipCode Código Postal do endereço do cliente da proposta String 8 Sim (se enviado lista de endereços)
TypeID Tipo do endereço fornecido pelo cliente da proposta. Onde:
1 - Entrega
2 - Cobrança 		Int 4 Sim (se enviado lista de endereços)
Phones Os telefones armazenados no cadastro do cliente. Lista de telefones - Não
TypeID Tipo do telefone informado pelo cliente da proposta. Onde:
1 - Residencial
2 - Celular
3 - Comercial
4 - Contato		 Int 4 Sim (se enviado a lista de telefones)
DDI DDI do telefone informado pelo cliente da proposta String 4 Não
DDD DDD do telefone informado pelo cliente da proposta String 2 Sim (se enviado a lista de telefones)
Number Número do telefone informado pelo cliente da proposta String 10 Sim (se enviado a lista de telefones)

Retorno de Proposta

Este método será responsável por retornar os dados principais da proposta juntamente ao índice e seus respectivos reports e alerts.

Requisição
GET https://api.clearsale.com.br/v1/fintech/fraud/score/{id} HTTP/1.1
Content-Type:application/json
Authorization: Bearer {Token}
GET https://homologacao.clearsale.com.br/api/v1/fintech/fraud/score/{id} HTTP/1.1
Content-Type:application/json
Authorization: Bearer {Token}

O valor {id} deve ser preenchido com o id que foi retornado no envio da proposta.

Resposta
HTTP/1.1 200 OK
Content-Type:application/json
{
      "ID": 1234,
      "OrderID:" "FINTECH_20171205",
      "Score": 0-99,
      "Name": "Teste",    
      "Cpf": "01234567890",   
      "Email": "teste@teste.com",
      "Diagnostics":[
           "E-mail de Alto Risco",
           "Cliente Digital"
      ]
}

Variáveis de retorno
Nome Descrição Tipo
ID ID da análise da proposta Int
OrderID ID da proposta enviado pelo cliente String
Score Score da proposta, cujos valores possíveis são de 0 à 99 Int
Name Nome do cliente da proposta String
CPF CPF do cliente da proposta String
Email E-mail do cliente da proposta String
Diagnostics Diagnósticos da proposta. Com as seguintes opções possíveis:

POSITIVOS:
• Dados possuem confiança no mercado
• Email conhecido no mercado
• Cliente Digital

NEGATIVOS:
• Dados com histórico de reprovação
• Dados está com alta recorrência no mercado
• IP possui comportamento diferenciado
• Comprador com perfis distintos
• Risco e-mail alto
• Conjectura de alto risco
• Região envolvida em comportamento de ataque
• Email envolvido em comportamento de ataque
• Dados relacionados envolvidos em comportamento de ataque
• Device Arriscado
 Lista de Diagnósticos