Update card details

Last updated: September 30, 2026

You can update a card's details using the Dashboard and the API at any point in its lifetime.

Note

You can only update the expiry date for virtual cards.
Updating a virtual card's expiry month and/or year automatically updates the CVC2 code. Ensure you notify the cardholder so they can continue using the card with the new credentials.
All cards have a maximum lifetime of three years from creation. You cannot update a virtual card's expiry date beyond this lifetime.

In the Dashboard, you can update the card reference for identifying the card and the five user-defined fields available when you created the card. You must have the Manage Issuing data user permission.

Sign in to the Dashboard.
Go to Issuing > Cards.
Use search or filters to find the required card, and select it to view the Card details page.
In the Custom data tile, select Edit.
Make the required changes, and then select Save.

Call the Update card details endpoint, and provide the {cardId} in the path.

You can then set, update, or remove the following details:

The card reference for identifying the card – To remove, set to null.
The user-defined metadata fields: udf1, udf2, udf3, udf4, udf5 – To remove, set to null.
The expiry_month and expiry_year (virtual cards only) – You cannot set these fields to null. If you do not want to provide a value, do not include these fields in the request.
The card status – Set to active to activate the card.
The scheduled_activation_date or scheduled_revocation_date to schedule a change to the card's status – To remove, set to null.

Note

You cannot set status to active and provide scheduled_activation_date in the same request.

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

Information

Your base URL's {prefix} value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see API endpoints.

patch

https://{prefix}.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  "status": "active",
13  "scheduled_activation_date": "2026-06-01",
14  "scheduled_revocation_date": "2027-03-12"
15}


1{
2  "id": "crd_fa6psq242dcd6fdn5gifcq1491",
3  "client_id": "cli_vkuhvk4vjn2edkps7dfsq6emqm",
4  "entity_id": "ent_fa6psq242dcd6fdn5gifcq1491",
5  "cardholder_id": "crh_d3ozhf43pcq2xbldn2g45qnb44",
6  "card_product_id": "pro_7syjig3jq3mezlc3vjrdpfitl4",
7  "user_id": "usr_fa6psq242dcd6fdn5gifcq1491",
8  "last_four": "1234",
9  "expiry_month": 5,
10  "expiry_year": 2025,
11  "status": "active",
12  "display_name": "TOBY ARDEN",
13  "type": "virtual",
14  "billing_currency": "USD",
15  "issuing_country": "US",
16  "reference": "X-123456-N11",
17  "metadata": {
18    "udf1": "metadata1",
19    "udf2": "metadata2",
20    "udf3": "metadata3",
21    "udf4": "metadata4",
22    "udf5": "metadata5"
23  },
24  "scheduled_revocation_date": "2027-03-12",
25  "scheduled_activation_date": "2026-06-01",
26  "last_activated_on": "2019-09-10T10:11:12Z",
27  "root_card_id": "crd_fa6psq242dcd6fdn5gifcq1491",
28  "parent_card_id": "crd_qm26t52qz3yejjo2t4btqvxtzi",
29  "scheme": "mastercard",
30  "created_date": "2021-09-09T19:41:39Z",
31  "last_modified_date": "2021-09-09T19:41:39Z",
32  "_links": {
33    "self": {
34      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491",
35      "actions": [
36        "GET"
37      ],
38      "types": [
39        "application/json"
40      ]
41    },
42    "credentials": {
43      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/credentials",
44      "actions": [
45        "GET"
46      ],
47      "types": [
48        "application/json"
49      ]
50    },
51    "revoke": {
52      "href": "https://{prefix}.api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/revoke",
53      "actions": [
54        "POST"
55      ],
56      "types": [
57        "application/json"
58      ]
59    },
60    "controls": {
61      "href": "https://{prefix}.api.checkout.com/issuing/controls?target_id=crd_fa6psq42dcdd6fdn5gifcq1491",
62      "actions": [
63        "GET"
64      ],
65      "types": [
66        "application/json"
67      ]
68    }
69  },
70  "is_single_use": false
71}

You can set up webhooks to be notified when card details are updated:

Configure your webhook server.
Subscribe to the Card details changed webhook.

Update card details

Note

Update card details in the Dashboard

Update card details using the API

Note

Request example

Information

Response example

Subscribe to webhooks