Validación de Tarjetas de Crédito

Valida números de tarjetas de crédito utilizando el algoritmo de Luhn e identifica la marca de la tarjeta. Incluye consulta BIN para obtener el banco emisor y la categoría de la tarjeta. No se realizan cargos, autorizaciones ni conexiones a redes de pago.

Endpoint

POST /api/v1/creditcard/validate

Autenticación

Todas las solicitudes requieren una API key enviada mediante el header X-Api-Key.

Cuerpo de la Solicitud

Campo	Tipo	Obligatorio	Descripción
cardNumber	string	Sí	Número de tarjeta de crédito (solo dígitos o con espacios/guiones)

{
  "cardNumber": "4539578763621486"
}

Respuesta

{
  "valid": true,
  "luhnValid": true,
  "cardBrand": "Visa",
  "lastFourDigits": "1486",
  "cardType": "CREDIT",
  "issuingBank": "Chase",
  "cardCountry": "US",
  "cardCategory": null
}

Campos de la Respuesta

Campo	Tipo	Descripción
valid	boolean	Validez general (verificación Luhn correcta y marca reconocida)
luhnValid	boolean	Si el número pasa el algoritmo de checksum de Luhn
cardBrand	string	Marca de tarjeta detectada (ver tabla inferior)
lastFourDigits	string	Últimos cuatro dígitos del número de tarjeta
cardType	string	Tipo de tarjeta según consulta BIN (CREDIT, DEBIT o PREPAID)
issuingBank	string	Nombre del banco emisor (mediante consulta BIN)
cardCountry	string	País del banco emisor (ISO 3166-1 alpha-2)
cardCategory	string	Nivel de categoría de la tarjeta (no disponible actualmente; reservado para uso futuro)

Marcas de Tarjetas

Marca	Patrón de Prefijo
Visa	Comienza con 4
MasterCard	Comienza con 51-55 o 2221-2720
AmericanExpress	Comienza con 34 o 37
Discover	Comienza con 6011 o 65
DinersClub	Comienza con 300-305, 36 o 38
JCB	Comienza con 3528-3589
Unknown	Prefijo no reconocido

Tipos de Tarjeta

Tipo	Descripción
CREDIT	Tarjeta de crédito
DEBIT	Tarjeta de débito
PREPAID	Tarjeta prepago

Ejemplo

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cardNumber": "4539578763621486"}' \
  "https://api.iqxlookup.neivi.es/api/v1/creditcard/validate"

Notas

• Este endpoint realiza únicamente validación estructural -- no contacta redes de pago ni procesa transacciones
• Los números de tarjeta se sanitizan: espacios, guiones y otros caracteres no numéricos se eliminan antes de la validación
• El número completo de la tarjeta nunca se devuelve en la respuesta; solo se incluyen los últimos cuatro dígitos
• Los números de tarjeta no se registran ni almacenan