For credit cards, you can update the previously stored payment details. This may be required, for example, when the card expiry date or the billing/delivery address changes.
You can update stored payment details when you initiate a new recurring payment. For this, pass new payment details along with an
/authorise call and specify the
selectedRecurringDetailReference value of the details that you want to update.
The details will only update if the
/authorise request is successful.
For information on all available fields, see PaymentRequest.
The following example demonstrates how to update the expiry month and year for the previously stored card details with an
If a recurring payment is successfully authorised, payment details are also updated during this call. In this case, the old
recurringDetailReference becomes invalid, and a new reference is created.
recurringDetailReference value isn't returned in the
/authorisation response. To learn how to obtain a new
recurringDetailReference value, refer to this document.
For information on all available fields, refer to the PaymentResult topic.
The following example shows the response in case of successful authorisation: