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

    抖音侧请求第三方申请退款,允许同步返回审核结果,务必保证幂等,即重复请求需要保证接口返回一致。
    提货券订单允许部分退,refund_info_list字段中会拆分成申请退款的每一份item单的信息。
    发码超时自动退的情况下,允许商家进行补码操作,提货券订单一单只需返回一个三方码。

    基本信息

    Scope
    life.capacity.comprehensive_retail_refund_apply
    权限要求
    提货券三方码交易
    回调场景

    请求头

      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(用于业务幂等)
    refund_amount
    int
    退款金额
    refund_info_list
    list<object>
    退款详情
    .order_item_id
    string
    item单id
    .item_refund_amount
    int
    item单退款金额
    .certificate
    object
    凭证信息
    ..certificate_id
    string
    一张券码的标识
    ..code
    string
    三方码(若发码失败为空)
    refund_reason
    string
    退款理由
    handle_time
    int
    处理时间 ms

    请求示例

    { "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, "certificate": { "certificate_id": "13221", "code": "sdabdkadkj" } }], "refund_reason": "1111", "handle_time": 1678859379000 }

    响应参数

    名称
    类型
    是否必填
    描述
    示例值
    data
    object
    .error_code
    int
    错误码,合法范围为 [0,999999]
    0
    .description
    string
    错误信息
    .order_id
    string
    抖音订单id
    .order_out_id
    string
    外部订单id
    .biz_uniq_key
    string
    业务唯一键
    .result
    int
    退款审核结果:1:允许,2:拒绝,3:待回调
    .reason
    string
    拒绝原因,若结果为拒绝时必填
    .codes
    list<string>
    补码

    响应示例

    { "data": { "error_code": 0, "description": "success", "result": 1 } }

    错误码

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