Replace Card
Cards
Replace Card
Replace a card with a new one — same cardholder, new card number. POST /cards//replace.
POST
Replace Card
Overview
Replace an existing card with a brand new one. ThecardId remains the same for your records, but the card details (number, expiry, CVV) are replaced with a completely new card. Any remaining balance is automatically transferred to the new card.
Use Cases
- Card Compromised: When a cardholder reports unauthorized use or data exposure
- Card Lost: When a physical card is lost and needs to be replaced
- Card Damaged: When the card details are no longer accessible
Path Parameters
Request Body (Optional)
Example Usage
Response Fields
Error Responses
Product Fallback: When replacing a card, the system first tries to issue the same card product type. If that product is no longer available for issuance (i.e.,
canIssue: false in the products list), the default product (isDefault: true) is automatically used instead. The replacement is seamless — the balance is transferred regardless of which product is used.A card replacement fee may apply based on your pricing configuration. Use the Get Pricing endpoint to check current fees.
Authorizations
JWT access token obtained from /auth/token
Path Parameters
The unique card identifier
Body
application/json

