Adyen is no longer developing the Classic API integration
This page is for the Classic API (/authorise) integration, which we no longer accept new integrations with.
We strongly recommend migrating to the newer Manage tokens integration. To use this newer integration, you must also migrate to the Checkout API.
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.
Request
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 /authorise call:
Response
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.
A new 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: