Merchant Disallow Lists

This section provides instructions on how to add a card or card group to a merchant disallow list.

Merchant lists enable you to control which merchants or merchant codes are blocked or allowed to use your service. This API enables you to manage merchant disallow lists, which can then be assigned to a single card or multiple cards. Any merchant IDs in the disallow will see transactions declined by Thredd at the authorisation stage. The response code will be ’05 – Do not honour’.

Retrieve Disallow List

The Retrieve Merchant Disallow List endpoint allows you to retrieve the merchant disallow list for your program. You can retrieve the merchant disallow list by making a GET request to the Disallow Merchant endpoint. For example:

{{base-url}}/groups/disallowmerchant

A successful response will return a HTTP 200 response code. Below is an example response:

[
    {
        "listId": 71,
        "listName": "TEST LIST",
        "listType": "Disallow",
        "isActive": true,
        "schemeId": null,
        "schemeName": "",
        "institutionId": 142,
        "institutionName": "INSTITUTION TEST",
        "cardAcceptors": [
            "12345"
        ]
    }
]

👍

API Explorer

See the Get Disallowed Merchants endpoint.

Add Merchant to Disallow List

The Add Merchant to Disallow List endpoint allows you to add merchants to a disallow list. You can do this by adding the List ID to the end of the Disallow Merchant endpoint. For example:

{{base-url}}/groups/allowmerchant/{{DisallowListID}}

The POST body should include the merchant IDs that you want to associate with the nominated disallow list. The below is an example of what the body should look like.

{
    "merchantIds": [
        "Merchant5"
    ]
}

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

{
    "listId": 71,
    "listName": "LIST TEST",
    "listType": "Disallow",
    "isActive": true,
    "schemeId": null,
    "schemeName": "",
    "institutionId": 142,
    "institutionName": "INSTITUTION TEST",
    "cardAcceptors": [
        "12345",
        "Merchant5"
    ]
}

👍

API Explorer

See the Add Merchant to Disallow List endpoint.

Remove Merchant from Disallow List

The Remove Merchant from Disallow List endpoint allows you to remove a merchant from a disallow list. You can do this by using the DELETE method and adding the List ID and Merchant ID to the end of the Disallow Merchant endpoint. For example:

{{base-url}}/groups/allowmerchant/{{DisallowListID}}/{{MerchantID}}

No body is required in the request. A successful response will return a HTTP 204 response code and the merchant will be removed from the disallow list.

👍

API Explorer

See the Remove Merchant from Disallow List endpoint.