Elo Emailage - Verificação do risco de e-mail

Esta API permite a avaliação de risco de fraudes da credencial de e-mails. Pode ser utilizada no processo de abertura de contas, manutenção de contas, cadastros, transacional, etc.

Feito para:  Estabelecimentos ComerciaisEmissoresCredenciadoresSubcredenciadores

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 email é necessário ter um usuário cadastrado na plataforma de APIs e estar registrado como Card Issuer, Acquirer ou Merchant.

Na query é possível informar o email, ip e o parâmetro rapid. O email deve ser informado no padrão correto para que a análise possa ser realizada com sucesso.

O IP não é obrigatório, porém pode nos ajudar a avaliar melhor o email informado.

Caso haja a necessidade de obter uma resposta rápida e efetiva para fins de aprovação ou avaliação de risco, basta fornecer o parâmetro rapid para que a API retorne um score rapidamente.

Veja abaixo um exemplo que deve ser executado passando no header da chamada o client_id do aplicativo e o access_token obtido no login da plataforma de APIs da Elo.

query{
    verifyEmailScore(
        email: "teste@teste.com.br"
        ip: "192.168.10.5"
        rapid: false
    )
    {
        score
        reason
        description
    }
}

O campo score é retornado como um valor inteiro entre 0 e 1000, sendo 0 o menor risco de fraude envolvendo o email e IP informados. Dentro da faixa do score existem categorias que poderão ajudar na tomada de decisão em seu sistema (entre parênteses estão as sugestões de tomada de decisão para cada pontuação):

  • De 0 a 100: Risco Muito Baixo (Aprovar a transação)

  • De 101 a 300: Risco Baixo (Considerar aprovação)

  • De 301 a 600: Risco Moderado (Risco neutro)

  • De 601 a 800: Revisão (Corrigir cadastro de usuário)

  • De 801 a 900: Risco Alto (Considerar revisão manual)

  • De 901 a 1000: Risco Muito Alto (Enviar para revisão manual)




Argumentos:

email: String obrigatório

Endereço de email valido

ip: String

Endereços de rede IPv4 ou IPv6 de onde partiu a solicitação de criação.

Se for IPv6, deve estar entre colchetes. Exemplo: [::1] Se for IPv4, deve seguir a notação com pontos: 127.0.0.1

rapid: Boolean

Identifica que a consulta irá retornar de forma mais rápida, porém as verificações para gerar o score, são pesquisadas em menos pontos. O valor default é false.






Dados de validação de score de email

Campos:

score

:

Int obrigatório

Score de risco - Nota que vai de 0 a 999 (quanto maior a nota, maior o risco de fraude)


reason

:

String obrigatório

Informação relevante. Principal motivo que levou a Emailage a atribuir o Score de Risco.


description

:

String

Descrição