Here, you will learn how to change the card limit group in Tuum.
In this example, we will demonstrate how to update the card limit group using the following data.
The card limit group will be changed for card C001664282649.
New limit group information.
In this example, the limit group PAYMENT_3000 will become effective starting from 01.05.2025.
Note: If the validityStart date is the current date, the change takes effect immediately.
To change the card limit group, use the following endpoint:
https://card-api.sandbox.tuumplatform.com/api/v1/cards/{cardId}/limit-groups/change
The sample request body is as follows:
{
"limitGroupName": "PAYMENT_3000",
"validityStart": "2025-05-01"
}
curl -X 'POST' \
'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/limit-groups/change' \
-H 'accept: */*' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHBpcnlEVGltZSI6IjIwMjUtMDQtMDJUMDg6NTY6NTkiLCJleHAiOjE3NDM1ODQyMTksInJvbGVzIjpbIkFETUlOIiwiUE9TVElOR1NfVEVBTSIsIlNZU1RFTSJdfQ.hIo0b__2GdF185L5hBOje3RZZLILtTAIB0kFWqAA6Q8' \
-H 'Content-Type: application/json' \
-d '{
"limitGroupName": "PAYMENT_3000",
"validityStart": "2025-05-01"
}'
Below you will find the response to the API request:
Starting from 2025-05-01 at 00:00:00, the PAYMENT_3000
limit group will apply to card C001664282649
. As a result of this change, the card limits will also be updated: the current limits will expire on 2025-05-01 at 00:00:00, and the new limits will take effect from the same date.
...cards/C001664282649/limit-groups/change
"limitGroupName": "PAYMENT_3000",
"validityStart": "2025-05-01"