跳转到主要内容
激活或停用订阅商品。 
POST /v1/actions/subscription-product/update-status
认证方式： API Key

​
请求体

字段类型必需说明
idstring是商品 ID（PROD_xxx 格式）
statusstring是active 或 inactive

​
请求示例

import { ProductVersionStatus } from "@waffo/pancake-ts";

await client.subscriptionProducts.updateStatus({
  id: "PROD_3F7H2J5L8N1Q4S6U",
  status: ProductVersionStatus.Inactive,
});

​
成功响应 (200)

{
  "data": {
    "product": {
      "id": "PROD_3F7H2J5L8N1Q4S6U",
      "storeId": "STO_2D5F8G3H1K4M6N9P",
      "name": "Pro Plan",
      "description": "Full access to all Pro features.",
      "billingPeriod": "monthly",
      "prices": {
        "USD": { "amount": "29.00", "taxCategory": "saas" },
        "EUR": { "amount": "27.00", "taxCategory": "saas" }
      },
      "media": [],
      "successUrl": "https://example.com/welcome",
      "metadata": { "trialDays": 14 },
      "status": "inactive",
      "createdAt": "2026-03-30T10:30:00.000Z",
      "updatedAt": "2026-03-30T13:00:00.000Z"
    }
  }
}

​
响应字段

与 创建订阅商品响应 相同。
停用订阅商品会阻止新注册，但不会取消现有活跃订阅。订阅者继续其当前计费周期不受影响。

​
错误响应

重试策略：4xx 一律不要重试 — 修正请求后重发。5xx 指数退避重试（起步 5s，最多 3 次）。
状态码errors[0].message含义推荐处理
400Missing header: x-context-merchant-id商户上下文 header 未透传修正 SDK 配置
400Missing or invalid header: x-context-environment环境 header 缺失或不是 test / prod把 X-Environment 设为 test 或 prod
400Missing required field: id请求体缺少 id补齐 id 后重发
400Expected format: PROD_xxx, got "X"id 不是合法 Short ID使用 PROD_ 前缀的 Short ID
400Invalid or missing status (must be 'active' or 'inactive')status 缺失或不在允许集合改为 active 或 inactive
400消息包含 has no version目标环境（test 或 prod）尚无版本先在该环境创建版本（从 test 发布，或在 test 创建）
401Unauthorized认证失败检查 API Key、时间戳与签名
404Product not found / Current version not foundproduct ID 不存在（或当前版本缺失）确认 product ID
500Internal server error瞬时下游故障指数退避重试（起步 5s，最多 3 次）