Replace virtual card

Here, you will learn how to replace a virtual card in Tuum. This is an irregular replacement scenario, where the original card is replaced due to stolen or leaked credentials.

Use case

In this example, we will demonstrate how to replace a virtual card. The new card inherits all details from the old card by default.

Use case data
API parameters with values

The path parameter is the card ID you want to replace.

.../C001664282659/replace

Replacement reason

"replacementReasonCode": "STOLEN_OR_LEAKED_CREDENTIALS"

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:

{
  "replacementReasonCode": "STOLEN_OR_LEAKED_CREDENTIALS"
}

Sample response

Below you will find the response to the API request:

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

Result

A new card is created and activated. The old card is closed.

Last updated

Was this helpful?