Replacement cards

Learn how to replace cards that are expired, damaged, lost, or stolen.

Replacements for expired or damaged cards

Physical cards can get damaged, and both physical cards and virtual cards expire, but you can create replacement cards that have the same card number. The cardholder can continue to use the original card before the replacement card is activated, as long as the card isn’t too damaged or already expired. Activating the replacement card cancels the original card if it isn’t already canceled.

To create a replacement card for an expired or damaged card, create a Card with replacement_for using the expired or damaged Card ID and replacement_reason set to expired or damaged.

curl https://api.stripe.com/v1/issuing/cards \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d cardholder=ich_1Cm3pZIyNTgGDVfzI83rasFP \
  -d currency=usd \
  -d type=virtual \
  -d replacement_for=ic_1LL8wgLUVt6Jcs5dgLLfwcAE \
  -d replacement_reason=expired

Replacements for lost or stolen cards

Lost or stolen cards get new card numbers for security reasons. We need to cancel the original cards before we can create the replacement card.

To create a replacement card for a lost or stolen card:

Cancel the lost or stolen card by using the update card endpoint to set its status to canceled and its cancellation_reason to lost or stolen.
Create a Card with replacement_for using the lost or stolen Card ID and replacement_reason set to lost or stolen.

curl https://api.stripe.com/v1/issuing/cards/ic_1CoYuRKEl2ztzE5GIEDjQiUI \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d status=canceled \
  -d cancellation_reason=lost

curl https://api.stripe.com/v1/issuing/cards \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d cardholder=ich_1Cm3pZIyNTgGDVfzI83rasFP \
  -d currency=usd \
  -d type=virtual \
  -d replacement_for=ic_1CoYuRKEl2ztzE5GIEDjQiUI \
  -d replacement_reason=lost

All replacements

All replacement cards have renewed expiration dates and new security codes. Authorizations made on the original cards are migrated to the replacements, but might still clear on the original cards. Like the originals, replacement cards must be activated before use.