OpenTest 项目：API 接口补齐与全业务逻辑规范

API 接口补齐与业务逻辑规范

文档生成日期：2026.01.16 | WordPress 计费端与后端对接专用

1. ⚠️ 后端 API 待完善清单

以下内容为目前 API 文档缺失，需开发配合补齐：

接口 1 增加签名校验：增加 sign 字段。由于由 WordPress 发起资产发放通知，必须通过 MD5 签名校验安全性。
接口 1 增加原订单关联：针对 UPGRADE 类型，必须传 originalOrderNo。后端需据此定位旧资产并执行 SKU 更新。
接口 4 增加设备名称返回：需返回 machineName。否则用户在个人中心无法识别不同电脑进行解绑操作。
接口 4 增加离线剩余次数：需返回 remainingOfflineUnbindCount。用于限制离线授权 1 年仅限 3 次解绑。

2. 升级 (UPGRADE) 核心履约规则

个人版资产处理： 为保证授权码一致性，个人版升级采取 "覆盖更新" 逻辑。
1. 支付成功后，WP 发送请求包含 orderType: UPGRADE 及 originalOrderNo.
2. 后端定位原订单关联的授权码，仅更新其 skuCode 字段，不生成新码.
3. 升级仅变更权限，有效期原则上保持不变。

3. 升级计费折算公式 (WP 执行)

升级仅支持单向向上。WordPress 插件按以下公式计算差价订单金额：

补交金额 = 新套餐价格 - ( 原套餐实付价 / 原套餐总天数 * 剩余可用天数 )

4. 授权码生成逻辑分类汇总

业务维度	购买场景	后端履约动作说明
个人版套餐	新购 (NEW)	生成新授权码并自动绑定。
	续费 (RENEW)	不生成新码，更新原码的过期时间 (EndTime)。
	升级 (UPGRADE)	不生成新码，更新原码的 SKU 编码。
团队版套餐	所有场景	每个席位独立生成一个新授权码。
选配包	新购/团队购买	生成对应数量的新选配包授权码。

5. 授权码绑定/解绑规则 (接口 3)

无资产状态：直接执行 BIND 操作。
已有套餐状态：系统需引导并先调用 UNBIND 解绑老授权码，再执行新码 BIND。
已有选配包状态：允许直接执行 BIND，实现选配权益叠加。

Beginnen Sie Ihre grenzüberschreitende ReiseKontaktieren Sie uns jetzt

Kundendienst für die Entwicklung von Websites

Kundenbetreuung

Designer (Herstellung von Figma-Prototypen)