【SPI】生成订单并冻结优惠

我的收藏

接口说明

使用场景：发起收银时使用三方码意向金代金券需接入此SPI接口，和【撤销订单并解冻优惠】接口一起接入

用户使用抖音扫码买单时，需要商家通过开平SPI接口在三方系统冻结优惠资产（如意向金代金券）

核心能力

operate_type=1，冻结优惠（如意向金代金券）

operate_type=2，生成订单并冻结优惠资产（如意向金代金券），暂不支持，未来开放

重要：接口需保证幂等性，幂等成功返回成功状态码

名称	描述
HTTP Method	POST
Scope	life.capacity.homed.trade.order.createAndFreeze
权限要求	抖音开放平台路径：开发者平台/服务商平台>控制台>应用详情>解决方案商家授权路径：抖音来客>店铺管理>第三方应用授权

名称	字段类型	是否必填	示例	描述
content-type	String	是		固定值"application/json"

参数名	参数类型	是否必填	描述	示例值
operate_type	int32	是	操作类型： 1 冻结优惠资产； 2 生成买单订单并冻结优惠资产（意向金or代金券），暂不支持，未来开放；	1
pre_order_id	string	否	抖音侧预订单ID（对应发起收银接口返回的pre_order_id），当operate_type=1时，pre_order_id必填	"123"

响应示例

正常响应示例

{
    "data": {
        "result_code": 0,
        "result_description": "success"
    }
}

失败响应示例

{
    "data": {
        "result_code": 1,
        "result_description": "冻结失败，原因xxx"
    }
}