Change card settings

In this section, you will learn how to change card settings in Tuum.

Use case

In this example, we will demonstrate how to change card settings using the following data.

Use case data	API parameters with values
We will change the card settings for card C001664282649.	...cards/C001664282649/settings/change
The card is renewable.	"renewable": true
The card cannot be added to a digital wallet.	"xpaysAllowed": false
Magnetic stripe purchases (0M) are not allowed for this card. Cash withdrawal (01) is allowed. Note: For each service code allowed by the card usage group, it must be defined whether authorisations using that service code are allowed or not.	"authorisationTypes": [ { "serviceCode": "0M", "allowed": false }, { "serviceCode": "01", "allowed": true }, ... ]

Sample API call

To change card settings, use the following endpoint:

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

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

Sample request

The sample request body is as follows:

JSON

{
  "authorisationTypes": [
    {
      "serviceCode": "0M",
      "allowed": false
    },
    {
      "serviceCode": "00",
      "allowed": true
    },
    {
      "serviceCode": "0A",
      "allowed": false
    },
    {
      "serviceCode": "0C",
      "allowed": true
    },
    {
      "serviceCode": "01",
      "allowed": true
    },
    {
      "serviceCode": "09",
      "allowed": false
    },
    {
      "serviceCode": "10",
      "allowed": true
    },
    {
      "serviceCode": "11",
      "allowed": false
    },
    {
      "serviceCode": "20",
      "allowed": true
    },
    {
      "serviceCode": "21",
      "allowed": true
    },
    {
      "serviceCode": "28",
      "allowed": true
    },
    {
      "serviceCode": "30",
      "allowed": true
    },
    {
      "serviceCode": "39",
      "allowed": true
    }
  ],
  "renewable": true,
  "xpaysAllowed": false
}

cURL

curl -X 'POST' \
  'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/settings/change' \
  -H 'accept: */*' \
  -H 'x-tenant-code: MB' \
  -H 'Accept-Language: en' \
  -H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHBpcnlEVGltZSI6IjIwMjUtMDQtMDJUMTM6NDQ6MjYiLCJleHAiOjE3NDM2MDE0NjYsInJvbGVzIjpbIkFETUlOIiwiUE9TVElOR1NfVEVBTSIsIlNZU1RFTSJdfQ.ClyBByoT_CNuMCRSyr__cHo1vdy1PfBff93ggc0E4_M' \
  -H 'Content-Type: application/json' \
  -d '{
  "authorisationTypes": [
    {
      "serviceCode": "0M",
      "allowed": false
    },
    {
      "serviceCode": "00",
      "allowed": true
    },
    {
      "serviceCode": "0A",
      "allowed": false
    },
    {
      "serviceCode": "0C",
      "allowed": true
    },
    {
      "serviceCode": "01",
      "allowed": true
    },
    {
      "serviceCode": "09",
      "allowed": false
    },
    {
      "serviceCode": "10",
      "allowed": true
    },
    {
      "serviceCode": "11",
      "allowed": false
    },
    {
      "serviceCode": "20",
      "allowed": true
    },
    {
      "serviceCode": "21",
      "allowed": true
    },
    {
      "serviceCode": "28",
      "allowed": true
    },
    {
      "serviceCode": "30",
      "allowed": true
    },
    {
      "serviceCode": "39",
      "allowed": true
    }
  ],
  "renewable": true,
  "xpaysAllowed": false
}'

Sample response

Below you will find the response to the API request:

Response

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

Result

Card settings have been updated. Changes to card services take effect immediately.