消费控制配置示例

适用接口：POST /card-products/10010105/cards/spending-controls/update。

以下仅展示请求 Body。请求头按接口定义填写，卡片 ID、商户 ID 替换为实际查询结果。本示例仅适用于渠道 10010105。

当前版本统一使用 settings。更新为整体替换：可修改维度省略或传 null 会被清除，锁定维度保持当前值。需要保留的可修改规则必须一并提交。

示例一：每天最多消费 100 美元，单笔最多 50 美元

以美元卡为例，金额使用美分：10000 表示 100 美元，5000 表示 50 美元。每日额度按 Asia/Shanghai 时区计算。

{
  "cardInfoBizId": "CI_替换为实际卡片ID",
  "settings": {
    "limits": [
      {
        "period": "DAILY",
        "amountMinor": 10000,
        "timezone": "Asia/Shanghai"
      }
    ],
    "transaction": {
      "maxMinor": 5000
    }
  }
}

此请求未包含商户和国家规则，因此会清除允许修改的商户、国家限制。如需保留，请按示例二一并提交。

示例二：保留金额限制，只允许指定商户在美国消费

merchantIds 填商户查询接口返回的商户 ID，不填商户名称；countries 填国家代码，例如 US。

{
  "cardInfoBizId": "CI_替换为实际卡片ID",
  "settings": {
    "limits": [
      {
        "period": "DAILY",
        "amountMinor": 10000,
        "timezone": "Asia/Shanghai"
      }
    ],
    "transaction": {
      "maxMinor": 5000
    },
    "merchantRule": {
      "mode": "ALLOW",
      "merchantIds": ["替换为查询返回的商户ID"]
    },
    "countryRule": {
      "mode": "ALLOW",
      "countries": ["US"]
    }
  }
}

金额、商户和国家规则同时生效。若要禁止列表中的商户或国家，将对应 mode 改为 DENY。

示例三：清除允许自行修改的消费规则

{
  "cardInfoBizId": "CI_替换为实际卡片ID",
  "settings": {}
}

清除可修改的消费限额、单笔金额、商户和国家规则。锁定规则保持当前值，清除规则不代表无限消费。

若只想清除消费限额，可传 "limits": []，同时提交其他需要保留的可修改规则。

字段填写说明

字段	中文说明
`settings.limits`	消费限额数组；每条包含周期和金额，空数组表示清除限额
`settings.limits[].period`	`DAILY` 每日、`WEEKLY` 每周、`MONTHLY` 每月、`YEARLY` 每年、`LIFETIME` 累计；提交大写字符串
`settings.limits[].amountMinor`	周期限额，币种最小单位整数，至少为 1；不能用 0 表示清除
`settings.limits[].timezone`	可选 IANA 时区，例如 `Asia/Shanghai`
`settings.limits[].startDate`	可选周期开始日期，格式 `yyyy-MM-dd`
`settings.transaction.minMinor`	可选单笔最低金额，币种最小单位整数，不小于 0
`settings.transaction.maxMinor`	可选单笔最高金额，币种最小单位整数，至少为 1
`settings.merchantRule.mode` / `settings.countryRule.mode`	`ALLOW` 允许名单、`DENY` 禁止名单；提交字符串，不提交响应字典对象
`settings.merchantRule.merchantIds`	商户 ID 数组
`settings.countryRule.countries`	国家代码数组，例如 `["US"]`

具体可修改维度、支持周期、金额范围以当前卡片及卡组规则为准，不同渠道配置不能混用。

查询可选值

用途	接口
商户列表	`GET /card-products/10010105/merchant/page`
国家列表	`GET /card-products/10010105/reference/countries`
时区列表	`GET /card-products/timezones`

限额周期和名单模式按上表填写当前版本的枚举字符串。

消费控制配置示例

示例一：每天最多消费 100 美元，单笔最多 50 美元#

示例二：保留金额限制，只允许指定商户在美国消费#

示例三：清除允许自行修改的消费规则#

字段填写说明#

查询可选值#

示例一：每天最多消费 100 美元，单笔最多 50 美元

示例二：保留金额限制，只允许指定商户在美国消费

示例三：清除允许自行修改的消费规则

字段填写说明

查询可选值