Detecção de Fraudes

Esta API tem por objetivo permitir ao emissores de cartões uma maneira de comunicar uma possível fraude identificada no momento da autorização de uma transação. Os Merchants cadastrados na plataforma de APIs da Elo são notificados das possíveis transações fraudulentas identificadas pelo emissor, possibilitando assim a redução do prejuízo aos participantes da transação.

Feito para:  Estabelecimentos ComerciaisAdquirentesFacilitadores

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

Esta API permite ao Emissor ou outros parceiros notificarem a plataforma de apis Elo sobre uma fraude, bem como consultar a situação de suas notificações e de transações que já foram identificadas como fraudes.

Para criar uma notificação de transação fraudulenta é necessário realizar uma chamada através da mutation createCardFraudTransaction informando os dados da transação:

mutation {
  createCardFraudTransaction(
    input: {
      clientMutationId: "012",
      cardFraudTransaction: {
        codeCapture: 2,
        codeUsage: 71,
        sensitive: null,
        bin: "650497",
        last4: "3456",
        authorization: {
          date: "2018-06-01T00:01:01Z",
          code: "CD123Z1Y",
          decision: "Auth Decision Value"
        },
        legalId: "16277643000119",
        merchantName: "merchant test Name",
        iso: 7,
        acquirerId: "185f2ea4-8141-4170-98ec-d6002a41b2b6",
        currency: "BRL",
        value: "123.45",
        installments: 1,
        timestamp: "2018-06-02T00:01:01Z"
      },
      reference: "reference value",
      codePos: 6,
      liability: YES,
      codeEic: "5",
      flaggedAt: "2018-06-03T00:01:01Z",
      arn: 4,
      initiated: CARD_ISSUER,
      settled: "2018-06-04"
    }
  ) {
    clientMutationId
    cardFraudTransaction {
      cardTransaction {
        id
        capture {
          id
          name
          code
        }
        usage {
          id
          name
          code
        }
        merchant {
          name
          legalIds {
            cnpj {
              number
            }
          }
          categories { iso }
        }
        currency
        value
        installments
        status
        bin {
          number
          funding
          product { name }
        }
      }
      last4
      authorization {
        code
        decision
      }
      status
      reference
      codePos
      liability
      codeEic
      arn
      initiated
    }
  }
}

É possível consultar as transações que estão sendo processadas. A partir da consulta a cartões utilizando a query queueFraudTransactions:

{
  cards {
    edges {
      node {
        queueFraudTransactions(
          first: 50          
          filter: {
            cardTransactionId: null
            codeCapture: null
            codeUsage: null
            legalIds: { cnpj: "16277643000119" }
            iso: null
            startTimestamp: "2018-01-01T00:01:01Z"
            endTimestamp: "2018-12-31T00:01:01Z"
          }
        ) 
        {
          totalCount
          edges {
            node {
              cardTransaction {
                id
                capture {
                  id
                  name
                  code
                }
                usage {
                  id
                  name
                  code
                }
                merchant {
                  name
                  legalIds {
                    cnpj { number }
                  }
                  categories { iso }
                }
                currency
                value
                installments
                status
                timestamp
                bin {
                  number
                  funding
                  product { name }
                }
              }
              last4
              authorization {
                date
                code
                decision
              }
              status
              reference
              codePos
              liability
              codeEic
              flaggedAt
              arn
              initiated
              settled
            }
          }
        }
      }
    }
  }
}

Para consultar as transações que já foram processadas e confirmadas como fraudulentas utilize a partir da consulta a cartões a query fraudTransaction:

{
  cards {
    edges {
      node {
        fraudTransactions(
                    first: 50, 
                    filter: {
                        cardTransactionId: null, 
                        codeCapture: null, 
                        codeUsage: null, 
                        legalIds: {
                            cnpj: "16277643000119"
                        }, 
                        iso: null, 
                        startTimestamp: "2018-01-01T00:01:01Z", 
                        endTimestamp: "2018-12-31T00:01:01Z"
                    }
                ) {
          totalCount
          edges {
            node {
              cardTransaction {
                id
                capture {
                  id
                  name
                  code
                }
                usage {
                  id
                  name
                  code
                }
                merchant {
                  name
                  legalIds {
                    cnpj { number }
                  }
                  categories { iso }
                }
                currency
                value
                installments
                status
                timestamp
                bin {
                  number
                  funding
                  product { name }
                }
              }
              last4
              authorization {
                date
                code
                decision
              }
              status
              reference
              codePos
              liability
              codeEic
              flaggedAt
              arn
              initiated
              settled
            }
          }
        }
      }
    }
  }
}