Managing Card Usage Groups

Card Usage Groups are set up in the Thredd system, based on the information you provided in your Product Setup Form (PSF). At the time of card creation, default groups for your card program are applied to the card. After card creation, you can update these with your own groups. You can only use the List Card Groups and Update Card Groups after the groups have been setup in the PSF.

📘

Note

You cannot change card usage group settings via the REST API. If you want to change the settings of your usage groups, contact your Implementation Manager.

List Card Control Groups

The List Card Control Groups API returns a list of all the card groups in your program. You can retrieve the card groups list by making a GET request to the endpoint. For example:

{{base-url}}/groups

A successful response will return a HTTP 200 response code, together with a list of card usage groups in the payload. For example:

[
    {
        "groupType": "AuthFeeGroup",
        "groups": [
            {
                "id": 786,
                "code": "TEST",
                "description": "TEST"
            },
            {
                "id": 1063,
                "code": "TEST-1",
                "description": "TEST 1"
            },
            {
                "id": 1137,
                "code": "TEST-2",
                "description": "Tran Test"
            },
            {
                "id": 1202,
                "code": "NEW-TEST-1",
                "description": "MENA TEST 1"
            },
            {
                "id": 1221,
                "code": "TEST008",
                "description": "Test 08"
            }
        ]
    }
]

👍

API Explorer

See the List card control groups endpoint for more information.

Update Card Control Groups

The Update Card Control Groups API enables you to change the card groups linked to a specified card. You can update the card groups linked to a card by making a PUT request to the endpoint. For example:

{{base-url}}/cards/{{publicToken}}/groups

The PUT body should include the group IDs that you want to update. These IDs must be valid IDs for your program - you can use the List Card Control Groups API to retrieve the full list of valid IDs available. The below is an example of what the body could look like.

{
    "ControlGroups": {
        "limitsGroup": 3368
    }
}

A successful response will return a HTTP 200 response code and the following response:

{
    "limitsGroup": 3368,
    "usageGroup": 374,
    "recurringFeeGroup": 0,
    "webServiceFeeGroup": 0,
    "authFeeGroup": 1221,
    "mccGroup": 0,
    "cardLinkageGroup": 0,
    "calendarGroup": 0,
    "fxGroup": 0,
    "paymentTokenUsageGroup": 0,
    "cardAcceptorAllowList": 1,
    "cardAcceptorDisallowList": 1 
}

👍

API Explorer

See the Update Card Control Groups endpoint for more information.