抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 度假行业解决方案
  • 预售券
  • KA核销对账
  • 日历品
  • 旅行社日历品操作
  • 旅行社日历品价量态操作
  • 旅行社日历品行业交易商家接单
  • 旅行社日历品行业交易可定检查
  • 旅行社日历品行业交易创建订单
  • 旅行社日历品行业交易支付结果通知
  • 旅行社日历品行业交易退款成功通知
  • 日历品行业交易订单退款结果通知(SPI)
  • 旅行社日历品-订单取消通知
  • 酒旅-旅行社支付结果通知
  • 旅行社poi查询
  • 旅行社直连相关枚举&常见错误码
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档(不推荐)
  • 抖音侧主要用作通知,返回结果不会影响最终退款结果,非超时情况下,不要返回业务错误和系统错误

    接口说明

    订单退款时,抖音侧通知三方系统退款结果。当订单退款时,如果订单中没有第三方订单号,则无需通知三方系统

    请求头

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

    请求体

    接口入参
    一级参数
    二级参数
    三级参数
    名称
    是否必填
    参数类型
    备注
    » order_id
    抖音侧订单号
    string
    » order_out_id
    第三方订单 ID
    string
    » pay_amount
    订单实付金额
    int
    订单实际付款总金额;针对补差价订单,实付金额取值补差子单的金额
    » refund_amount
    退款金额
    int
    实际退款金额,精确分
    » refund_time_unix
    退款时间
    int
    时间戳,精确到时分秒
    » refund_type
    退款类型
    int
    枚举值:1、订单退款,2、补差价退款

    请求示例

    { "order_id": "1003213027769622814", "order_out_id": "654321", "pay_amount": 2, "refund_amount": 2, "refund_time_unix":1688464299, "refund_type":1 }

    响应参数

    接口出参
    一级参数
    二级参数
    参数名称
    是否必填
    参数类型
    备注
    » data
    struct
    »» error_code
    错误编码
    int
    错误码详见 旅行社直连相关枚举 中的(一)
    »» description
    描述信息
    string
    描述信息

    响应示例

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