Consultar BIN do cartão

Ambiente	Método	Endpoint
Sandbox	get	`https://apiquerysandbox.cieloecommerce.cielo.com.br/1/cardBin/{BIN}`
Produção	get	`https://apiquery.cieloecommerce.cielo.com.br/1/cardBin/{BIN}`

ℹ️
Saiba mais sobre essa funcionalidade na documentação.

⚠️
Importante

Para habilitar a Consulta BIN, entre em contato com a equipe de suporte da Cielo;

Alguns BINs ou bandeiras podem não ter o retorno das informações do cartão;

Se a API retornar o código de erro 323, entre em contato com o Atendimento para habilitar a funcionalidade.

ℹ️
Para usar a Consulta BIN em sandbox, confira os cenários de simulação em Consulta BIN em sandbox.
Em sandbox, os valores retornados são simulações e não validações reais de BINS. Considere apenas o retorno da requisição e o seu formato. Para identificação real dos BINS, use o ambiente de produção.

Resposta da consulta BIN

A API irá retornar as seguintes propriedades da Consulta BIN:

Parâmetro	Descrição	Tipo	Tamanho
`Status`	Status da requisição de análise de Bins: 00 – Análise autorizada 01 – Bandeira não suportada 02 – Cartão não suportado na consulta de bin 73 – Afiliação bloqueada	string	2
`Provider`	Bandeira do cartão.	string	255
`CardType`	Tipo do cartão em uso : Crédito Débito Múltiplo	string	20
`ForeingCard`	Se o cartão é emitido no exterior (true/false).	boolean
`CorporateCard`	Se o cartão é corporativo (true/false).	boolean
`Issuer`	Nome do emissor do cartão.	string	255
`IssuerCode`	Código do emissor do cartão.	string	255
`Prepaid`	Retornará "true" caso o cartão seja do tipo pré-pago.	boolean