补全一些基础信息

This commit is contained in:
yml2213
2026-05-13 20:18:58 +08:00
parent c2fd9078b9
commit a95e48b708
23 changed files with 1237 additions and 89 deletions
+13 -4
View File
@@ -78,6 +78,7 @@ https://你的域名/api/v1/open/91
- `productNo` 对应当前项目内部 `skuCode`
- 再由现有快手履约配置,匹配到 `kuaishou_ct_assisted` 履约链路
-`productNo` 暂未配置,订单会先进入后台“91卡券待补全订单”队列,不直接丢弃。
## 6. 异步下单接口配置
@@ -124,7 +125,7 @@ Content-Type: application/json;charset=utf-8
- 验签失败:直接返回失败。
- `orderNo` 已存在:按幂等处理,返回已有订单状态。
- `productNo` 未配置:返回失败
- `productNo` 未配置:保存为待补全订单,返回处理中
- 成本超限:返回失败,错误码可用 `1220`
- 下单成功后:
- 创建内部订单;
@@ -183,6 +184,7 @@ Content-Type: application/json;charset=utf-8
### 7.4 查询处理规则
- 找不到订单:返回失败。
- 订单已创建但履约配置尚未补齐:返回 `orderStatus = 10`
- 订单已创建但领取链接未准备好:返回 `orderStatus = 10`
- 领取链接已生成,可交付:返回 `orderStatus = 20`
- 订单无法履约:返回 `orderStatus = 30`,并带失败原因。
@@ -272,16 +274,16 @@ Content-Type: application/json;charset=utf-8
### 10.1 91侧状态
- `10`: 已下单,当前项目正在生成领取链接
- `10`: 已下单,当前项目正在补齐履约配置或生成领取链接
- `20`: 已可交付,91 可自动发货给买家
- `30`: 无法履约
### 10.2 当前项目侧状态建议
- 创建订单成功:进入待履约
- 创建订单成功:若履约配置已命中则进入待履约;若未命中则进入后台待补全
- 已生成 `claimUrl`:视为可交付
- 查询接口检测到 `claimUrl` 已存在:返回 `20`
- 配置缺失、商品未匹配、履约初始化失败:返回 `30`
- 商家后台手动标记无法履约、履约初始化失败:返回 `30`
## 11. 商品配置建议
@@ -292,6 +294,13 @@ Content-Type: application/json;charset=utf-8
- 发货类型:异步卡密
- 买家收到内容:领取链接
后台补全路径:
1. 进入“平台配置 -> 91卡券接入”查看待补全订单;
2. 根据订单中的 `productNo` 到“履约配置中心 -> 快手 Cloud 新履约”新增或补齐规则;
3. 规则保存后回到“91卡券接入”,点击“重试生成任务”;
4. 任务生成后,查询接口会在领取链接准备好时返回 `orderStatus = 20`
## 12. 对接方需确认的固定项
发给 `91卡券` 客服/对接方时,建议一次性确认以下配置: