Replace physical card
Here, you will learn how to replace a physical card in Tuum. This process covers an irregular replacement case, where the card is replaced because it has been damaged.
Use case
In this example, we will demonstrate how to replace a physical card due to damage. The new card will have a different design than the old one.
The path parameter is the card ID you want to replace.
.../C001664282546/replace
Cardholder details
"cardholderFirstName": "Isabelle",
"cardholderLastName": "Lacoste",
Shipping details
"postalCode": "76515",
"countryCode": "EE",
"city": "Tallinn",
"county": "Harju",
"streetAddress": "Maakri 30",
"phoneCountryCode": "+372",
"phoneNumber": "55555555"
Card design
"newDesignCode": "XX"
Replacement reason
"replacementReasonCode": "DAMAGED"
Sample API call
To replace a card, use the following endpoint:
https://card-api.sandbox.tuumplatform.com/api/v1/cards/{cardId}/replace
Sample request
The sample request body is as follows:
{
"cardholderFirstName": "Isabelle",
"cardholderLastName": "Lacoste",
"postalCode": "76515",
"countryCode": "EE",
"city": "Tallinn",
"county": "Harju",
"streetAddress": "Maakri 30",
"phoneCountryCode": "+372",
"phoneNumber": "55555555",
"newDesignCode": "XX",
"replacementReasonCode": "DAMAGED"
}
Sample response
Below you will find the response to the API request:
Result
A new card has been issued and is ready for activation. The old card is closed automatically.
Last updated
Was this helpful?