消费控制配置示例

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

将示例中的 CI_替换为实际卡片ID 换成自己的卡片 ID。以下仅展示请求 Body，请求头按接口定义填写。

每次提交都要带上所有希望保留的规则。可修改的规则如果不传或传 null，会被清除；产品不允许修改的规则保持原值。

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

以下以美元卡为例，金额单位为美分：10000 = 100 美元，5000 = 50 美元。每日额度按 Asia/Shanghai 时区计算。

{
  "cardInfoBizId": "CI_替换为实际卡片ID",
  "spendingRule": {
    "utilizationLimit": {
      "preset": "daily",
      "limitAmount": { "amountCents": 10000 },
      "timezone": "Asia/Shanghai"
    },
    "transactionSizeLimit": {
      "maximum": { "amountCents": 5000 }
    }
  }
}

此示例没有商户和国家规则，会清除卡片上可修改的商户、国家限制。如需保留，请一并提交。

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

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

{
  "cardInfoBizId": "CI_替换为实际卡片ID",
  "spendingRule": {
    "utilizationLimit": {
      "preset": "daily",
      "limitAmount": { "amountCents": 10000 },
      "timezone": "Asia/Shanghai"
    },
    "transactionSizeLimit": {
      "maximum": { "amountCents": 5000 }
    }
  },
  "merchantRule": {
    "restriction": "allowlist",
    "merchants": ["替换为查询返回的商户ID"]
  },
  "countryRule": {
    "restriction": "allowlist",
    "countries": ["US"]
  }
}

金额、商户、国家规则同时生效。若要禁止指定商户或国家，将对应的 restriction 改为 blacklist。

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

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

产品固定规则仍然有效。清除规则不代表卡片可无限消费。

字段怎么填

字段	填写说明
`preset`	`daily` 每日、`weekly` 每周、`monthly` 每月、`yearly` 每年、`collective` 累计
`limitAmount.amountCents`	对应周期内的累计消费上限，整数，不能为负数
`timezone`	从时区接口选择，使用返回的 `zoneIdCode`，例如 `Asia/Shanghai`
`transactionSizeLimit.minimum.amountCents`	单笔最低金额，可不填；与最高金额同时填写时必须小于最高金额
`transactionSizeLimit.maximum.amountCents`	单笔最高金额，可不填；金额不能为负数
`restriction`	`allowlist` 只允许列表中的商户或国家；`blacklist` 禁止列表中的商户或国家
`merchants` / `countries`	设置规则时列表不能为空；清除规则请省略整个规则对象或传 `null`

查询可选值

用途	接口
限制模式	`GET /card-products/10010105/reference/spending-restrictions`
消费周期	`GET /card-products/10010105/reference/spending-presets`
商户列表	`GET /card-products/10010105/reference/merchants/page`，可用 `merchantName` 搜索
国家列表	`GET /card-products/10010105/reference/countries/page`，可用 `countryName` 搜索
时区列表	`GET /card-products/timezones`

消费控制配置示例

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

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

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

字段怎么填#

查询可选值#

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

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

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

字段怎么填

查询可选值