卡组
用于管理卡组，以便按组组织卡片并共享消费限制。
List Card Groups
POST
/partner/channel/slash/card-groups/query internal返回卡组分页列表。
Request Body
使用 SecureChannelRequest<CardGroupQueryRequest> 包裹：
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | 页码（从 0 开始） |
pageSize | integer | Optional | 每页数量 |
Response
返回 CardGroupListResponse。
Get Card Group
POST
/partner/channel/slash/card-groups/get internal按 ID 获取单个卡组。不存在时返回 404。
Request Body
使用 SecureChannelRequest<CardGroupGetRequest> 包裹：
| Name | Type | Required | Description |
|---|---|---|---|
cardGroupId | string | Required | 卡组 ID |
Response
返回 CardGroup。
Create Card Group
POST
/partner/channel/slash/card-groups internal创建新的卡组。
Request Body
使用 SecureChannelRequest<CreateCardGroupRequest> 包裹：
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Required | 卡组名称 |
Response
返回创建后的 CardGroup。
Update Card Group
POST
/partner/channel/slash/card-groups/update internal更新现有卡组。
Request Body
使用 SecureChannelRequest<CardGroupUpdatePayload> 包裹：
| Name | Type | Required | Description |
|---|---|---|---|
cardGroupId | string | Required | 要更新的卡组 ID |
request | UpdateCardGroupRequest | Required | 更新字段 |
Response
返回更新后的 CardGroup。
Update Spending Constraint
POST
/partner/channel/slash/card-groups/spending-constraint internal为卡组设置或更新消费限制。
Request Body
使用 SecureChannelRequest<CardGroupSpendingConstraintRequest> 包裹：
| Name | Type | Required | Description |
|---|---|---|---|
cardGroupId | string | Required | 卡组 ID |
spendingConstraint | SpendingConstraint | Required | 消费限制配置 |
Response
返回更新后的 CardGroup。
Get Card Group Utilization
POST
/partner/channel/slash/card-groups/utilization internal获取卡组当前的额度使用情况（已消费与限额对比）。
Request Body
使用 SecureChannelRequest<CardGroupUtilizationRequest> 包裹：
| Name | Type | Required | Description |
|---|---|---|---|
cardGroupId | string | Required | 卡组 ID |
Response
返回 CardGroupUtilization。