Proporcionar datos adicionales de la billetera

Descripción general

La billetera digital puede proporcionar datos adicionales durante la inscripción.

Estos datos se incluyen luego en la solicitud de aprobación de tokenización de TSP enviada al backend del emisor.

El backend del emisor puede usar estos datos junto con otras señales para refinar la puntuación de riesgo y tomar la decisión final de tokenización.

La decisión de tokenización del emisor puede ser:

• Verde: Aprobar la tokenización sin autenticación reforzada.
• Amarillo: Aprobar la tokenización con autenticación reforzada (ID&V).
• Rojo: Rechazar la tokenización.

Incluir datos adicionales de la billetera en el billetera objeto de la carga útil del token de autenticación.

Esta página describe el billetera formato de la carga útil compatible.

Formato de la carga útil de la billetera

La billetera carga útil usa JSON.

La tabla siguiente resume los campos compatibles.

Todos los campos son opcionales.

Algunos billetera campos no son reenviados por todos los TSP de la red de pago. Es posible que el backend del emisor no los reciba.

billetera campos de la carga útil

Campo	Compatibilidad con el esquema	Tipo	Descripción
recommendedFlow	Mastercard	Enum: Verde, Amarillo, Naranja	Recomendación de la billetera digital basada en la puntuación de la billetera.
reasonCodes	Mastercard	Matriz de cadenas	Lista de códigos que explican recommendedFlow.
deviceScore	Mastercard, Visa	Entero	Puntuación de la billetera digital que indica el nivel de confianza del dispositivo. Consulte Definición de la puntuación.
accountScore	Mastercard, Visa	Entero (1 a 5)	Puntuación de la billetera digital que indica el nivel de confianza de la cuenta. Consulte Definición de la puntuación.
fourLastDigitPhoneNumber	Mastercard, Visa	Cadena (1 a 4 dígitos)	Últimos cuatro dígitos del número de teléfono del usuario final.
accountIdHash	Mastercard	Cadena, hasta 48 caracteres	Hash SHA-256 codificado en Base64 del ID de cuenta del usuario final con el solicitante del token. Si el valor es una dirección de correo electrónico, use emailHash en su lugar.
emailHash	Mastercard, Visa	Cadena, hasta 48 caracteres	Hash SHA-256 codificado en Base64 de la dirección de correo electrónico.

Definición de la puntuación

La puntuación es un entero de 1 a 5.

Indica el nivel de confianza de la cuenta (accountScore) o del dispositivo (deviceScore):

• 1 indica alto riesgo
• 2 indica arriesgado
• 3 indica neutral
• 4 indica de confianza
• 5 indica muy confiable

Códigos de motivo

La reasonCodes el campo explica el recommendedFlow valor.

La billetera digital puede proporcionar varios códigos de motivo.

reasonCodes y recommendedFlow se aplican solo a Mastercard (MDES).

Códigos de motivo para la recomendación Verde

Código	Descripción
A3	La cuenta ha existido durante al menos un año. Un solicitante de tokens puede exigir una antigüedad mayor.
A4	Existe actividad financiera en la cuenta durante al menos seis meses. No hay actividad sospechosa vinculada a la cuenta durante al menos un año.
A5	Se solicita la digitalización para un dispositivo adicional para el mismo PAN de la cuenta y la cuenta del consumidor. Ya debe haber un token activo y no suspendido en otro dispositivo para el mismo PAN de la cuenta y la cuenta del consumidor.
A6	Se solicita la digitalización después de que una actualización autenticada del sistema operativo o del software borrara los datos de pago móvil e impidiera su recuperación. La solicitud debe usar el mismo paymentAppInstanceId que un token previamente digitalizado y activado para el mismo PAN de la cuenta y la cuenta del consumidor.

Códigos de motivo para la recomendación Amarilla

Código	Descripción
01	El ID de la cuenta de la billetera es demasiado reciente en relación con el lanzamiento.
02	El ID de la cuenta de la billetera es demasiado reciente en relación con la solicitud de aprovisionamiento.
03	El ID de la cuenta de la billetera y la tarjeta tienen una antigüedad menor que la fecha umbral.
04	Los datos de la cuenta cambiaron dentro del período umbral.
05	Hay transacciones sospechosas vinculadas a esta cuenta.
06	La cuenta no ha tenido actividad en el último año.
07	Las tarjetas del elemento seguro están suspendidas.
08	El dispositivo entró en modo perdido en los últimos 7 días durante más tiempo que el umbral.
09	El número de intentos de aprovisionamiento en este dispositivo en 72 horas supera el umbral.
0A	Se intentaron más tarjetas distintas de las permitidas por el umbral en este teléfono en 24 horas.
0B	La solicitud de aprovisionamiento contiene un nombre distinto por encima del umbral permitido.
0C	La puntuación del dispositivo es inferior a 3.
0D	La puntuación de la cuenta es inferior a 4.
0E	La ubicación de aprovisionamiento del dispositivo está fuera del país de origen del marketplace del OEM.
0F	Las reglas del modelo no están disponibles en este momento, por ejemplo, porque los sistemas de backend agotaron el tiempo de espera.
0G	La bandera de la ruta naranja está activada.