---
title: "Set Card BIN Spend Controls"
method: POST
path: "/open-api/v3/consumption-scenarios"
tags: ["Card"]
---

# Set Card BIN Spend Controls

`POST /open-api/v3/consumption-scenarios`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/consumption-scenarios`
- Auth: API key in header `x-access-token`

Sets or updates spend controls that define whitelist/blacklist consumption scenarios and MCC rules for determining which transactions are permitted or restricted. </br> The configured controls apply to all applicable cards once updated.

## Headers

- `Idempotency-Key` string, required

## Request body

- CardConsumptionLabelUpsertBlacklistOrWhitelistItemDTO: Card Consumption Label Upsert Blacklist Or Whitelist Item
  - `usage` string, required: usage: `MCC`,`SCENARIO`,`TRANSACTION_CURRENCY`, if `id` is null then `usage` can not be null
  - `keywords` string, required: keywords<ul><li>if `usage` is <b>MCC</b>: keywords must be 4 digits string</li><li>if `usage` is <b>TRANSACTION_CURRENCY</b>: keywords must be 3 digits currency code</li><li>if `usage` is <b>SCENARIO</b>: keywords will be matched against transaction detail info, supports `%` as wildcard for fuzzy matching:<ul><li>`STARLINK` — exact match</li><li>`ChatGPT%` — prefix match</li><li>`%ChatGPT` — suffix match</li><li>`%ChatGPT%` — contains "ChatGPT" anywhere</li></ul></li></ul>
  - `id` integer: id ,if null then insert ,if not null then update
  - `listType` string, required: list type: `BLACKLIST`,`WHITELIST`
  - `cardBinIds` string[]: card bin id list, if null then all card bin will be applied
  - `cardIds` string[]: card id list
  - `accountId` string: account id

## Response `200`

OK

- CardMccAndScenesResponse: Card MCC and Scenes Response
  - `code` string: Return code
  - `message` string: Error message
  - `data` CardMccAndScenesResource[]: Returned data
    - `id` integer: resource id
    - `keywords` string: keywords
    - `usage` string: usage
    - `listType` string: list type
    - `cardBinIds` string[]: card bin list
    - `cardIds` string[]: card id list

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/interlace/apis/infinity-card.md) - [All operations](https://skmtc.dev/interlace/apis/infinity-card/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/infinity-card/revisions/2d542b383dd3?raw)