INinterlace
Card

Set Card BIN Spend Controls

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.

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

Headers

Idempotency-Keystring required

Universally unique identifier idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

Request body

usagestring required

usage: MCC,SCENARIO,TRANSACTION_CURRENCY, if id is null then usage can not be null

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

idinteger

id ,if null then insert ,if not null then update

listTypestring required

list type: BLACKLIST,WHITELIST

cardBinIdsstring[]

card bin id list, if null then all card bin will be applied

cardIdsstring[]

card id list

accountIdstring

account id

Response

OK

codestring

Return code

messagestring

Error message

Changes

No recorded changes to this operation across all 1 revision of this API.