Use the replace endpoint to generate a net-new card for an account. You can use this endpoint to replace a card that has been lost or stolen. This endpoint generates a card with a new PAN, CVV, expiry, and creates a new emboss record.
To reissue a card (keep the same PAN but generate a new CVV/expiry), please refer to Reissue Card. For more information on reissuing vs. replacing a card, please see Replacing and Reissuing Cards.
This endpoint sets the old card's status to closed_ls once successfully called. The cardExpiryDate and cardNumber returned by this endpoint are the new values; you do not have to wait for the emboss process to run. Your program must be PCI-compliant to receive the full PAN, otherwise it will be masked.
Once your customer receives the card, you can call Activate Card to activate it.
ℹ️ Special Note for Digital-First Cards
Since Digital-First cards are active upon creation, successfully calling this endpoint will automatically block physical transactions to protect the newly created card in transit.
Note: this will overwrite any existing blocks on the card that were set via Edit Account Features. Digital and mobile wallet transactions will still be permitted while this block is in place.
Once a customer has confirmed receipt of the physical card, remove this block by calling the Edit Account Features endpoint. For more information, see Activating Cards.