Cómo usar la API de verificación de tarjetas

Tu proceso de pago necesita marcar BINs inválidos antes de que toques las vías de pago. Al final de esta guía, validarás BINs y leerás instantáneamente la marca de la tarjeta, tipo, nivel, emisor y país utilizando una sola solicitud HTTP GET a la API de verificación de tarjetas en Zyla API Hub—listo para pegar en tu backend hoy.

Lo que esta API te ofrece

La API de verificación de tarjetas devuelve la validación para un BIN de tarjeta (Número de Identificación Bancaria; los primeros 6 dígitos) y campos de enriquecimiento que puedes usar inmediatamente para enrutamiento, detección de fraude y experiencia de usuario:

Ilustración: Cómo usar la API de verificación de tarjetas

isValid y message para confirmar si el BIN proporcionado es reconocido
card_brand (por ejemplo, MASTERCARD), card_type (CREDIT/DEBIT) y card_level (por ejemplo, GOLD)
issuer_name_bank, issuer_bank_phone, issuer_bank_website
iso_country_name y iso_country_code

Es un único endpoint con un solo parámetro requerido, diseñado para una integración rápida en flujos financieros como el proceso de pago, enrutamiento de PSP, reglas basadas en BIN y mensajería específica del emisor para clientes.

Comenzando en Zyla API Hub

Zyla API Hub agrega más de 10,000 APIs públicas bajo una sola cuenta, una clave API y un modelo de suscripción + cuota. Para comenzar a usar esta API financiera:

Abre la página de la API de verificación de tarjetas y suscríbete. Hay una prueba de 7 días disponible en la lista. Consulta la página de la API para las opciones de acceso y precios actuales.
Copia tu clave API.
Realiza la llamada al endpoint con el encabezado Authorization: Bearer YOUR_API_KEY.

Inicia la prueba de 7 días en la API de verificación de tarjetas

Descripción general del endpoint

La API de verificación de tarjetas tiene un endpoint:

Método: GET
URL: https://zylalabs.com/api/2333/card-checker-api/2243/check-card
Parámetro de consulta requerido:
- bin (número): un BIN de 6 dígitos. Ejemplo: 444444
Auth: Authorization: Bearer YOUR_API_KEY

En caso de éxito, la respuesta incluye un estado de nivel superior, éxito, isValid, message y un objeto de datos con atributos de emisor y tarjeta.

cURL que puedes ejecutar ahora

Reemplaza YOUR_API_KEY con tu clave de Zyla API Hub y ejecuta:

curl -s -X GET "https://zylalabs.com/api/2333/card-checker-api/2243/check-card?bin=444444" \
-H "Authorization: Bearer YOUR_API_KEY"

Respuesta de muestra oficial

{
"status": 200,
"success": true,
"isValid": true,
"message": "El número BIN es válido.",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURQUÍA",
"iso_country_code": "TR"
}
}

Notas de campo que realmente usarás:

isValid y message: puerta de validación rápida antes de un procesamiento adicional
data.card_brand / data.card_type / data.card_level: reglas de enrutamiento, insignias de UX, lógica de tarifas
data.issuer_name_bank y data.issuer_bank_phone: flujos de soporte conscientes del emisor
data.iso_country_code / data.iso_country_name: lógica regional, verificaciones regulatorias, indicaciones de SCA

Ejemplo en Python (requests)

Este ejemplo llama al mismo endpoint, verifica la validez y ramifica según la marca/tipo para la lógica de enrutamiento.

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BIN = "444444"

url = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"
params = {"bin": BIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()

# Guardrails básicos
if not data.get("success"):
raise RuntimeError(f"La búsqueda falló: {data}")

if not data.get("isValid"):
print(f"BIN {BIN} no es válido: {data.get('message')}")
else:
card = data.get("data", {})
brand = card.get("card_brand")
ctype = card.get("card_type")
level = card.get("card_level")
issuer = card.get("issuer_name_bank")
country = card.get("iso_country_code")

print(f"BIN {BIN} es válido: {brand} {ctype} {level} emitido por {issuer} ({country})")

# Lógica de enrutamiento de ejemplo
if brand == "MASTERCARD" and ctype == "CREDIT":
# Enrutar a un procesador específico o aplicar tarifas/límites
pass

# Lógica de UX de ejemplo
if country == "TR":
# Copia localizada o indicaciones de SCA para tarjetas turcas
pass

Consejos de implementación que ahorran tiempo

Llamadas del lado del servidor solamente. Nunca expongas tu clave API en el código del cliente.
Cachea los resultados de BIN por un corto período para reducir la latencia en el proceso de pago. Los datos de BIN cambian con poca frecuencia, pero siempre diseña para la revalidación.
Valida la longitud de la entrada: acepta solo 6 dígitos numéricos para el bin antes de llamar a la API.
Usa isValid como la primera rama: si es falso, falla rápido y solicita al usuario que verifique su número de tarjeta.
Idempotencia: Esta solicitud GET es segura para reintentar en problemas de red transitorios.

Casos de uso de finanzas en el mundo real

Pre-validación en el proceso de pago: Detecta BINs evidentemente incorrectos antes de inicializar una intención de pago.
Enrutamiento de procesadores: Enruta por card_brand o card_type para optimizar tasas de autorización o tarifas.
Riesgo y cumplimiento: Usa iso_country_code para activar autenticación de paso o negar corredores de riesgo según lo requiera la política.
UX consciente del emisor: Muestra issuer_name_bank o proporciona issuer_bank_phone en flujos de soporte.
Controles de método de pago: Bloquea combinaciones no soportadas (por ejemplo, CREDIT corporativo en ciertas líneas de productos) usando card_level donde sea aplicable.

Llamándolo desde agentes de IA a través de MCP

Si prefieres integrar esto en herramientas de desarrollo de IA (Claude Code, Cursor, Windsurf, o cualquier cliente compatible con MCP), apunta el cliente al endpoint MCP de Zyla y usa tu clave API de Zyla. Tu agente puede entonces invocar la misma capacidad de la API de verificación de tarjetas en segundo plano.

Endpoint MCP: MCP
Clave API: pasa tu clave API de Zyla según lo configurado por tu cliente MCP
Semántica de llamada: realiza la misma solicitud GET al camino check-card con el parámetro bin

Esto mantiene tu flujo de trabajo en el IDE mientras usas el mismo encabezado Authorization: Bearer YOUR_API_KEY y la URL de solicitud exacta mostrada arriba.

Lista de verificación de pruebas

Forma de retorno: Confirma la presencia de status, success, isValid, message y campos de data.* antes de usar los valores.
Validación de entrada: Rechaza BINs no numéricos o no de 6 dígitos antes de acceder a la red.
Timeouts: Establece un tiempo de espera razonable para el cliente HTTP (por ejemplo, 10–15s) y reintenta solo en GETs idempotentes.
Observabilidad: Registra el estado de nivel superior y isValid para triaje; evita registrar PANs completos—solo los primeros 6 dígitos para verificaciones de BIN.
Cacheo: Cachea por BIN; invalida en el despliegue o después de un período de tiempo que se ajuste a tu postura de riesgo.

FAQ

¿Qué parámetro requiere el endpoint?
Un solo parámetro de consulta: bin (número de 6 dígitos). Ejemplo: bin=444444.

¿Cuál es el endpoint exacto y el método?
GET https://zylalabs.com/api/2333/card-checker-api/2243/check-card

¿Cómo me autentico?
Envía Authorization: Bearer YOUR_API_KEY en el encabezado de la solicitud. Obtén tu clave de la página de suscripción de Zyla API Hub para esta API.

¿Qué campos se devuelven?
Estado de nivel superior, éxito, isValid, message y un objeto de datos con bin_iin, card_brand, card_type, card_level, issuer_name_bank, issuer_bank_website, issuer_bank_phone, iso_country_name y iso_country_code.

¿Hay un plan gratuito?
No hay un plan gratuito. Hay una prueba de 7 días disponible en la lista; consulta la página de la API para las opciones de acceso y precios actuales.

Realiza tu validación de BIN hoy. Suscríbete en la lista de la API de verificación de tarjetas, obtén tu clave y coloca la única llamada GET en tu proceso de pago o pipeline de riesgo: Inicia la prueba de 7 días en la API de verificación de tarjetas. Luego expande al resto del catálogo financiero en Zyla API Hub a medida que crece tu hoja de ruta.