通知酒店取消订单

我的收藏

接口说明

抖音侧通知第三方取消订单。

基本信息

Scope	life.capacity.trip_trade_after_sale
权限要求	酒店日历房解决方案-交易逆向能力
回调场景	酒店取消订单

Header

•

Content-Type：application/json

•

X-Bytedance-Logid: 请求 logid，用于问题排查用

•

x-life-clientkey: 服务商应用的 client_key

•

X-life-sign: 请求签名，签名规则

Body

参数名称	参数类型	必须参数	备注
» order_id	string	必填	抖音侧订单 ID
» cancel_id	string	必填	订单取消唯一标识
» order_out_id	string	选填	第三方订单 ID 创单失败取消case无该值
» penalty	int	选填	罚金（分）
» currency	string	选填	价格币种，CNY，USD国际标准枚举值非国内大陆商家必填
» cancel_reason	string	选填	取消原因
» cancel_order_time_unix	int	选填	取消订单的时间戳，秒
» cancel_type	int	必填	取消类型( 1：支付前取消 2：支付后取消 3：创单失败取消（支付和创单是独立的，所以存在支付成功后前面创单失败，这种case我们也会发起取消通知）
» biz_type	int	必填	~~2011：酒店预售券~~ 2012:酒店预约单 2021:日历房
» applicant_type	int	选填	申请人类型 1：用户 2：客服/运营 3：商家 99：系统触发 0：未知
» negotiate_refund	bool	选填	true表示协商退，false表示非协商退

json示例

{
    "order_id": "1000946099201940764",
    "cancel_id": "11111",
    "cancel_type": 1,
    "order_out_id": "Vhtue3U3pM",
    "penalty": 10000,
    "currency": "CNY",
    "cancel_reason": "用户取消",
    "cancel_order_time_unix": 1682006400,
    "biz_type": 2011,
    "negotiate_refund": false, 
}

响应参数

Body

参数名称	参数类型	必须参数	备注
data	struct	必填
» error_code	int	必填	错误码详见
» description	string	选填	描述信息
» cancel_mode	int	必填	取消订单方式必须传递，否则会导致退款发起超时退 1：同步取消同步取消需要回传cancel_result 2：异步取消抖音侧保持待取消状态，三方需要回调取消审核接口
» cancel_result	int	必填	同步取消的case下必传cancel_result 1:同意 2:拒绝需要提前联系业务加白,加白后置信此结果,否则规则内会直接退款给用户
» refund_fee_amount	int	选填	退款手续费金额，分无手续费情况或者支付前退款无手续费
» reason	string	选填	拒绝原因取消失败需要传

json示例

{
    "data":{
    "error_code": 0,
    "description": "success",
    "cancel_mode": 1,
    "cancel_result": 1,
    "refund_fee_amount": 1000,
    "reason": "用户取消"
    }
}