抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 代运营
  • 团购退款
  • 抖音码核销后退款审批
  • 售后单详情查询
  • 抖音码退款申请通知
  • 退款单列表查询
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 抖音码退款申请通知
    收藏
    我的收藏

    接口说明

      1.在c端用户发起核销后退款申请时,开发者监听webhook退款审批通知,接收退款申请​
      2.消息可能重复推送,请使用 Msg_Id 进行去重处理!​
      3.信息推送使用说明参考:生活服务消息推送

    基本信息

    HTTP URL​
    地址由服务商提供​
    HTTP Method​
    POST​
    申请权限​
    餐饮交易退款​
    权限要求​
    生活服务商家应用,需要url配置,路径:配置方式
    小程序应用自行配置,路径:小程序配置商品审核回调地址

    签名规则

    用户可通过请求 header 中的 X-Douyin-Signature 字段判断该消息是否来自抖音开放平台。 抖音服务端会将应用的(client secret + 消息体)使用 sha1 哈希作为 X-Douyin-Signature header 的 value。您可以自行使用 client secret 和收到的消息体进行 sha1 哈希,与该请求头进行比对。​

    请求头字段

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

    请求体字段

    参数
    类型
    含义
    event​
    string​
    事件名,唯一标识, life_hermes_akte_after_sale_audit​
    from_user_id​
    string​
    未使用​
    to_user_id​
    string​
    未使用​
    client_key​
    string​
    开发者唯一标识​
    content​
    string​
    具体内容,类型:json string​
    account_id​
    string​
    商家id​
    order_id​
    string​
    订单id​
    certificate_id​
    string​
    券id​
    refund_amount​
    int64​
    退款金额​
    refund_time​
    int64​
    退款申请时间​
    apply_reason​
    object​
    申请售后原因​
    code​
    []int64​
    reason 对应的code​
    reason_items​
    []object​
    完整code与当时对应文案映射​
    code​
    int64​
    code​
    msg​
    string​
    文案​
    additional_msg​
    string​
    补充的msg信息​

    请求示例

    { "event": "life_hermes_akte_after_sale_audit", "client_key": "axxxxxxxxxxxxx", "content": "{ \"account_id\":\"123\", \"order_id\":\"12\", \"certificate_id\":\"567\", \"refund_amount\":20, \"refund_time\":1312414, \"apply_reason\":{ \"code\":[ 999 ], \"reason_items\":[ { \"code\":999, \"msg\":\"其他\" } ], \"additional_msg\":\"跟商家协商\" }}" }

    响应参数

    响应内容可以为空。​
    开发者收到消息推送后,http code 响应 200 且响应时间小于 3s,抖音侧即认为推送成功。​
    若开发者 http 响应 code 非 200 或响应时间超过 3s,抖音侧会间隔 500ms 发起重试,最大重试次数为 3 次。​
    抖音侧收到成功请求时也可能会继续重复推送,请务必使用请求头中 Msg-Id 进行消息去重处理。​