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

# Batch Set Card BIN Spend Controls

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

Batch sets or updates spend controls that define whitelist/blacklist consumption scenarios and MCC rules for determining which transactions are permitted or restricted.

## Headers

- `Idempotency-Key` string, required

## Request body

- CardConsumptionLabelBatchUpsertBlacklistOrWhitelistItemDTO — Batch Upsert Card Consumption Label Request
  - `enableSubAccount` boolean — Whether sub-account takes effect, default false
  - `items` CardConsumptionLabelBatchItemDTO[], required — Batch items
    - `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[] — add card id list,max size `100`
    - `deleteCardIds` string[] — delete card id list ,max size `100`
    - `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/revisions/29c08a4da357/schema)