Classic-integration icon

Update stored details

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 switching to the newer Manage tokens integration.

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 /authorise call:


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:

Next steps