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 los directorios de Click to Pay sincronizados con la información más reciente usando 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.
Elegir la API adecuada
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 integre Click to Pay con D1 o cuando el perfil del consumidor no esté administrado completamente en D1). Proporcione todos los campos del consumidor, incluso si solo han cambiado algunos valores. Opcionalmente, incluya 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 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 completamente 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 la API.
Renovar / Reemplazar D1 debe tener los datos más recientes actualizados. Use las API de D1 Renovar o Reemplazar cuando una tarjeta se renueve o se reemplace (nuevo PAN y/o nueva 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 coordina la nueva vinculación de los tokens existentes, incluidos los tokens de Click to Pay.
Experiencia de usuario
Flujo
El diagrama a continuación muestra el flujo general para actualizar los datos del consumidor y de la tarjeta en Click to Pay a través de D1:
Diagramas de secuencia
Requisitos previos
Consulte 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 de Click to Pay relevantes (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 detalles del consumidor deben proporcionarse en la solicitud, incluidos los campos que no hayan 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 usando 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 opción adecuada 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.
Última actualización
¿Te fue útil?