抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 到综团购解决方案
  • 到综团购预约解决方案
  • 综合到店提货解决方案
  • 商品发布
  • 提货券三方码交易能力
  • 发券回调接口
  • 退款审核回调接口
  • 通知外部商家创单
  • 通知外部商家支付成功
  • 通知外部商家取消订单
  • 发券
  • 商家退款申请
  • 退款结果同步外部商家
  • 撤销核销
  • 券状态批量查询
  • 验券接口
  • 提货券抖音码交易能力
  • 商品查询
  • 线索管理解决方案
  • 历史版本文档(不推荐)
  • 接口说明

    抖音侧完成退款后,通知第三方实际退款结果。
    通知类型的接口 请勿返回业务类型的错误(譬如订单不存在)。

    基本信息

    Scope
    权限要求
    回调场景

    请求头

      Content-Type:application/json
      X-Bytedance-Logid: 请求 logid, 用于问题排查用
      x-life-clientkey: 服务商应用的 client_key

    请求参数

    名称
    类型
    是否必填
    描述
    示例值
    order_id
    string
    抖音订单 ID
    100001
    order_out_id
    string
    外部订单 ID
    1
    biz_uniq_key
    string
    抖音售后单ID(用于业务幂等)
    1111
    refund_amount
    int
    退款金额
    refund_info_list
    list
    退款详情
    - order_item_id
    string
    - item_refund_amount
    int
    退款金额
    notice_type
    int
    通知类型,退款成功=0
    refund_reason
    string
    退款原因:用户/客服/系统发起退款原因
    3
    handle_time
    int
    处理时间戳 ms
    desc
    string
    备注
    after_sale_type
    int
    售后类型 1 退货退款 3 仅退款
    1

    请求示例

    { "order_id":"111", "order_out_id": "1", "biz_uniq_key": "467812", "refund_amount":100, "refund_info_list":[{ "order_item_id": "13231", "item_refund_amount": 100, "certificates": { "certificate_id": "13221", "code": "sdabdkadkj" } }], "refund_reason": "1111", "handle_time": 1678859379000 }

    响应参数

    名称
    类型
    是否必填
    描述
    示例值
    data
    struct
    - error_code
    int
    错误码,合法范围为 [0,999999]
    0
    - description
    string
    错误信息

    响应示例

    { "data": { "error_code": 0, "description": "", } }

    错误码

    error_code
    description
    备注
    0
    success
    成功
    300
    ...
    抖音侧需要重试,其他错误码抖音不重试
    400~499
    其他自定义错误