Consulta de BIN

GET/api/v1/bank/wallet/bin/{card_bin}/Bearer Token

---

Cabeçalhos da requisição

Cabeçalho	Valor	Obrigatório
Authorization	Bearer {A55_ACCESS_TOKEN}	Sim

Parâmetros de caminho

Campo	Tipo	Obrigatório	Descrição
card_bin	string	Sim	Primeiros 6 a 8 dígitos do número do cartão (ex.: 402400)

---

Campos da resposta

Campo	Tipo	Descrição
bin	string	Dígitos do BIN consultado
brand	string	Bandeira do cartão: visa, mastercard, amex, elo, hipercard, diners
type	string	credit, debit, prepaid
category	string	classic, gold, platinum, black, infinite, business, corporate
issuer	string	Nome do banco emissor
country	string	Código do país ISO 3166-1 alpha-2
country_name	string	Nome completo do país

---

Códigos de status HTTP

Status	Descrição
200	BIN encontrado
400	Formato de BIN inválido (deve ter 6-8 dígitos)
401	Token Bearer inválido ou expirado
404	BIN não encontrado no banco de dados
429	Limite de requisições excedido
500	Erro interno do servidor

---

Exemplos de código

cURL

curl -s -X GET "https://core-manager.a55.tech/api/v1/bank/wallet/bin/402400/" \
  -H "Authorization: Bearer $A55_ACCESS_TOKEN"

Python

import requests
import os

token = os.environ["A55_ACCESS_TOKEN"]
base = os.environ.get("A55_API_URL", "https://core-manager.a55.tech")

card_bin = "402400"

try:
    response = requests.get(
        f"{base}/api/v1/bank/wallet/bin/{card_bin}/",
        headers={"Authorization": f"Bearer {token}"},
    )
    response.raise_for_status()
    info = response.json()
    print(f"Brand: {info['brand']} | Type: {info['type']} | Issuer: {info['issuer']}")
    print(f"Category: {info['category']} | Country: {info['country_name']}")
except requests.exceptions.HTTPError as e:
    print(f"HTTP {e.response.status_code}: {e.response.json()}")
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

Node.js

const token = process.env.A55_ACCESS_TOKEN;
const base = process.env.A55_API_URL || "https://core-manager.a55.tech";

const cardBin = "402400";

try {
  const response = await fetch(`${base}/api/v1/bank/wallet/bin/${cardBin}/`, {
    headers: { Authorization: `Bearer ${token}` },
  });

  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  const info = await response.json();
  console.log(`Brand: ${info.brand} | Type: ${info.type} | Issuer: ${info.issuer}`);
  console.log(`Category: ${info.category} | Country: ${info.country_name}`);
} catch (error) {
  console.error("BIN lookup failed:", error.message);
}

---

Exemplo de resposta de erro

{
  "status": "error",
  "message": [
    {
      "code": "BIN_NOT_FOUND",
      "source": "bin_lookup",
      "description": "No data found for BIN 999999"
    }
  ]
}

---

Tokenizar cartão →Armazene o cartão para cobranças futuras.Criar cobrança →Cobre um cartão com os dados completos.Zero-auth →Valide um cartão sem efetuar cobrança.