Logo

BINinfo

Version: v1

Description: Obtiene la informacion del BIN/IIN de tarjetas de credito y debito.

BIN Check API

Esta es una API REST sencilla basada en PHP que expone un único endpoint (/checkbin) para validar y consultar información de números BIN (Bank Identification Number).

Uso

Endpoint

GET /checkbin?bin={BIN_NUMERICO}

Parámetros

Ejemplo de Petición

bash
curl -i "http://api.latinapi.com/api/bininfo/checkbin?bin=457173" -H "X-Api-Key: TU_LLAVE_API_PRIVADA"

Ejemplo de Respuesta Exitosa (200 OK)

La respuesta es un objeto JSON debidamente codificado.

json
{
  "bin": "457173",
  "bank_name": "Jyske Bank A/S",
  "country": "Denmark",
  "country_iso": "DK",
  "scheme": "visa",
  "type": "debit",
  "url": "www.jyskebank.dk"
}

Ejemplos de Respuesta de Error (4xx/5xx)

Parámetro faltante o no válido (400 Bad Request)

json
{

  "error": "Invalid bin parameter. Must be exactly 6 digits."

}

BIN No Encontrado o inválido (400 Bad Request)

json
{

  "message": "no results found"

}

Ejemplos de Integración

Aquí tienes algunos ejemplos de cómo consumir la API desde diferentes lenguajes y herramientas:

cURL (Línea de Comandos)

bash
curl -X GET "http://api.latinapi.com/api/bininfo/checkbin?bin=457173" \
     -H "Accept: application/json" \
     -H "X-Api-Key: TU_LLAVE_API_PRIVADA"

PHP (usando cURL)

php
<?php
$bin = '457173';
$url = "http://api.latinapi.com/api/bininfo/checkbin?bin={$bin}";


$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_setopt($ch, CURLOPT_HTTPHEADER, [

    'Accept: application/json',

    'X-Api-Key: TU_LLAVE_API_PRIVADA'

]);



$response = curl_exec($ch);

$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

curl_close($ch);



if ($httpCode === 200) {

    $data = json_decode($response, true);

    print_r($data);

} else {

    echo "Error: HTTP {$httpCode}\n{$response}";

}

?>

JavaScript (Fetch API)

javascript
const bin = '457173';
const url = `http://api.latinapi.com/api/bininfo/checkbin?bin=${bin}`;


fetch(url, {

    method: 'GET',

    headers: {

        'Accept': 'application/json',

        'X-Api-Key: TU_LLAVE_API_PRIVADA'

    }

})

.then(response => {

    if (!response.ok) {

        throw new Error(`HTTP error! status: ${response.status}`);

    }

    return response.json();

})

.then(data => console.log('Datos del BIN:', data))

.catch(error => console.error('Error:', error));

Python (usando requests)

python
import requests


bin_number = '457173'

url = f"http://api.latinapi.com/api/bininfo/checkbin?bin={bin_number}"



headers = {

    'Accept': 'application/json',

    'X-Api-Key: TU_LLAVE_API_PRIVADA'

}



response = requests.get(url, headers=headers)



if response.status_code == 200:

    data = response.json()

    print("Datos del BIN:", data)

else:

    print(f"Error: HTTP {response.status_code}")

    print(response.text)