Actualizar perfiles de Click to Pay

Los datos del usuario final y los datos de la tarjeta almacenados en Click to Pay pueden cambiar con el tiempo.

Esta página explica cómo el backend del emisor puede mantener sincronizados los directorios de Click to Pay con la información más reciente mediante D1.

D1 expone dos API para este propósito:

• Actualizar consumidor de Click to Pay – actualizar los datos del perfil del usuario final (consumidor) y, opcionalmente, la dirección de facturación para todas las tarjetas.
• Actualizar tarjeta de Click to Pay – actualizar datos a nivel de tarjeta, como la dirección de facturación y, solo para Visa, el nombre del titular de la tarjeta.

Enlaces rápidos

• Inscribir tarjetas en Click to Pay
• Recuperar perfiles de Click to Pay
• Dar de baja tarjetas de Click to Pay

Elija la API correcta

Use la siguiente guía para decidir qué API llamar:

API de Click to Pay

• Actualizar consumidor de Click to Pay Úsela cuando necesite actualizar datos del consumidor específicamente en Click to Pay (por ejemplo, cuando solo integra Click to Pay con D1 o cuando el perfil del consumidor no se administra بالكامل en D1). Proporcione todos los campos del consumidor, incluso si solo cambiaron algunos valores. Incluya opcionalmente una dirección de facturación para actualizar la dirección de facturación de todas las tarjetas.
• Actualizar tarjeta de Click to Pay Úsela cuando solo deban cambiar los datos a nivel de tarjeta almacenados en Click to Pay, como la dirección de facturación de una tarjeta determinada o el nombre del titular para tarjetas Visa, sin modificar el perfil del consumidor.

API de D1

• Actualizar información del consumidor Úsela cuando mantenga el perfil del usuario final en D1 y quiera que se actualicen todos los canales, incluido Click to Pay. El usuario final debe estar totalmente registrado en D1 y ya inscrito en Click to Pay. Las actualizaciones se propagan automáticamente al directorio de Click to Pay; no necesita llamar a Actualizar consumidor de Click to Pay API.
• Renovar / Reemplazar D1 debe tener actualizados los datos más recientes. Use las API de D1 Renovar o Reemplazar cuando una tarjeta se renueva o se reemplaza (nuevo PAN y/o fecha de vencimiento). No existe una API específica de Click to Pay para estos eventos; en caso de que la tokenización también esté habilitada, D1 orquesta la reasociación de los tokens existentes, incluidos los tokens de Click to Pay.

Experiencia del usuario

Flujo

El diagrama siguiente muestra el flujo general para actualizar los detalles del consumidor y de la tarjeta en Click to Pay a través de D1:

Diagramas de secuencia

Requisitos previos

Consulte los requisitos previos.

Actualizar detalles del consumidor

Para actualizar los detalles del usuario final en Click to Pay, use la API de D1 Actualizar consumidor de Click to Pay.

D1 reenvía los datos actualizados a todos los directorios relevantes de Click to Pay (si existe más de un directorio). Esto permite al backend del emisor sincronizar todos los directorios con una sola llamada a la API.

Todos los datos del consumidor deben proporcionarse en la solicitud, incluidos los campos que no han cambiado:

• Nombre
• Segundo nombre
• Apellido
• Número de teléfono
• Dirección de correo electrónico
• Idioma

Opcionalmente, si se proporciona una dirección de facturación, D1 también actualiza la dirección de facturación de cada tarjeta asociada con el consumidor.

El diagrama de secuencia siguiente resume el comportamiento:

Si el backend del emisor ha registrado completamente los detalles del usuario final en D1, y el usuario final está inscrito en Click to Pay, una llamada a Actualizar información del consumidor también propaga automáticamente las actualizaciones al directorio de Click to Pay. En ese caso, no necesita llamar a Actualizar consumidor de Click to Pay por separado.

Actualizar detalles de la tarjeta

También puede actualizar detalles específicos de la tarjeta almacenados en Click to Pay utilizando la API de D1 Actualizar tarjeta de Click to Pay.

Esta API se puede usar para actualizar los siguientes atributos de la tarjeta:

• Dirección de facturación
• Nombre del titular de la tarjeta (opcional; solo aplicable a Visa)

El diagrama de secuencia siguiente resume el comportamiento:

En caso de renovación de la tarjeta (nueva fecha de vencimiento) o reemplazo de la tarjeta (nuevo PAN y nueva fecha de vencimiento), no existe una API específica de Click to Pay para este propósito.

En estos escenarios, el backend del emisor debe usar la API de D1:

• Reemplazar: si la tarjeta ha sido reemplazada (cambian tanto el número PAN como la fecha de vencimiento).
• Renovar V2: solo cambia la fecha de vencimiento.

O

• Renovar V1, para clientes que están en V1.