跳转到主要内容
创建产品组以组织相关订阅商品。 
POST /v1/actions/subscription-product-group/create-group
认证方式： API Key

​
请求体

字段类型必需说明
storeIdstring是Store ID（STO_xxx 格式）
namestring是组名称（每个门店 + 环境唯一）
descriptionstring否组描述
rulesobject否组规则（{ sharedTrial: boolean }）
productIdsstring[]否要包含的订阅商品 ID（PROD_xxx 格式）

​
请求示例

const { group } = await client.subscriptionProductGroups.create({
  storeId: "STO_2D5F8G3H1K4M6N9P",
  name: "Pricing Plans",
  description: "Free, Pro, and Enterprise tiers",
  rules: { sharedTrial: true },
  productIds: [
    "PROD_3F7H2J5L8N1Q4S6U",
    "PROD_8B4D6F9H2K5M7P1R",
    "PROD_1C3E5G7J0L2N4Q6S",
  ],
});

​
成功响应 (200)

{
  "data": {
    "group": {
      "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",
      "storeId": "STO_2D5F8G3H1K4M6N9P",
      "name": "Pricing Plans",
      "description": "Free, Pro, and Enterprise tiers",
      "rules": { "sharedTrial": true },
      "productIds": [
        "PROD_3F7H2J5L8N1Q4S6U",
        "PROD_8B4D6F9H2K5M7P1R",
        "PROD_1C3E5G7J0L2N4Q6S"
      ],
      "environment": "test",
      "createdAt": "2026-03-30T10:30:00.000Z",
      "updatedAt": "2026-03-30T10:30:00.000Z"
    }
  }
}

​
错误响应

重试策略：4xx 一律不要重试 — 修正请求后重发。5xx 指数退避重试（起步 5s，最多 3 次）。
状态码errors[0].message含义推荐处理
400Missing or invalid header: x-context-environmentenvironment 请求头缺失或不是 test / prod修正请求头后重发
400Missing required fields: storeId, name必填字段缺失补齐字段后重发
400Expected format: STO_xxx, got "..." / Expected format: PROD_xxx, got "..."storeId 或 productIds 中的 Short ID 无法解码修正 ID 后重发
500Internal server error内部错误或瞬时下游故障指数退避重试（起步 5s，最多 3 次）