get https://apiquerysandbox.cieloecommerce.cielo.com.br/1/cardBin/
Consulta o BIN (seis a nove primeiros dígitos do cartão) e retorna informações 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 | - |