Update card details

Last updated: July 18, 2024

You can use the Dashboard or API to update a card's details.

Note

Updating a card's expiry month and/or expiry year will trigger an update to the CVC2 code. After you've made the update, notify your cardholders that they can continue using the card with the new credentials.

You can use the API to update or add the following details for a card you issued, at any point during its lifecycle:

metadata fields (udf1, udf2, udf3, udf4, udf5)
reference
expiry_month
expiry_year

You cannot pass null to the expiry_month and expiry_year fields. If you do not want to provide values for these fields, do not include them in the request.

You can choose to:

change a parameter's value
set a value to a parameter that was not used during card creation
remove a detail from a card by passing null as the field's value in the request

To receive a notification whenever a card's details are updated, subscribe to the card_details_changed webhook.

patch

https://api.checkout.com/issuing/cards/{cardId}


1{
2  "reference": "X-123456-N11",
3  "metadata": {
4    "udf1": "metadata1",
5    "udf2": "metadata2",
6    "udf3": "metadata3",
7    "udf4": "metadata4",
8    "udf5": "metadata5"
9  },
10  "expiry_month": 5,
11  "expiry_year": 2025
12}


1{
2  "last_modified_date": "2019-09-10T10:11:12Z",
3  "_links": {
4    "self": {
5      "href": "https://api.checkout.com/issuing/card/crd_d3ozhf43pcq2xbldn2g45qnb44",
6      "actions": [
7        "GET"
8      ],
9      "types": [
10        "application/json"
11      ]
12    }
13  }
14}

To update a card's details using the Dashboard, ensure that you have permission to manage Issuing data.

Go to Card issuing > Cards on the Dashboard.
Use search or filters to find the required card.
Select the card to view its details.
Select Edit for the section you'd like to update.
Once you've made the changes, select Save.

Update card details

Note

Update card details using API

Request example

Response example

Update card details using the Dashboard