Elo Valida Dados

A Elo Valida Dados permite fazer uma 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 Profile 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 verifyProfileScore.

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

query {
    verifyProfileScore(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
  }
}



Argumentos:

cpf: String obrigatório

Número do Cadastro de Pessoa Fisica do cliente sem hifen e ponto.






Mutation responsável por realizar a verificação do score do cliente conforme informações enviadas para Clear Sale.

Argumentos:

input: VerifyDataScoreInput obrigatório






Campos:

cpf

:

String obrigatório

Número do CPF (dígitos) sem hífen ou pontos.



Campos:

areaCode

:

String

Código de área do telefone do cliente


phone

:

String

Número do telefone do cliente



Campos:

zip

:

String

Código postal.


place

:

String

Nome da via, compondo as informações do endereço.


number

:

Int

Número da construção


complement

:

String

Complemento opcional, como número de apartamento.


district

:

String

Distrito


city

:

String

Nome da cidade em UTF-8


state

:

String

Nome do estado por completo. Exemplo: SP, RJ ...


country

:

String

Nome do país Exemplos: Brasil, Chile...


physicalDelivery

:

Boolean

Indicador para entrega física do pedido.



Campos:

legalId

:

LegalIdsPersonInput obrigatório

Número do Cadastro de Pessoa Fisica do cliente sem hifen e ponto.


contact

:

ContactPersonInput

Informação do contato telefonico do cliente


address

:

AddressScoreInput

Endereço do cliente o qual está sendo consultado o score.


email

:

String

Email do cliente. Exemplo: joao.silva@email.com.


deviceId

:

String

Identificador único do device.


transactionType

:

TransactionScoreType obrigatório

Indica o tipo da transação. Caso for informado o typeTransaction = ONLINE , será preciso informar o deviceId

  • 1- PRESENCIAL

  • 2- ONLINE






Campos:

value

:

Int

Score de risco - Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).


spendingIndex

:

String

Esse indicador pode vaariar de "A" até "H", sendo "A" o de maior capacidade e o "H" de menor capacidade de consumo


digitalVarietyRisk

:

Int

Relacionado a variação (produtos, segmentos) de compras do cliente em transações de cartão não presente (compras online) Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).


digitalBehaviourRisk

:

Int

Risco relacionado ao comportamento de compras de cartão não presente Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).


profileRisk

:

Int

Score de risco relacionado ao perfil do CPF informado Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).


statusRisk

:

Int

Score de risco relacionado ao status do CPF informado Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).


postalRisk

:

Int

Score de risco relacionado a informações postais do CPF informado Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).


rapportRisk

:

Int

Score de risco de relacionamento do CPF informado Nota que vai de 0 a 1000 (quanto maior o score, melhor é a reputação).



Dados de validação de score do cliente.

Campos:

digitalLevel

:

Boolean

Se as informações de risco do CPF foram calculadas baseado em comportamentos de compras de cartão não presente (compras online).


score

:

ScoreClientRisk

Valores referente ao Score do cliente retornado pela Clear Sale.



Retorno da mutation VerifyDataScorePayload()

Campos:

score

:

String

Score de risco - Nota que vai de 0 a 100 (quanto menor a nota, melhor a reputação)






Valores possíveis:


PRESENCIAL

Informação de transação realizada presencialmente.


ONLINE

Informação te transação realizado por meio de algum meio online.