补全一些基础信息
This commit is contained in:
+13
-4
@@ -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卡券` 客服/对接方时,建议一次性确认以下配置:
|
||||
|
||||
Reference in New Issue
Block a user