Verificação risco de fraude

Esta API permite a avaliação do risco de fraude baseado no comportamento de consumo e transações do portador de cartão. Pode ser utilizada no processo de abertura de contas.

Feito para:  AdquirentesEmissores

Como funciona

Primeiros passos

  1. Leia Introdução ao GraphQL, com exemplos reais da nossa API.

  2. Crie um usuário no portal do desenvolvedor.

  3. Cadastre sua primeira aplicação.

  4. Utilize o dashboard para acessar suas configurações de acesso.

  5. Para explorar rapidamente as APIs aqui na página de documentação, use o console de GraphQL, na seção de referências. Nele, você pode ver as consultas de exemplo, executá-las e alterá-las.

Primeiros passos na plataforma de Desenvolvedores Elo

Jaydson GomesDesenvolvedor Evangelista

Para efetuar consultas de avaliação de risco de fraude é necessário ter um usuário cadastrado na plataforma de APIs e estar registrado como Card Issuer ou Acquirer.

O recurso Risk Score é uma consulta que retorna um score e digitalLevel de um CPF baseada no consumo de pedidos e do comportamento de compras online. O Objeto score retornará alguns campos com uma numeração entre 0 e 1000. Quanto maior a pontuação do score retornado, melhor a reputação do CPF e menor a chance de fraude o CPF informado possui em transações online.

No objeto score somente um campo que não retornará a pontuação. O campo spendingIndex irá retornar um indicador que pode variar de "A" até "H", sendo "A" o de maior capacidade e o "H" de menor capacidade de consumo

Para a consulta de um score, deve ser informado apenas o CPF para que a análise possa ser realizada com sucesso. Nesta consulta é utilizada a query verifyRiskScore.

No header é preciso informar o client_id do aplicativo e o access_token obtido no login da plataforma de APIs da Elo

query {
    verifyRiskScore(cpf: "123456789"){
        digitalLevel
        score {
            value
            spendingIndex
            digitalVarietyRisk
            digitalBehaviourRisk
            profileRisk
            statusRisk
            postalRisk
            rapportRisk
        }
    }
}


Resposta


O objeto score irá retornar valores referente ao score do cliente. Os valores retornados estão entre 0 e 1000.

  • value: Score de risco

  • spedingIndex: Indicador que pode variar de "A" até "H"

  • digitalVarietyRisk: Relacionado a variação (produtos, segmentos) de compras do cliente em transações de cartão não presente (compras online)

  • digitalBehaviourRisk: Risco relacionado ao comportamento de compras de cartão não presente

  • profileRisk: Score de risco relacionado ao perfil do CPF informado

  • statusRisk: Score de risco relacionado ao status do CPF informado

  • postalRisk: Score de risco relacionado a informações postais do CPF informado

  • rapportRisk: Score de risco de relacionamento do CPF informado

O recurso Data Score é uma análise de um score baseado no cruzamento das informações de CPF, Telefone, Email, CEP e Dispositivo. Com essas informações será retornada uma resposta elaborada contendo o risco de fraude. O score sempre retornará um número entre 0 e 100 e, quanto maior a pontuação do score, maior a chance de fraude das informações possuem em transações online.

Para a consulta de um score baseado no cruzamento de informações é necessário utilizar a mutation VerifyDataScore, que retornará um score

O objeto legalId e o campo transactionType são obrigatórios, os demais campos são opcionais.

O campo transactionType possui dois tipos que são PRESENCIAL e ONLINE. Caso for informado ONLINE, será necessário informar o deviceId.

No header é preciso informar o client_id do aplicativo e o access_token obtido no login da plataforma de APIs da Elo

mutation {
  verifyDataScore(input: {
    legalId: {
      cpf: "12345678901"
    }
    contact: {
      areaCode: "11"
      phone: "926468112"
    }
    address: {
      zip: "13086510",
      place: "Rua Doutor Ricardo Benetton Martins",
      number: 1,
      complement: "Prédio 3, Piso 1",
      district: "Barão Geraldo",
      city: "Campinas",
      state: "São Paulo",
      country: "Brasil",
      physicalDelivery: false
    }
    email: "teste@email.com.br",
    deviceId: "SessionID",
    transactionType: PRESENCIAL
  })
  {
    score
  }
}