Detecta a bandeira de um cartão pelo BIN

GET/v1/utils/card-bin-validation

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros de consulta

numberingstringobrigatório
Os 6+ primeiros dígitos do cartão (BIN), ou o número inteiro.
lookupboolean
true também consulta o BIN no registro de emissores (banco, tipo, país). Desligado por padrão.

200Sucesso

binstringobrigatório
O BIN (primeiros dígitos) que foi conferido.
brandstringobrigatório
Bandeira detectada (ex.: visa, mastercard).
intelobjectobrigatóriopode ser nulo
Dados do registro de emissores; null a não ser com lookup=true e o registro respondendo.
+5 campos de intel
- bankstringobrigatóriopode ser nulo
  Banco emissor.
- typestringobrigatóriopode ser nulo
  credit, debit ou prepaid.
- schemestringobrigatóriopode ser nulo
  Bandeira do cartão (ex.: visa).
- countrystringobrigatóriopode ser nulo
  País do emissor.
- categorystringobrigatóriopode ser nulo
  Categoria do cartão (ex.: classic, platinum).
validbooleanobrigatório
Se o BIN pertence a uma bandeira conhecida.
_linksobject
Links para operações relacionadas, por ação (self, create, update, delete, list…).
lengthintegerobrigatório
Quantidade de dígitos recebidos.
merchantobject
A conta dona do recurso (o vendedor de registro).
+3 campos de merchant
- namestringobrigatóriopode ser nulo
  Nome fantasia da conta dona do recurso.
- merchantIdstringobrigatóriopode ser nulo
  Id público da conta dona do recurso (bus_…).
- isSubAccountbooleanobrigatório
  true quando o recurso pertence a uma sub-conta operada por uma plataforma de marketplace.
luhnValidbooleanobrigatóriopode ser nulo
Se o número inteiro passa na verificação de Luhn; null quando só um BIN foi enviado.

400Requisição inválida (validação)

401Não autenticado (credencial ausente ou inválida)

500Erro interno do servidor