开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

结算及分账结果查询

接口功能描述:开发者/服务商可以通过接口主动查询分账订单状态。

接口说明

请求URL

https://developer.toutiao.com/api/apps/ecpay/v1/query_settle

请求方式

POST

接口频次

30QPS(小程序app_id维度)

请求头

名称

类型

必填

描述

Content-Type

string

固定值 "application/json"

参数

类型

是否必填

最大长度

描述

示例值

app_id

string

64

小程序APPID

tt07e3715e98c9aac0

out_settle_no

string

64

开发者侧分账订单号, 同一小程序下不可重复

out_settle_no_123123

sign

string

344

签名,详见地址

d17931f44e2de4aeb12a797fb8a4450d

thirdparty_id

string

条件选填

64

第三方平台服务商 id,非服务商模式留空

tt07e3715e98c9aac0

{
  "sign": "d17931f44e2de4aeb12a797fb8a4450d",
  "app_id": "tt07e3715e98c9aac0",
  "out_settle_no": "out_settle_no_123123",
  "thirdparty_id": "tt07e3715e98c9aac0"
}

参数

类型

是否必填

最大长度

描述

示例值

error_no

number

-

详见错误码

详见错误码

error_tips

string

-

详见错误描述

详见错误描述

参数

类型

是否必填

最大长度

描述

示例值

settle_info

object

-

结构体见下


SettleInfo 参数

参数

类型

是否必填

最大长度

描述

示例值

settle_no

string

128

平台侧分账单号

7067424934460492047

settle_amount

number

[1,99999999999]

分账金额,单位为分

101

settle_status

string

-

分账状态枚举值:

SUCCESS:成功

FAIL:失败

PROCESSING:处理中

SUCCESS

settle_detail

string

1024

具体分账详情

商户号6891537072713100000-分成金额(分)100

settled_at

number

10

分账成功时间戳,否则为0

1645513202

rake

number

[1,99999999999]

平台收取的手续费,单位为分

0

commission

string

[1,99999999999]

平台分佣金额,单位为分

1

cp_extra

string

2048

开发者自定义字段,回调原样回传

52fff5f7a4bf4a921c2daf83c

msg

string

256

可能存在的失败原因

分账金额超限

{
  "err_no": 0,
  "err_tips": "受理成功",
  "settle_info": {
    "settle_no": "7067424934460492047",
    "settle_amount": 101,
    "settle_status": "SUCCESS",
    "settle_detail": "商户号6891537072713100000-分成金额(分)100",
    "settled_at": 1645513202,
    "rake": 0,
    "commission": 1,
    "cp_extra": "52fff5f7a4bf4a921c2daf83c",
    "msg": "分账金额超限"
  }
}
{
  "err_no": 2000,
  "err_tips": "单号记录不存在",
  "payment_info": null
}

err_no

err_tips

说明及建议解决方案

0

业务成功

具体分账状态等信息以结构体中为准

1000

内部异常

业务异常,请稍后使用原请求重试

1002

数据异常,请检查必传参数与单号是否正确

业务异常,请稍后使用原请求重试

2000

单号记录不存在

请检查参数后重试

2010

业务参数处理异常

请检查参数后重试

2020

非法app_id

请检查参数中的app_id是否有效

2033

结算号为空

请检查参数,调整外部分账单号后重试

2000

单号记录不存在

请检查参数,传入的外部分账单号无对应分账订单

2039

订单分账被拦截

当前订单分账拦截,咨询小程序平台处理

2042

小程序appid无效,请检查app_id字段

检查app_id字段信息是否有误

2047

服务商id无效,请检查thirdparty_id字段

检查thirdparty_id字段信息是否有误

3000

业务异常,请检查订单状态

重试,或咨询小程序平台处理

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助