预下单
收藏
我的收藏抖音侧调用第三方服务商接口推送用户预下单消息,返回结果。
使用限制
无
接口说明
- 1.预下单请求成功:务必确保状态码为 0。
- 2.预下单请求失败:不可下单情况需要服务商返回原因,如果不在列举的原因内,服务商返回 error_code=20 并附加失败原因。
- 3.SPI 超时响应时间为 5s,超时响应则为无效响应。
- 4.接口需要返回手机号信息,需要找抖音侧业务同学反馈该需求,业务审批后才会有用户留资信息。
- 5.如果第三方响应不规范或者响应超时,抖音默认允许下单,会走后续链路。
基本信息
HTTP URL | 地址由服务商提供 | |||
HTTP Method | POST | |||
权限要求 |
|
服务商/商家侧 SPI 接口配置
配置路径:开放平台-服务商平台/开发者平台-控制台-应用详情页-开发设置- SPI 回调。
需配置接口:
接口 | 回调场景(配置SPI回调地址时可见) | 需提供信息 | 是否必填 |
预下单 | 抖音请求三方系统预下单 | 回调地址:预下单URL | 必填 |
发券 | 抖音请求三方系统发码 | 回调地址:发券URL | 必填 |
退款 | 抖音请求三方系统退款审核 | 回调地址:退款URL | 必填 |
信息同步 | 抖音向三方系统同步退款信息 | 回调地址:信息同步URL | 必填 |
签名规则
请求参数
Body 请求
参数名称 | 参数类型 | 参数描述 |
order_id | string | 抖音订单ID |
sku_id | string | 抖音的商品ID |
third_product_id | string | 第三方商品ID |
count | int32 | 该笔订单包含的券数量 |
order_item_id | list | 券维度的订单id,抖音内部使用,服务商可忽略 |
third_sku_id | string | 三方服务商侧的商品ID |
order_type | int32 | 订单类型,21-团购 31-预售 41-配送 |
original_amount | int32 | 原始金额,单位分(含税) |
currency_code | string | 货币类型(默认人民币CNY) |
create_order_time | int64 | 订单创建时间 时间戳(秒) |
tourists | struct | 游客信息,使用人,景区门票等场景使用 |
.name | string | 姓名 2024年2月29日起,若用户下单商品不属于下列一级商品类目(住宿(8000000), 游玩(18000000), 度假旅游服务(32000000), 交通出行(31000000)),该字段脱敏 |
.phone | string | 联系电话(加密) 2024年2月29日起,若用户下单商品不属于下列一级商品类目(住宿(8000000), 游玩(18000000), 度假旅游服务(32000000), 交通出行(31000000)),该字段脱敏 |
.id_card | string | 身份证号(加密) 2024年2月29日起,若用户下单商品不属于下列一级商品类目(住宿(8000000), 游玩(18000000), 度假旅游服务(32000000), 交通出行(31000000)),该字 段脱敏 |
.name_info_list | struct | 姓名信息 |
..name_type | int64 | 姓名类型 1:中文 2:英文 |
..name_value | string | 姓名全称 |
..first_name | string | 英文名的名 |
..last_name | string | 英文名的姓 |
.license_info_list | struct | 证件信息 |
..license_type | int64 | 证件类型 1:身份证 2:港澳通行证 3:台湾通行证 4:回乡证 5:台胞证 6:护照 7:外籍护照 8:外国人永居证 |
..license_id | string | 证件号 |
..license_validity | string | 证件有效期 |
.contact_info_list | struct | 联系方式信息 |
..contact_info_type | int64 | 联系方式类型 1:电话号码 2:邮箱 |
..contact_info_value | string | 联系方式值 |
..area_code | string | 电话号码的区号 |
contact | struct | 游客信息,联系人,用户手机号信息 |
.complete_phone | string | 联系电话(加密) 2024年2月29日起,若用户下单商品不属于下列一级商品类目(住宿(8000000), 游玩(18000000), 度假旅游服务(32000000), 交通出行(31000000)),该字段下线 |
.name | string | 姓名 2024年2月29日起,若用户下单商品不属于下列一级商品类目(住宿(8000000), 游玩(18000000), 度假旅游服务(32000000), 交通出行(31000000)),该字段脱敏 |
.phone | string | 联系电话(脱敏) |
.name_info_list | struct | 姓名信息 |
..name_type | int64 | 姓名类型 1:中文 2:英文 |
..name_value | string | 姓名全称 |
..first_name | string | 英文名的名 |
..last_name | string | 英文名的姓 |
.contact_info_list | struct | 联系方式信息 |
..contact_info_type | int64 | 联系方式类型 1:电话号码 2:邮箱 |
..contact_info_value | string | 联系方式值 |
..area_code | string | 电话号码的区号 |
备注:字段描述备注了(加密)的字段,需要进行字段解密方可看到字段信息,如何解密请参考本文最下方内容。
请求示例
{ "order_id": "order_id", "third_product_id": "third_product_id", "sku_id": "1", "count": 1, "order_item_id": ["order_item_id"], "third_sku_id": "1", "order_type": 21, "original_amount": 1, "currency_code": "CNY", "create_order_time": 1, "contact": { "name": "name", "phone": "123", "complete_phone": "123" "name_info_list": [ { "name_type": 1, "name_value": "name" } ], "contact_info_list": [ { "contact_info_type": 1, "contact_info_value": "123" } ] }, "tourists": [ { "name": "张三", "phone": "13800000000", "id_card": "310115199807013370" "name_info_list": [ { "name_type": 1, "name_value": "张三" } ], "license_info_list": [ { "license_type": 1, "license_id": "310115199807013370", "license_validity": "" } ], "contact_info_list": [ { "contact_info_type": 1, "contact_info_value": "13800000000" } ] }, { "name": "李四", "phone": "13900000000", "id_card": "310115199912130020" "name_info_list": [ { "name_type": 1, "name_value": "李四" } ], "license_info_list": [ { "license_type": 1, "license_id": "310115199912130020", "license_validity": "" } ], "contact_info_list": [ { "contact_info_type": 1, "contact_info_value": "13900000000" } ] } ] }
响应参数
参数名称 | 参数类型 | 参数描述 |
data | struct | |
.error_code | int32 | 失败错误码,失败必填 |
.description | string | 失败原因 |
.ext_order_id | string | 第三方订单号,成功情况下必填 |
响应示例
{ "data": { "error_code": 0, "description": "success", "ext_order_id": "11" //三方订单号 } }
错误码
error_code | 失败原因 | 是否透传用户 |
1 | 商品不存在 | 是 |
2 | 商品已下线 | 是 |
3 | 未到商品开始售卖时间 | 是 |
4 | 已过商品结束售卖时间 | 是 |
5 | 商品库存售罄 | 是 |
6 | 已达到购买上限 | 是 |
7 | 价格校验失败 | 否 |
20 | 其他异常(服务商自定义) | 否 |
加密字段解密