POST AI agent ready /v1/bin/lookup

API de búsqueda de BIN: emisor de tarjeta, tipo y país de BIN/IIN

Acepta los primeros 6 a 8 dígitos de una tarjeta de pago (BIN o IIN) y devuelve el esquema de la tarjeta (Visa, Mastercard, etc.), tipo de tarjeta (débito/crédito), marca, datos del banco emisor, país de emisión y si la tarjeta es prepaga.

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

Detección de fraude en pagos

Compare el país BIN con el país de la dirección de facturación enviada por el cliente. Una discrepancia (por ejemplo, una tarjeta lituana utilizada con una dirección de facturación de EE. UU.) es una fuerte señal de fraude. Enrute las transacciones marcadas mediante revisión manual o verificación 3D Secure.

UX de pago dinámico

A medida que el usuario escribe su número de tarjeta, busque el BIN después de 6 dígitos. Muestre el logotipo de la tarjeta correcta (Visa, Mastercard), seleccione automáticamente el tipo de tarjeta y muestre el nombre del banco emisor. Esto reduce los errores de entrada y genera confianza en el flujo de pago.

Restricciones de tarjetas prepago

Algunos comerciantes o servicios de suscripción bloquean las tarjetas prepagas para reducir la deserción y el abuso de reembolsos. Verifique el campo prepago durante la validación de la tarjeta y muestre un mensaje claro solicitando al cliente que use una tarjeta no prepago.

Frequently asked questions

¿Qué es un BIN/IIN?

Un número de identificación bancaria (BIN), también llamado número de identificación del emisor (IIN), son los primeros 6 a 8 dígitos de un número de tarjeta de pago. Identifica la red de tarjetas (Visa, Mastercard), banco emisor, tipo de tarjeta y país de emisión.

¿Es seguro transmitir los primeros 6 a 8 dígitos?

Sí. PCI DSS permite almacenar y transmitir los primeros 6 y últimos 4 dígitos de un número de tarjeta en texto sin formato. El BIN por sí solo no se puede utilizar para realizar un pago o identificar al titular de una tarjeta.

¿Qué esquemas de tarjetas son compatibles?

La base de datos cubre Visa, Mastercard, American Express, Discover, JCB, UnionPay, Diners Club, Maestro y otros esquemas regionales. La cobertura varía según la región, pero incluye la gran mayoría de las tarjetas en circulación activa.

¿Puede el campo del banco ser nulo?

Sí. Es posible que algunos rangos de BIN, especialmente para las fintech más nuevas o los emisores de tarjetas virtuales, no tengan el nombre del banco o los datos de la URL. El objeto bancario siempre está presente, pero los campos individuales que contiene (nombre, URL, teléfono) pueden ser nulos.

¿Qué tan actualizada está la base de datos BIN?

La base de datos BIN se actualiza mensualmente con nuevos rangos de redes de tarjetas. Se agregan nuevos programas de tarjetas de fintechs o bancos regionales a medida que estén disponibles en los registros públicos BIN.

Get your API key

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