抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 评价
  • 交易工具
  • 交易系统
  • 通用交易系统
  • 行业交易系统
  • API 调用
  • 回调设置
  • 预下单
  • 营销算价
  • 核销
  • 分账
  • 发起分账
  • 查询分账
  • 通知分账结果
  • 可分账余额查询
  • 退货退款
  • 担保支付(仅限生活服务小程序接入)
  • 抖店绑定
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 开发者可通过此接口查询订单的分账记录。

    使用限制

    无。

    注意事项

    无。

    基本信息

    请求头

    名称
    类型
    是否必填
    描述
    Content-Type
    string
    是
    固定值 "application/json"
    Byte-Authorization
    string
    header
    签名参数,详见签名算法

    请求参数

    名称
    类型
    是否必填
    描述
    示例值
    out_order_no
    string
    否
    开发者侧订单 id,长度 <= 64 字节
    out_order_example_1
    out_settle_no
    string
    否
    开发者侧分账单 id,长度 <= 64字节
    out_settle_example_1
    order_id
    string
    否
    抖音开平侧订单 id,长度 <= 64字节
    ot7053735385750849836
    settle_id
    string
    否
    抖音开平侧分账单 id,长度 <= 64字节
    example_settle_no
      •以上 4 个参数选填一个,查询优先级:settle_id > order_id > out_settle_no > out_order_no。例如:请求填写了settle_id 和 order_id,服务只会按 settle_id 来查询,忽略 order_id 。如果未查询到结果,会返回空数组。
      •注意:对于担保交易订单,如果需要根据 order_id/out_order_no 查询订单的分账记录,建议使用 order_id(抖音开平侧支付单 id 查询),若使用 out_order_no 可能存在查询不到的情况。

    请求示例

    curl -X POST ' -H 'Content-Type:application/json' -H 'Byte-Authorization: SHA256-RSA2048 appid="ttxxx",nonce_str="DC10180A100073E70A48F195DA2AF2E6",timestamp="1623934869",key_version="1",signature="nwd1L3wCX+01/TVTkILeovF1DtYeghC1VHjrcjTHVkh7+gRaONEQkC2Y72Mw8JdSnIyeAtyp/pDHzyKGywjVqv5+JOBEhQG1/pvwNHN49wD26qg3AJL4hXw0fMJSRiTQEV1MszwDLuaabvo/qM9OXL9KyYiEPwVJqYtzmho4cHXT6mYgzNOW1xt5d7RDf4QO74JI3i4dtk9Uj8svJTrrBabML6AUcqcx2OP/7xukdaUgPdPf+IqmMG6GC4n52LUDogcL5n/osLdfHg9l6kW5gDcDjBfNDaggz07QMPHGdVao7pnQ2ub7VqcFIuY6Q3cBL7ndQdDGKrv+WBy5Q90QjQ=="' --data '{ "out_order_no":"", "out_settle_no":"", "order_id":"ot7053735385750849836", "settle_id":"" }'

    响应参数

    名称
    类型
    描述
    示例值
    err_no
    int64
    错误码
    0
    err_tips
    string
    错误提示
    success
    data
    Array
    分账结果
    见下文示例

    data 字段说明

    名称
    类型
    描述
    示例值
    out_order_no
    string
    开发者侧交易订单 id,长度 <= 64 字节,由数字、ASCII 字符组成
    out_order_example_1
    out_settle_no
    string
    开发者侧分账单 id,长度 <= 64字节,由数字、ASCII 字符组成
    out_settle_example_1
    order_id
    string
    抖音开平侧交易订单 id,长度 <= 64 字节,由数字、ASCII 字符组成
    ot7053735385750849836
    settle_id
    string
    抖音开平侧分账单id,长度 <= 64 字节,由数字、ASCII 字符组成
    ot7053723547314981164
    item_order_id
    string
    抖音开平侧item单 id,长度 <= 64 字节,由数字、ASCII 字符组成,按券分账时该字段不为空
    ot78318372940872837161
    settle_amount
    int64
    分账金额,单位分
    1000
    settle_status
    string
    分账状态:
      •INIT:初始化
      •PROCESSING:处理中
      •SUCCESS:处理成功
      •FAIL:处理失败
    SUCCESS
    settle_detail
    string
    分账详情
    商户号68882720803499563550-分成金额(分)840
    settle_time
    int64
    分账时间,13 位时间戳,单位毫秒
    1639733782000
    rake
    int64
    手续费,单位分
    60
    commission
    int64
    佣金,单位分
    100
    cp_extra
    string
    开发者自定义透传字段,长度 <= 2048 字节,不支持二进制数据
    test
    inner_settle_id
    string
    用于退分账场景,对应退分账接口文档中settle_no,长度<= 64字节
    7163169266042108164

    响应示例

    正常示例

      •按券分账时,item_order_id不为空
      •整单分账是,item_order_id为空
    { "err_no": 0, "err_tips": "", "data": [ { "out_order_no": "out_order_example_1", "out_settle_no": "out_settle_example_1", "order_id": "ot7053735385750849836", "settle_id": "ot7053723547314981164", "item_order_id": "ot78318372940872837161", "settle_amount": 1000, "settle_status": "SUCCESS", "settle_detail": "商户号68882720803499563550-分成金额(分)840", "settle_time": 1639733782000, "rake": 60, "commission": 100, "cp_extra": "test", "inner_settle_id": "7163169266042108164" } ] }

    异常示例

    { "err_no": 23002, "err_tips": "订单id,分账单id至少指定一个" }

    错误码

    详情参见错误码/返回码 。
    错误码
    错误提示
    建议解决方案
    23000
    抱歉,出错了!请稍后重试
    原单号发起重试
    23001
    bad app_id
    检查请求参数
    23002
    订单id,分账单id至少指定一个
    检查请求参数
    23101
    订单不存在
    检查请求参数
    ​
    ​