卡发行 › 指南
限额、商户/MCC 名单、账单地址 —— 三种管控，白名单与黑名单不能就地互改。
消费管控
限额
PATCH /v1/cards/{id}/limits
{ "single": "500.00", "daily": "2000.00", "monthly": "10000.00" }
三个字段都是卡本币的十进制串。省略 = 保持原值，"0" = 不设限。
三条会被拒的输入
| 输入 | 返回 |
|---|---|
| 超过产品上限 | invalid_fields —— 是拒绝，不是夹到上限 |
三层不自洽（daily < single 或 monthly < daily，两者都非 0 时） | invalid_fields |
| 不足一个货币单位 | invalid_fields |
⚠ 别按「会被夹到硬顶」设计界面。 超限是 400，用户设的值一个字都没进去。
界面上要把产品上限显示出来、并在提交前自己校验一遍 —— 否则用户填一个大数，
拿到一句「限额不合法」，而他不知道上限是多少。
⚠ 这个端点的
invalid_fields不带fields数组（其余端点带）。三种情况共用这一个码，你说不出是哪一项 —— 所以更要在前端先校验。
⚠ 金额串本身非法（
"abc"、小数位超过卡本币精度）目前返回 500。发之前自己校验形状。
生效是异步的
返回 accepted: true 只表示我方记下了，正在向上游下发。不是「已生效」。
商户 / MCC 名单
GET|PUT|DELETE /v1/cards/{id}/merchant-rules
白名单（只许这些）或黑名单（禁止这些）。
⚠ 白 ↔ 黑不能就地互改。 上游的全量更新那条路径根本不发规则类型，
改了会出现最坏的一种情况：我方落库成黑名单、回「已同步」，
而上游仍按白名单拦 —— 商户以为自己在挡那几家，实际是只许那几家。
要切换请先 DELETE 再 PUT。我方不替你做「先删再加」——
删掉那一刻到加回去之间这张卡是完全不设防的，那个窗口该由你选择要不要开。
账单地址
PATCH /v1/cards/{id}/billing-address
只有部分卡产品支持（3DS 验证要用）。不支持的产品会拒。