Verificação de Conta Credenciador

A API de Verificação de Conta Credenciadores habilita um mecanismo facilitado e seguro para validar a existência de uma conta cartão do portador ELO.

Feito para:  CredenciadoresSubcredenciadores

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

A API de Verificação de Conta Credenciador tem como principal objetivo oferecer serviços para verificação do status da conta cartão de um portador em compras de cartão não presente. Existem muitas utilidades para o uso da API, como a validação do portador antes de realizar uma transação de transferência de fundo, ou até mesmo validar a conta cartão antes de armazená-la em uma carteira digital ou em um repositório seguro.

O mecanismo mais comum para a verificação de conta é realizar uma transação conhecida como transação Zero Dólar. Utilizada em transações e-commerce, esta verificação da existência e condições de uso do cartão é feita através de uma transação tradicional, porém, com um valor baixo, que posteriormente precisa ser estornado pelo solicitante. A API vem para resolver esse problema, fornecendo uma forma de verificar a conta cartão com uma única transação e sem sensibilizar o limite desta conta.

Para realizar a verificação de conta do cartão, é preciso utilizar a mutation verifyPaymentAccount (demonstrada abaixo), informando um client_id válido, e também um sensitive - campo que referencia todos os dados sensíveis de um cartão, como descrito na documentação de cartão.

mutation{
  verifyPaymentAccount(
    input:{
      clientMutationId: "1234"
      legalIds: { #Campo opcional
        cpf: "11684158613"
      }
      sensitive: "eyJhbGciOiJFQ0RILUVTIiwiZW5jIjoiQTEyOENCQy1IUzI1NiIsImVway..."
      type: CREDIT #CREDIT ou DEBIT
      acquirer: {
        id: 123
        code: "123"
        countryCode: "076"
      }
      merchant: {
        idCode: "123"
        name: "Teste"
        legalName: "Teste LTDA"
        legalIds:{
          cnpj: "121212121212121"
        }
        contact:{
          type: PHONE
          context: "Trabalho"
          value: "+5511999991111"
        }
        address:{
          country: "Brasil"
          city: "São Paulo"
          state: "São Paulo"
          zip: "123456788"
          number: 1234
          place: "Paulista"
        }
        iso: 1111
        countryCode: "076"
      }
    }
  )
  {
    verifyPaymentAccount{
        status
      verifiedAt
    }
  }
}

Você pode executar consultas para verificações já efetuadas anteriormente utilizando a seguinte query, e passando novamente o client_id no cabeçalho da requisição:

query {  
  verifyPaymentAccounts
  {
    pageInfo {
      hasPreviousPage
      hasNextPage
      startCursor
      endCursor
    }
    totalCount
    edges {
      cursor
      node {
        status,
        verifiedAt
      }
    }
  }
}