Saltar al contenido principal
Las huellas digitales de tarjeta son un hash criptográfico del PAN de la tarjeta que identifica de forma única una tarjeta de pago específica. Yuno devuelve este valor como fingerprint en el objeto Payment Method. Cuando un mismo cliente inscribe la misma tarjeta varias veces, Yuno crea inscripciones separadas con valores de vaulted_token distintos, y la huella digital te ayuda a detectar los duplicados. Propiedades clave:
  • Se mantiene constante en múltiples inscripciones de la misma tarjeta
  • Es única para cada número de tarjeta distinto
  • Protege el cumplimiento de PCI al no exponer el número completo de la tarjeta
  • Permite la deduplicación sin almacenar ni acceder a datos sensibles de la tarjeta
No puedes verificar las huellas digitales antes de que el cliente ingrese la información de su tarjeta. Este es un requisito de cumplimiento de PCI.
Alternativa: Muestra las tarjetas guardadas existentes antes del formulario de inscripción para que los clientes vean lo que ya tienen guardado.

Cómo funciona

La misma tarjeta, múltiples inscripciones

Tarjetas diferentes

Por qué se producen inscripciones duplicadas

Para evitar problemas operativos, Yuno no impide automáticamente las inscripciones duplicadas de tarjetas. Cuando un cliente inscribe la misma tarjeta varias veces:
  • Cada inscripción crea un nuevo vaulted_token
  • No se realiza ninguna deduplicación automática
  • Esto aplica sin importar si cambian la fecha de vencimiento o la información del titular de la tarjeta
Implementa la deduplicación de tu lado usando las huellas digitales.

Guía de implementación

Paso 1: Recupera los métodos de pago existentes

Usa el endpoint Retrieve Enrolled Payment Methods para listar las tarjetas existentes del cliente.
Respuesta:

Paso 2: Verifica si hay duplicados después de la inscripción

Paso 3: Gestiona los duplicados

Tienes varias opciones cuando se detecta un duplicado: Recomendado: La opción A (impedir la inscripción) para la mayoría de las integraciones. Usa la B o la C solo si tu producto permite intencionalmente varias copias guardadas de la misma tarjeta.

Opción B: Notificar después de la inscripción

Opción C: Conservar ambas inscripciones

Ejemplo de implementación completa

Consideraciones importantes

Disponibilidad de la huella digital

El campo fingerprint puede ser null en algunos métodos de pago o proveedores. Verifica siempre que la huella digital exista antes de usarla:
Coincidencia alternativa:
Tarjetas diferentes pueden compartir el mismo IIN y LFD.

Actualizaciones de la tarjeta

Comportamiento de la huella digital ante las actualizaciones de la tarjeta:

Huella digital del network token

Para los network tokens, Yuno usa un network_token_fingerprint que funciona como la huella digital de la tarjeta y tiene como alcance tu organización y el identificador único del network token en el vault de PCI. Esto significa que las inscripciones duplicadas del mismo PAN pueden corresponder al mismo network token. Para más detalles, consulta Network Tokens.

Casos de uso

  1. Evitar el desorden en la billetera

Ayuda a los usuarios a evitar guardar la misma tarjeta varias veces:

  1. Mejorar la experiencia de usuario

Limpia automáticamente los duplicados:

  1. Limpieza de datos

Identifica y elimina las inscripciones duplicadas en lote:

  1. Análisis y monitoreo

Haz seguimiento de las tasas de inscripciones duplicadas: