Las tarjetas son instrumentos que simulan la representación virtual de una tarjeta física. Al agregar una nueva tarjeta, se genera un identificador único (ID), con el prefijo ins- seguido por 20 caracteres alfanuméricos.

Características principales

Identificador (ID)

Cada tarjeta recibe un identificador único, estructurado comoins-seguido de una cadena de 20 caracteres alfanuméricos. Este ID se genera automáticamente al momento de crear la tarjeta y permite identificarla de forma exclusiva en el sistema.

Fingerprint (Fingerprint)

El fingerprint es un valor alfanumérico único generado a partir de los datos de la tarjeta. Su propósito es identificar de manera virtual una tarjeta física sin exponer información sensible. Esto permite agrupar tarjetas que pertenecen a la misma entidad física, como el caso de tarjetas emitidas para una misma cuenta, sin revelar datos privados fuera de un entorno seguro (PCI).

Método de Pago (Payment method)

El método de pago es un atributo que describe el tipo de instrumento de pago. Se representa mediante un valor compuesto por tres partes:

• Tipo de instrumento (ejemplo: CARD)
• Marca (ejemplo: MASTERCARD)
• Tipo de tarjeta (ejemplo: CREDIT

Estado (Status)

El estado de la tarjeta indica si está activa o inactiva. En el futuro, se añadirán más estados como "bloqueada". Los valores actuales son:

• ✅ ACTIVE: La tarjeta está habilitada para su uso.
• ❌ INACTIVE: La tarjeta no está disponible para transacciones.

Validación (Validation)

Este atributo indica si la tarjeta ha sido validada dentro del sistema:

• ✅ VALID: La tarjeta ha pasado el proceso de validación.
• ⏳ PENDING: La tarjeta aún no ha sido validada.

---

Otros atributos importantes

Número de tarjeta (Number)

El número completo de la tarjeta (PAN) no se presenta fuera de un entorno PCI para garantizar la seguridad. Sin embargo, se pueden visualizar algunas partes:

• BIN (Issuer Identification Number): Los primeros 6 u 8 dígitos del PAN, que identifican la entidad emisora de la tarjeta.
• Últimos 4 dígitos (Last Four Digits): Los últimos 4 números del PAN, utilizados para identificar la tarjeta en ciertas transacciones.

Código de verificación de la tarjeta (CVV)

El código de verificación (CVV) solo tiene una vida útil de 3 minutos desde que se genera o se realiza una transacción exitosa. Nunca se muestra fuera de un entorno PCI, asegurando que los datos sensibles de seguridad no sean expuestos.

API reference Tarjetas