Update Click to Pay profiles
End user data and card data stored in Click to Pay can change over time.
This page explains how the issuer backend can keep Click to Pay directories synchronized with the latest information using D1.
D1 exposes two APIs for this purpose:
Click to Pay update consumer – update end user (consumer) profile data, and optionally the billing address for all cards.
Click to Pay update card – update card-level data such as the billing address and, for Visa only, the cardholder name.
Choose the right API
Use the following guidance to decide which API to call:
Click to Pay API
Click to Pay update consumer Use when you need to update consumer data specifically in Click to Pay (for example, when you only integrate Click to Pay with D1 or when the consumer profile is not fully managed in D1). Provide all consumer fields, even if only some values changed. Optionally include a billing address to update the billing address for all cards.
Click to Pay update card Use when only card-level data stored in Click to Pay must change, such as the billing address for a given card, or the cardholder name for Visa cards, without modifying the consumer profile.
D1 API
Update consumer information Use when you maintain the end user profile in D1 and want all channels, including Click to Pay, to be updated. The end user must be fully registered in D1 and already enrolled in Click to Pay. Updates are automatically propagated to the Click to Pay directory; you do not need to call Click to Pay update consumer API.
Renew / Replace D1 must have the latest data updated. Use the D1 Renew or Replace APIs when a card is renewed or replaced (new PAN and/or expiration date). There is no dedicated Click to Pay API for these events; in case tokenization is also enabled, D1 orchestrates the re-linking of existing tokens, including any Click to Pay tokens.
User experience
Flow
The diagram below shows the overall flow to update consumer and card details in Click to Pay through D1:
Sequence diagrams
Prerequisites
Please refer to prerequisites.
Update consumer details
To update end user details in Click to Pay, use the D1 API Click to Pay update consumer.
D1 forwards the updated data to all relevant Click to Pay directories (if more than one directory exists). This allows the issuer backend to synchronize all directories with a single API call.
All consumer details must be provided in the request, including fields that have not changed:
First name
Middle name
Last name
Phone number
Email address
Language
Optionally, if a billing address is provided, D1 also updates the billing address for each card associated with the consumer.
The sequence diagram below summarizes the behavior:
If the issuer backend has fully registered the end user details on D1, and the end user is enrolled in Click to Pay, a call to Update consumer information also automatically propagates the updates to the Click to Pay directory. In that case, you do not need to call Click to Pay update consumer separately.
Update card details
You can also update specific card details stored in Click to Pay by using the D1 API Click to Pay update card.
This API can be used to update the following card attributes:
Billing address
Cardholder name (optional – only applicable to Visa)
The sequence diagram below summarizes the behavior:
In case of card renewal (new expiration date) or card replacement (new PAN and new expiration date), there is no specific Click to Pay API for this purpose.
In these scenarios, the issuer backend must use the appropriate D1 API:
Replace: if the card has been replaced (both, PAN number and expiration date change).
Renew V2: only the expiration date changes.
Or
Renew V1, for customers who are in V1.
Last updated
Was this helpful?