Cielo Bin Query

O “Consulta de Bins” é um serviço de pesquisa de dados do cartão, de crédito ou débito, que retorna ao lojista da API Cielo e-Commerce informações que permitem validar os dados preenchidos na tela do checkout.

O serviço retorna os seguintes dados sobre o cartão:

• Bandeira do cartão: Nome da Bandeira
• Tipo de cartão: Crédito, Débito ou Múltiplo (Crédito e Débito)
• Nacionalidade do cartão: Estrangeiro ou Nacional
• Cartão Corporativo: Se o cartão é ou não é corporativo
• Banco Emissor: Código e Nome
• Essas informações permitem tomar ações no momento do checkout para melhorar a conversão da loja.

O Consulta Bin deve ser habilitado pelo Suporte Cielo. Entre em contato com a equipe de Suporte e solicite a habilitação para sua loja.

Instalação

Dependências

Adicione esta dependência ao build.gradle do seu módulo dentro do nó dependencies

dependencies {
    ...
    implementation 'br.com.cielo:cielo-bin-query:1.0.0'
}

Não esqueça de verificar se jcenter() está configurado como repositório.

• Ou baixe cielo-bin-query-release.aar de releases, mova para a pasta libs do seu módulo e adicione esta dependência ao build.gradle do seu módulo dentro do nó dependencies

dependencies {
    ...
    implementation files('libs/cielo-bin-query-release.aar')
}

Internet Permission

É necessário ter adicionado ao AndroidManifest.xml do seu módulo a seguinte permissão:

    <uses-permission android:name="android.permission.INTERNET" />

Utilização

Inicialização

É necessário ter uma instância de BinQuery

val binQuery = BinQuery(
    merchantId = "MERCHANT-ID",
    clientId = "CLIENT-ID",
    clientSecret = "CLIENT-SECRET",
    environment = Environment.SANDBOX
)

Consulta

A consulta ocorre através do método query, para isto, basta informar o bin do cartão, OAuth Token, um callback de sucesso e um callback de erro:

binQuery.query("001040") {
  // Callback
}