Docs: BIN Lookup

Consulta BIN/IIN de tarjeta: marca, tipo, emisor, país.

Financiero PRODUCCION 🧪 Mocks disponibles — usa una key Sandbox para probar sin costo

La ruta publica muestra estructura y parametros. El dominio productivo y las colecciones ejecutables se habilitan al iniciar sesion.

POST /call/fin-bin/2.0.0/bin_consulta desde $3.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
bin	BODY	STRING	Sí	Los primeros 6 a 11 dígitos de la tarjeta. Nunca el número completo.

Ejemplos de código

curl -X POST \
  "/call/fin-bin/2.0.0/bin_consulta" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"bin": "411111"}'

import requests

url = "/call/fin-bin/2.0.0/bin_consulta"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"bin": "411111"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/fin-bin/2.0.0/bin_consulta", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"bin": "411111"}),
});
const data = await response.json();
console.log(data);

Ejemplo Respuesta

{"data": {"bin": "411111", "emisor": "BBVA MEXICO", "producto": null, "red_pago": "VISA", "categoria": "STANDARD", "pais_iso2": "MX", "resultado": {"estado": "ok", "motivos": []}, "encontrado": true, "pais_nombre": "MEXICO", "bin_longitud": 6, "tipo_tarjeta": "CREDIT"}, "errors": [], "estatus": "OK", "request_id": "00000000-0000-00"}

POST /call/fin-bin/1.0.0/bin_consulta desde $3.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
BIN	BODY	STRING	Sí

Ejemplos de código

curl -X POST \
  "/call/fin-bin/1.0.0/bin_consulta" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/fin-bin/1.0.0/bin_consulta"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/fin-bin/1.0.0/bin_consulta", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

BIN Lookup fin-bin

Parámetros

Ejemplos de código

Ejemplo Respuesta

Parámetros

Ejemplos de código