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.

Use case data
API parameters with values

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

Learn more about the replace card endpoint in the Tuum developer portal.

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:

Response
{
    "errors": null,
    "validationErrors": null,
    "data": null
}

Result

A new card has been issued and is ready for activation. The old card is closed automatically.

  • If the new card is usable before delivery, its status is set to VIRTUAL.

  • Otherwise, the new card remains in OPEN status until the cardholder activates it after receiving the physical card.

Last updated

Was this helpful?