下单确认(待下线)
收藏我的收藏
抖音侧向服务商发起下单前确认,服务商需告知抖音侧当前条件下是否可下单。
使用限制
无
接口说明
1、抖音侧向服务商发起下单前确认,服务商需告知抖音侧当前条件下是否可下单。
2、接口请求成功时务必确保返回的 error_code=0,确认的结果通过 result 字段返回。
3、不可下单情况需要服务商返回原因,定义了 9 种失败原因,枚举为 fail_code 字段,如果不在这 9 种原因内,服务商返回 fail_code=10,并且用 other_fail_msg 附加失败原因。
4、SPI 响应超时时间为 8s,超过 8s 则为无效响应。
5、如果第三方响应不规范或者响应超时,抖音默认允许下单,会走后续链路。
基本信息
HTTP URL | 地址由服务商提供 | |||
HTTP Method | POST | |||
申请权限 | 三方码发布 | |||
权限要求 |
| |||
服务商/商家侧 SPI 接口配置
配置路径:开放平台 - 服务商平台/开发者平台 - 控制台 - 应用详情页 - 开发设置 - SPI 回调。
需配置接口:
接口 | 回调场景(配置SPI回调地址时可见) | 需提供信息 | 是否必填 |
预下单 | 抖音请求三方系统预下单 | 回调地址:预下单URL | 必填 |
下单确认 | 抖音请求三方系统预下单校验 | 回调地址:订单确认URL | 可选 |
发券 | 抖音请求三方系统发码 | 回调地址:发券URL | 必填 |
退款 | 抖音请求三方系统退款审核 | 回调地址:退款URL | 必填 |
信息同步 | 抖音向三方系统同步退款信息 | 回调地址:信息同步URL | 必填 |
签名规则
请求头
地址由服务商提供。
请求参数
Body 请求
参数名称 | 参数类型 | 参数描述 | 必需 |
count | int | 发码数量 | 是 |
sku_id | string | 抖音的商品ID | 是 |
third_sku_id | string | 三方服务商侧的商品ID | 是 |
amount | object | 金额信息 | 否 |
.original_amount | int | 原始金额,单位分(不建议用) | 否 |
.actualoriginalamount | int | 原始金额,单位分(建议用) | 否 |
.pay_amount | int | 实付金额,单位分 | 否 |
.ticket_amount | int | 平台营销金额,单位分 | 否 |
.merchant_ticket_amount | int | 商家营销金额,单位分 | 否 |
.discountamount | int | 平台和商家优惠总金额,单位分(不包含支付优惠) | 否 |
contact | object | 已弃用,联系人信息 | 否 |
.name | string | 姓名 *非酒旅/票务场景,2024年2月29日起脱敏 | 否 |
.phone | string | 联系电话 *非酒旅/票务场景,2024年2月29日起脱敏 | 否 |
tourists | list(object) | 出行人信息 | 否 |
.name | string | 姓名 *非酒旅/票务场景,2024年2月29日起脱敏 | 否 |
.phone | string | 联系电话 *非酒旅/票务场景,2024年2月29日起脱敏 | 否 |
.id_card | string | 身份证号码 *非酒旅/票务场景,2024年2月29日起脱敏 | 否 |
请求示例
{ "count": 2, "sku_id": "23456", "third_sku_id": "345678", "amount": { "original_amount": 10000, "pay_amount": 8000, "ticket_amount": 1000, "merchant_ticket_amount": 1000 }, "contact": { "name": "张三", "phone": "13800000000" }, "tourists": [ { "name": "张三", "phone": "13800000000", "id_card": "310115199807013370" }, { "name": "李四", "phone": "13900000000", "id_card": "310115199912130020" } ] }
响应参数
字段名称 | 字段类型 | 字段描述 |
data | struct | |
.error_code | int64 | 接口错误码,响应返回必须保证是0 |
.description | string | 接口错误描述 |
.result | int32 | 确认结果. 1:允许下单,2:不可下单 |
.fail_code | int32 | 如果不可下单,返回原因code(枚举见下表) |
.other_fail_msg | string | 如果不可下单的原因不在枚举范围内,用该字段返回原因 |
响应示例
正常示例
{ "data": { "error_code": 0, "description": "success", "result": 1, "fail_code": 0, "other_fail_msg": "" } }
异常示例
{ "data": { "error_code": 10, "description": "success", "result": 1, "fail_code": 0, "other_fail_msg": "" } }
错误码
HTTP 状态码(error_code) | 错误码(fail_code | 描述 | 排查建议 |
请求成功返回 0 | 1 | 商品不存在 | 确认商品信息及状态是否准确 |
2 | 商品已下架 | 确认商品信息及状态是否准确 | |
3 | 商品库存不足 | 确认商品库存状态是否准确 | |
4 | 商品周期库存不足 | 确认商品库存状态是否准确 | |
5 | 商品限购不足 | 确认商品信息及状态是否准确 | |
6 | 商品周期限购不足 | 确认商品信息及状态是否准确 | |
7 | 锁库存失败 | 确认商品库存状态是否准确 | |
8 | 商户不存在 | 确认商户账户信息及状态是否正确 | |
9 | 商户异常 | 确认商户账户信息及状态是否正确 | |
10 | 其他异常(服务商自定义) | 服务商自行排查 |

