POST AI agent ready /v1/bin/lookup

API de pesquisa BIN - Emissor de cartão, tipo e país de BIN/IIN

Aceita os primeiros 6 a 8 dígitos de um cartão de pagamento (BIN ou IIN) e retorna o esquema do cartão (Visa, Mastercard, etc.), tipo de cartão (débito/crédito), marca, dados do banco emissor, país de emissão e se o cartão é pré-pago.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/bin/lookup \
  -H "Content-Type: application/json" \
  -d '{"bin":"45717360"}'

When to use this API

Detecção de fraude de pagamento

Compare o país do BIN com o país do endereço de cobrança enviado pelo cliente. Uma incompatibilidade (por exemplo, um cartão lituano usado com um endereço de cobrança nos EUA) é um forte sinal de fraude. Encaminhe transações sinalizadas por meio de revisão manual ou verificação 3D Secure.

UX de check-out dinâmico

À medida que o usuário digita o número do cartão, procure o BIN após 6 dígitos. Exiba o logotipo correto do cartão (Visa, Mastercard), selecione automaticamente o tipo de cartão e mostre o nome do banco emissor. Isso reduz erros de entrada e cria confiança no fluxo de checkout.

Restrições do cartão pré-pago

Alguns comerciantes ou serviços de assinatura bloqueiam cartões pré-pagos para reduzir a rotatividade e o abuso de reembolso. Verifique o campo pré-pago durante a validação do cartão e exiba uma mensagem clara solicitando ao cliente a utilização de um cartão não pré-pago.

Frequently asked questions

O que é um BIN/IIN?

Um Número de Identificação Bancária (BIN), também chamado de Número de Identificação do Emissor (IIN), são os primeiros 6 a 8 dígitos de um número de cartão de pagamento. Identifica a rede do cartão (Visa, Mastercard), banco emissor, tipo de cartão e país de emissão.

É seguro transmitir os primeiros 6 a 8 dígitos?

Sim. O PCI DSS permite que os primeiros 6 e os últimos 4 dígitos de um número de cartão sejam armazenados e transmitidos em texto simples. O BIN por si só não pode ser usado para efetuar um pagamento ou identificar o titular do cartão.

Quais esquemas de cartão são suportados?

O banco de dados abrange Visa, Mastercard, American Express, Discover, JCB, UnionPay, Diners Club, Maestro e outros esquemas regionais. A cobertura varia de acordo com a região, mas inclui a grande maioria dos cartões em circulação ativa.

O campo banco pode ser nulo?

Sim. Algumas faixas de BIN, especialmente para fintechs mais recentes ou emissores de cartões virtuais, podem não ter nome do banco ou dados de URL. O objeto banco está sempre presente, mas os campos individuais dentro dele (nome, url, telefone) podem ser nulos.

Quão atual é o banco de dados BIN?

A base de dados BIN é atualizada mensalmente com novas faixas das redes de cartões. Novos programas de cartões de fintechs ou bancos regionais são adicionados à medida que ficam disponíveis nos registros públicos do BIN.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.