Start card renewal manually

Here, you will learn how to initiate manual card renewals in Tuum.

Use case

In this example, we will demonstrate how to initiate the manual card renewal process when necessary.

Use case data	API parameters with values
The card renewal process is initiated for card C001664282671.	...cards/C001664282671/renew

The system parameters CARD_RENEWAL_MONTHS_AFTER_LIMIT and CARD_RENEWAL_MONTHS_BEFORE_LIMIT specify the number of months before and after a card's expiry date during which card renewal is allowed.

Sample API call

To start a manual card renewal, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v1/cards/{cardId}/renew

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

Sample request

Here is a sample API request body to manually start a card renewal:

Body

No request body.

cURL

curl -L -X POST 'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282671/renew' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdCBrYXN1dGFqYSIsImVtcGxveWVlSWQiOiJJRC0xMTAwIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA5LTAzVDE0OjExOjQ4IiwiZXhwIjoxNzU2OTA4NzA4LCJyb2xlcyI6WyJBRE1JTiIsIlNZU1RFTSJdfQ.6Zo6mhD7dU6esAQKcvqfWXa7Betd-w_XKQ0mEmUkerE'

Sample response

Below you will find the response to the API request:

Response

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

Result

The card renewal process for card C001664282671 has been initiated.