通知外部商家创单
收藏使用限制
无
接口说明
抖音侧通知第三方创建提货券订单。ClientKey 维度默认配置是 抖音侧支付成功后 通知第三方创单。
基本信息
Scope | life.capacity.comprehensive_retail_create_order | |||
权限要求 | 综合到店提货解决方案 > 提货券三方码交易能力 | |||
回调场景 | | |||
请求头
- •Content-Type：
application/json- •X-Bytedance-Logid: 请求 logid， 用于问题排查用
- •x-life-clientkey: 服务商应用的 client_key
- •X-life-sign: 请求签名，签名规则
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
order_id | string | 是 | 抖音订单 ID（可作幂等键） | 100001 |
open_id | string | 是 | 经过网关加密的用户ID，购买人 | |
account_id | string | 是 | 商家ID | |
poi_id | string | 是 | 抖音POI_ID（即门店id） | |
sku_list | list | 是 | | |
- sku_id | string | 是 | 抖音侧规格 ID | |
- product_id | string | 是 | 抖音侧商品 ID | 1773200310436864 |
- sku_out_id | string | 否 | 第三方规格 ID | |
- product_out_id | string | 否 | 第三方商品 ID | 1773200310436864 |
- count | int | 是 | 购买份数 | 3 |
- unit_amount | int | 是 | 商品单价 | 10000 |
amount | struct | 是 | 金额信息，订单金额结构 | |
- origin_amount | int | 是 | 订单原价=商品售卖价*购买数量 | 30000 |
- discount_amount | int | 是 | 订单总优惠金额 | |
- pay_amount | int | 是 | 订单总支付金额 | |
请求示例
{ "order_id": "123432212", "open_id": "dgyqwue2", "account_id": "739262934322", "poi_id": "42289371811", "sku_list": [{ "sku_id": "3211", "product_id": "132", "count": 1, "unit_amount": 100 }], "amount": { "origin_amount": 100, "discount_amount": 0, "pay_amount": 0 } }
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | struct | 是 | | |
- error_code | int | 是 | 错误码，合法范围为 [0,999999] | 0 |
- description | string | 是 | 错误信息 | |
- order_id | string | 是 | 抖音订单ID | "10011123" |
- order_out_id | string | 否 | 外部订单ID，创建订单成功时必填 | "1233" |
响应示例
{ "data":{ "error_code":0, "description":"success", "order_id": "123", "order_out_id": "123", } }
错误码
创单成功：error_code必须设置为0
请求需要重试：error_code必须设置为300
创单失败：error_code不能设置为0或300，参考下列错误码说明对失败原因进行分类。
error_code | description | 备注 |
0 | success | 成功 |
110 | | 库存不足 |
130 | | 商品已下架 |
200 | | 限购 |
300 | ... | 抖音侧需要重试，其他错误码抖音不重试 |
400～499 | | 其他自定义错误 |
