Renew

Renew a card

post/v1/cards/{card_token}/renew

Applies to card types PHYSICAL and VIRTUAL. For PHYSICAL, creates a new card with the same card token and PAN, but updated expiry and CVC2 code. The original card will keep working for card-present transactions until the new card is activated. For card-not-present transactions, the original card details (expiry, CVC2) will also keep working until the new card is activated. A PHYSICAL card can be reissued or renewed a total of 8 times. For VIRTUAL, the card will retain the same card token and PAN and receive an updated expiry and CVC2 code. product_id, shipping_method, shipping_address, carrier are only relevant for renewing PHYSICAL cards.

Path Parameters

card_tokenstring

formatuuid

Body Parameters

shipping_address

The shipping address this card will be sent to.

carrier

optional

If omitted, the previous carrier will be used.

exp_monthstring

optional

Two digit (MM) expiry month. If neither exp_month nor exp_year is provided, an expiration date six years in the future will be generated.

maxLength2

minLength2

exp_yearstring

optional

Four digit (yyyy) expiry year. If neither exp_month nor exp_year is provided, an expiration date six years in the future will be generated.

maxLength4

minLength4

product_idstring

optional

Specifies the configuration (e.g. physical card art) that the card should be manufactured with, and only applies to cards of type PHYSICAL. This must be configured with Lithic before use.

shipping_methodenum

optional

Accepts one of the following: "2_DAY", "EXPEDITED", "EXPRESS", 3 more

Shipping method for the card. Only applies to cards of type PHYSICAL. Use of options besides STANDARD require additional permissions.

STANDARD - USPS regular mail or similar international option, with no tracking
STANDARD_WITH_TRACKING - USPS regular mail or similar international option, with tracking
PRIORITY - USPS Priority, 1-3 day shipping, with tracking
EXPRESS - FedEx or UPS depending on card manufacturer, Express, 3-day shipping, with tracking
2_DAY - FedEx or UPS depending on card manufacturer, 2-day shipping, with tracking
EXPEDITED - FedEx or UPS depending on card manufacturer, Standard Overnight or similar international option, with tracking

Hide ParametersShow Parameters

"2_DAY"

"EXPEDITED"

"EXPRESS"

"PRIORITY"

"STANDARD"

"STANDARD_WITH_TRACKING"

Returns

Request example Request

curl https://api.lithic.com/v1/cards/$CARD_TOKEN/renew \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "shipping_address": {
        "address1": "5 Broad Street",
        "city": "NEW YORK",
        "country": "USA",
        "first_name": "Janet",
        "last_name": "Yellen",
        "postal_code": "10001",
        "state": "NY",
        "address2": "Unit 5A"
      },
      "exp_month": "06",
      "exp_year": "2027"
    }'

200 Example

{
  "token": "7ef7d65c-9023-4da3-b113-3b8583fd7951",
  "account_token": "f3f4918c-dee9-464d-a819-4aa42901d624",
  "card_program_token": "5e9483eb-8103-4e16-9794-2106111b2eca",
  "created": "2021-06-28T22:53:15Z",
  "funding": {
    "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "created": "2019-12-27T18:11:19.117Z",
    "last_four": "xxxx",
    "state": "DELETED",
    "type": "DEPOSITORY_CHECKING",
    "account_name": "account_name",
    "nickname": "x"
  },
  "last_four": "xxxx",
  "pin_status": "OK",
  "spend_limit": 1000,
  "spend_limit_duration": "ANNUALLY",
  "state": "CLOSED",
  "type": "MERCHANT_LOCKED",
  "auth_rule_tokens": [
    "string"
  ],
  "cardholder_currency": "USD",
  "digital_card_art_token": "00000000-0000-0000-1000-000000000000",
  "exp_month": "06",
  "exp_year": "2027",
  "hostname": "hostname",
  "memo": "New Card",
  "pending_commands": [
    "string"
  ],
  "product_id": "1",
  "replacement_for": "5e9483eb-8103-4e16-9794-2106111b2eca",
  "cvv": "776",
  "pan": "4111111289144142"
}