1 of 2

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.

The card is renewable.

The card cannot be added to a digital wallet.

Magnetic stripe purchases (0M) are not allowed for this card.

Cash withdrawal (01) is allowed.

Note: For each allowed by the card usage group, it must be defined whether authorisations using that service code are allowed or not.

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:

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.

Card service codes

The table below provides an overview of the supported service codes (authorisation types):

Code

Card service

Description

POS purchases contact (chip)

A purchase transaction where the card information is read from the chip using a contact-based method.

E-commerce purchases

A subtype of purchase transactions where the Point-of-Service (POS) code does not indicate that the cardholder or the card is present.

POS purchases card contactless

A subtype of purchase transactions where the Point-of-Service (POS) code indicates PAN auto-entry via contactless.

Magnetic stripe

A purchase or cash transaction where the card information is read from the magnetic stripe.

Cash withdrawal

A transaction involving the withdrawal of cash from an ATM.

Purchases with Cash Back

A transaction in which only part of the authorised amount is used to pay for goods or services, while the remaining amount is returned to the customer in cash.

Account funding

VISA only. A purchase transaction that can occur in a card-present, card-not-present, or e-commerce environment. An Account Funding Transaction (AFT) is a type of "pull" payment, where the payment service provider pulls funds from the cardholder’s account. The receiver initiates the transfer of funds from the sender’s account to their own.

Quasi-Cash

VISA only. Quasi-Cash transactions refer to the purchase of items that may be convertible to cash, such as foreign currency, casino chips, cryptocurrencies, money orders, lottery tickets, and travellers cheques, among others.

Purchase refund

A credit transaction that reverses a previous purchase.

Deposit (ATM)

The process of depositing cash using a specialised automatic cash-in device. This typically requires a specific agreement with the processor to recognise the operation type.

Moneysend payment transactions

A payment type in which funds are transferred directly to the recipient’s card account.

Balance inquiry (ATM)

A non-financial transaction that allows a cardholder to check their current account balance at an ATM.

Statement (ATM)

A non-financial transaction that allows a cardholder to view a brief summary of their recent transactions at an ATM.