v1.1.0 更新说明

更新日期：2026-07-02

一句话概览

v1.1.0 将公开兑换流程从单一 ChatGPT 兑换扩展为 ChatGPT 与 Claude 双服务商兑换。接口路径保持不变，主要变化是新增 provider 服务商字段、Claude 账号预检方式、服务商匹配校验、订单查询返回字段和支付结果确认状态。

变化级别

级别	结论	说明
接口路径	不变	仍使用 `/api/v1/sub` 下已有 5 个公开接口。
请求方法	不变	仍全部使用 `POST`。
ChatGPT 流程	兼容	原有 ChatGPT 调用方式继续可用。
Claude 流程	新增	Claude 兑换需要先校验 CDK，再提交 Claude `sessionKey` 做账号预检。
响应字段	扩展	多个接口新增 `provider`，旧调用方可忽略。
订单轮询	增强	订单对象可通过 `payment_result_checking` 表示支付结果确认中。

服务商字段

新增统一服务商字段 provider。调用方应优先使用该字段判断当前兑换服务，不建议只通过 plan 前缀判断。

值	含义	适用范围
`openai`	ChatGPT 订阅兑换	默认服务商，兼容原流程。
`claude`	Claude 订阅兑换	v1.1.0 新增。

接口变化总览

接口	是否改路径	请求变化	响应变化	调用方影响
`verifyCdk`	否	新增可选 `expected_provider`	成功响应新增 `provider`	用于校验用户选择的服务商是否和 CDK 匹配。
`precheckAccount`	否	新增 `cdk`、`activation_token`	新增 `provider`、`account_id`、`account_name` 等	Claude 预检必须带上 CDK 锁定信息。
`redeem`	否	字段不变	成功响应新增 `provider`	提交时会校验 token 和 CDK 服务商一致。
`redeemResult`	否	字段不变	顶层和 `order` 新增 `provider`，订单对象可返回 `payment_result_checking`	轮询页面需要识别服务商和支付确认状态。
`queryOrder`	否	字段不变	有订单时顶层和 `order` 新增 `provider`	查询结果可展示 ChatGPT 或 Claude；空结果仍保持隐私保护。

详细变化

1. CDK 校验增加服务商校验

verifyCdk 请求体新增可选字段 expected_provider。

{
  "cdk": "AUTO-SUB-ABCDEFGH",
  "expected_provider": "claude"
}

成功响应新增 provider。

{
  "code": 200,
  "error": "",
  "activation_token": "7f2b4c6d8e...",
  "expires_in": 180,
  "expires_at": "2026-07-02T12:10:00Z",
  "provider": "claude",
  "product_name": "Claude Pro",
  "plan": "claudepro"
}

如果用户选择的服务商与 CDK 实际服务商不一致，业务返回失败。

{
  "code": 0,
  "error": "该 CDK 属于 Claude 兑换，请切换后继续"
}

2. 账号预检支持 Claude

precheckAccount 请求体新增 cdk 和 activation_token。系统会通过 CDK 锁定记录判断当前应执行 ChatGPT 预检还是 Claude 预检。

{
  "token": "zstd64:KLUv/QBY...",
  "cdk": "AUTO-SUB-ABCDEFGH",
  "activation_token": "7f2b4c6d8e..."
}

ChatGPT 场景：token 仍是完整 session JSON 压缩后的 zstd64:<base64>。

Claude 场景：token 是原始 sessionKey 字符串压缩后的 zstd64:<base64>。

Claude 账号预检成功示例：

{
  "code": 200,
  "error": "",
  "provider": "claude",
  "email": "user@example.com",
  "name": "user@example.com",
  "account_id": "org_xxx",
  "account_name": "user@example.com's Organization",
  "plan_type": "claude",
  "subscription_plan": "",
  "has_active_subscription": false,
  "eligible": true
}

新增响应字段说明：

字段	类型	说明
`provider`	string	当前账号预检对应的服务商。
`account_id`	string	服务商账号或组织标识，可能为空。
`account_name`	string	服务商账号或组织名称，Claude 场景可能返回。
`subscription_plan`	string	当前账号订阅方案标识，可能为空。
`has_active_subscription`	boolean	当前账号是否已有有效订阅。

3. 提交兑换增加服务商一致性校验

redeem 请求字段不变。

{
  "token": "zstd64:KLUv/QBY...",
  "cdk": "AUTO-SUB-ABCDEFGH",
  "activation_token": "7f2b4c6d8e..."
}

成功响应新增 provider。

{
  "code": 200,
  "error": "",
  "provider": "claude",
  "plan": "claudepro",
  "product_name": "Claude Pro",
  "order_no": "SO202607020001",
  "status": "processing",
  "order_query_token": "eyJvcmRlcl9ubyI6IlNPMjAyNjA3MDIwMDAxIiwiZXhwIjoxNzg...signature"
}

本版本新增或明确了以下失败提示：

错误提示	含义	建议处理
`登录态与 CDK 服务商不匹配，请切换后重试`	token 和 CDK 不属于同一服务商。	引导用户切换服务商后重新校验 CDK。
`请先验证 CDK`	Claude 账号预检缺少 CDK 锁定信息。	重新从 `verifyCdk` 开始流程。
`账号KYC`	当前账号需要完成 KYC，无法继续兑换。	提示用户处理账号状态或更换账号。
`当前账号已是付费账号，不能重复订阅`	目标账号已有有效订阅。	阻止继续提交兑换。

4. 订单查询返回服务商和支付确认状态

redeemResult 和 queryOrder 在查询到订单时，会返回服务商信息。

顶层新增字段：

字段	类型	说明
`provider`	string	订单服务商。

order 对象新增或重点字段：

字段	类型	说明
`provider`	string	订单服务商。
`payment_result_checking`	boolean	是否正在确认支付结果。为 `true` 时订单仍可能是 `processing`。
`attempt_current`	integer	当前兑换尝试次数。
`attempt_max`	integer	最大兑换尝试次数。
`retrying`	boolean	是否正在自动重试。

支付确认中示例：

{
  "code": 200,
  "error": "",
  "provider": "claude",
  "product_name": "Claude Pro",
  "plan": "claudepro",
  "order": {
    "order_no": "SO202607020001",
    "account": "user@example.com",
    "provider": "claude",
    "status": "processing",
    "plan": "claudepro",
    "product_name": "Claude Pro",
    "country": "US",
    "currency": "USD",
    "amount_minor": 2000,
    "error": "支付结果确认中，请稍后查询",
    "started_at": "2026-07-02T12:05:00Z",
    "finished_at": null,
    "duration_ms": 0,
    "attempt_current": 1,
    "attempt_max": 3,
    "retrying": false,
    "payment_result_checking": true
  }
}

queryOrder 的空结果策略不变：不存在 CDK 或暂无订单时仍统一返回空结果，不返回服务商和产品详情。

{
  "code": 200,
  "error": "",
  "cdk_status": "unused",
  "order": null
}

调用方关注点

provider 是本版本最重要的新增字段，展示和流程判断都应优先使用它。

Claude 账号预检必须依赖已锁定 CDK，因此 precheckAccount 需要同时传 cdk 和 activation_token。

payment_result_checking=true 不是最终失败，适合展示“支付结果确认中，请稍后查询”，并继续轮询或引导用户稍后查询。

queryOrder 空结果仍不代表 CDK 一定存在，不应据此展示 CDK 的真实存在性。

原有 ChatGPT 调用方可以逐步接入新增字段，不需要立即改造全部展示逻辑。

v1.1.0 更新说明（2026-07-02）

v1.1.0 更新说明

一句话概览

变化级别

服务商字段

接口变化总览

详细变化

1. CDK 校验增加服务商校验

2. 账号预检支持 Claude

3. 提交兑换增加服务商一致性校验

4. 订单查询返回服务商和支付确认状态

推荐调用流程

ChatGPT 兑换

Claude 兑换

调用方关注点

v1.1.0 更新说明（2026-07-02）

v1.1.0 更新说明#

一句话概览#

变化级别#

服务商字段#

接口变化总览#

详细变化#

1. CDK 校验增加服务商校验#

2. 账号预检支持 Claude#

3. 提交兑换增加服务商一致性校验#

4. 订单查询返回服务商和支付确认状态#

推荐调用流程#

ChatGPT 兑换#

Claude 兑换#

调用方关注点#

v1.1.0 更新说明

一句话概览

变化级别

服务商字段

接口变化总览

详细变化

1. CDK 校验增加服务商校验

2. 账号预检支持 Claude

3. 提交兑换增加服务商一致性校验

4. 订单查询返回服务商和支付确认状态

推荐调用流程

ChatGPT 兑换

Claude 兑换

调用方关注点