Renew a card

post

https://sandbox.lithic.com/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 Params

card_token

uuid

required

Body Params

carrier

object

If omitted, the previous carrier will be used.

exp_month

string

length between 2 and 2

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.

exp_year

string

length between 4 and 4

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.

product_id

string

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_address

object

required

The shipping address this card will be sent to.

shipping_method

string

enum

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
BULK - Card will be shipped as part of a bulk fulfillment order. The shipping method and timeline are inherited from the parent bulk order.

Allowed:

Responses


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

200OK

400A parameter in the query given in the request does not match the valid queries for the endpoint.

404The specified resource was not found.

422Unprocessable entity.