抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮在线点单解决方案
  • 随心团解决方案
  • 订单推送
  • 订单支付成功 Webhook
  • 订单已接单消息 Webhook
  • 订单已拒单消息 Webhook
  • 订单退款信息同步 Webhook
  • 订单已同意/已拒绝退款消息 Webhook
  • 配送状态变更消息 Webhook
  • 账单确认Webhook
  • 订单已部分退消息 Webhook
  • 订单完成消息webhook
  • 订单配送
  • 订单查询
  • 订单接单
  • 订单退款
  • 门店配送设置
  • 结算对账
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 消息说明

      订单退款成功后,平台会将订单已取消的消息推送给第三方系统,消息中会有具体的取消类型和原因

    对应申请能力

    订单推送
    Scope
    life.capacity.order.notice
    权限要求
    回调场景

    请求头字段

    字段
    说明
    Msg-Id
    同一实体下同一action的msg_id相同,服务商可根据msg_id对于消息去重
    X-Douyin-Signature
    抖音侧签名,服务商可根据签名判断该消息是否来自抖音开放平台
    Content-Type
    固定值application/json
    消息可能重复推送,请使用Msg_Id进行去重处理!

    请求体字段

    字段
    类型
    说明
    event
    string
    消息类型,用于区分各类消息
    client_key
    string
    对应服务商平台或开发者平台中的APPID,应用ID
    content
    string
    消息内容,根据需要解析消息内容,不同类型的消息内容不同
    log_id
    string
    抖音内部日志id,可提供给抖音方便排查问题
      event:life_trade_refund_complete
      content内容
    字段
    类型
    说明
    order_id
    string
    订单id
    poi_id
    string
    门店id
    after_sale_id
    string
    退款id
    cancel_reasons
    list<object>
    取消原因
    .code
    int
    取消原因code
    .msg
    string
    取消原因描述
    apply_source
    string
    申请来源,枚举如下:
    USER: 用户发起
    MERCHANT: 商户发起发起
    CUSTOMER_SERVICE_STAFF: 客服/运营
    JUDGMENT: 判责(x项目)
    SYSTEM: 系统
    REFUND_TIMEOUT_ARBITRATE: 履约审核超时自动发起仲裁
    PAY_TIMEOUT_CANCEL: 过期自动退
    MERCHANT_CONFIRM_FAIL_REFUND: 商家发货确认失败
    EXPIRE_REFUND: 过期退
    PAY_CALLBACK_BUT_CANCELED : 回调时超订单被取消导致的超付
    USER_FULFILMENT_REFUND: 用户履约后退款
    CUSTOMER_SERVICE_STAFF_FULFILMENT_REFUND: 运营/客服履约后退款
    MERCHANT_CONFIRM_REJECT_REFUND: 商家拒单自动退款
    MERCHANT_CONFIRM_TIMEOUT_REFUND: 商家确认(接单)超时自动退款
    MERCHANT_CONFIRM_CANCEL_REFUND: 商家取消订单自动退款
    MERCHANT_CONFIRM_CANCEL_REFUND_FULFILMEN: 商家取消订单自动退款[40字符限制]
    MERCHANT_FULFILMENT_REFUND: 商家核销后退款
    DELIVER_CANCEL_REFUND: 运单取消导致退款
    DATA_FIX: 数据修复
    cancel_reasons code和msg的枚举见附录“cancel_reasons”

    请求示例

    { "event": "life_trade_refund_complete", "client_key": "axxxxxxxxxxxxx", "content": "{\"order_id\":\"123124124\",\"poi_id\":\"1231231\",\"after_sale_id\":\"123124124\",\"apply_source\": \"USER\",\"reasons\":[{\"code\":11,\"msg\":\"退款原因1\"}]}", "log_id": "202210101930530102281180650970B5AF" }