Change card usage group

Here, you will learn how to change the card usage group in Tuum. When the usage group is updated:

• The card is assigned new service codes (allowed authorisation types) based on the updated usage group.

• Existing valid service codes (allowed authorisation types) are ended, with their end time set to match the new usage group’s start time.

Use case

In this example, we will demonstrate how to update the card usage group using the following data.

Use case data	API parameters with values
The card usage group will be changed for card C001664282649.	...cards/C001664282649/usage-groups/change
New usage group information. In this example, the usage group PAYMENT_SERVICES will become effective starting from 01.05.2025. If the validityStart date is the current date, the change takes effect immediately.	"usageGroupName": "PAYMENT_SERVICES", "validityStart": "2025-05-01"

Sample API call

To change the card usage group, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v1/cards/{cardId}/usage-groups/change

Learn more about the change card usage group endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

{
  "usageGroupName": "PAYMENT_SERVICES",
  "validityStart": "2025-05-01"
}

cURL

curl -X 'POST' \
  'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/usage-groups/change' \
  -H 'accept: */*' \
  -H 'x-tenant-code: MB' \
  -H 'Accept-Language: en' \
  -H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHBpcnlEVGltZSI6IjIwMjUtMDQtMDFUMTM6NTE6NTQiLCJleHAiOjE3NDM1MTU1MTQsInJvbGVzIjpbIkFETUlOIiwiUE9TVElOR1NfVEVBTSIsIlNZU1RFTSJdfQ.hf-9TSn9QOiG_trOtoTUDz69FTXHhrndq2OXiqSmmGM' \
  -H 'Content-Type: application/json' \
  -d '{
  "usageGroupName": "PAYMENT_SERVICES",
  "validityStart": "2025-05-01"
}'

Sample response

Below you will find the response to the API request:

Response

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

Result

Starting from 2025-05-01 at 00:00:00, the PAYMENT_SERVICES usage group will apply to card C001664282649. As a result of this change, the allowed authorisation types will be updated: the currently active authorisation types will end on 2025-05-01 at 00:00:00, and a new set will become effective from the same time.