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
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
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.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 A: Impedir la inscripción (recomendada para la mejor experiencia de usuario)
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 campofingerprint puede ser null en algunos métodos de pago o proveedores. Verifica siempre que la huella digital exista antes de usarla:
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 unnetwork_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.