---
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`

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, if `usage` is MCC, then keywords must be 4 digits string, <br> if `usage` is TRANSACTION_CURRENCY, then keywords must be 3 digits currency code<br> if `usage` is SCENARIO, then keywords must be substring of transaction detail info
  - `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.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/versions/29c08a4da357/schema)