查询分账

开发者可通过此接口查询订单的分账记录。

请求参数

以上 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 可能存在查询不到的情况。

响应示例

正常示例

按券分账时，item_order_id不为空
整单分账是，item_order_id为空

curl --location --request POST 'https://developer.toutiao.com/api/apps/trade/v2/query_settle' \ --header 'Byte-Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "out_order_no":"", "out_settle_no":"", "order_id":"ot7053735385750849836", "settle_id":"" }'

{ "err_no": 0, "err_tips": "string", "data": [ { "out_order_no": "string", "out_settle_no": "string", "order_id": "string", "settle_id": "string", "item_order_id": "string", "settle_amount": 0, "settle_status": "string", "settle_detail": "string", "settle_time": 0, "rake": 0, "commission": 0, "cp_extra": "string", "inner_settle_id": "string" } ] }

请求参数

Header 参数

Content-Type

string

必需

Byte-Authorization

string

必需

签名参数，详见签名算法

Body 参数application/json

out_order_no

string

可选

开发者侧订单 id，长度 <= 64 字节

out_settle_no

string

可选

开发者侧分账单 id，长度 <= 64字节

order_id

string

可选

抖音开平侧订单 id，长度 <= 64字节

settle_id

string

可选

抖音开平侧分账单 id，长度 <= 64字节

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

err_tips

string

必需

data

array [object {13}]

分账结果

必需

out_order_no

string

可选

开发者侧交易订单 id，长度 <= 64 字节，由数字、ASCII 字符组成

out_settle_no

string

可选

开发者侧分账单 id，长度 <= 64字节，由数字、ASCII 字符组成

order_id

string

可选

抖音开平侧交易订单 id，长度 <= 64 字节，由数字、ASCII 字符组成

settle_id

string

可选

抖音开平侧分账单id，长度 <= 64 字节，由数字、ASCII 字符组成

item_order_id

string

可选

抖音开平侧item单 id，长度 <= 64 字节，由数字、ASCII 字符组成，按券分账时该字段不为空

settle_amount

integer

分账金额，单位分

可选

settle_status

string

可选

分账状态： INIT：初始化 PROCESSING：处理中 SUCCESS：处理成功 FAIL：处理失败

settle_detail

string

分账详情

可选

settle_time

integer

可选

分账时间，13 位时间戳，单位毫秒

rake

integer

手续费，单位分

可选

commission

integer

佣金，单位分

可选

cp_extra

string

可选

开发者自定义透传字段，长度 <= 2048 字节，不支持二进制数据

inner_settle_id

string

可选

用于退分账场景，对应退分账接口文档中settle_no，长度<= 64字节

🟠400请求有误

请求参数#

响应示例#

请求参数

返回响应

请求参数

响应示例