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，实现选配权益叠加。

开启您的跨境之旅马上联系我们

建站开发客服

建站客服

设计师（制作Figma原型）