基础能力

触达与营销

支付

评价

交易工具

交易系统

担保支付（即将下线）

进件

支付

退款

结算及分账

自动结算

退分账

提现

获取对账单

接口获取页面链接

订单推送

抖店绑定

运营

生活服务

垂直行业

其它

自动结算结果查询

我的收藏

支持使用外部支付单号查询关联的自动结算信息。

使用限制

仅适用于未接交易模板 2.0 的订单。

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/ecpay/v1/query_platform_order
HTTP Method	POST
接口频次	50QPS(小程序app_id维度)

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "application/json"

请求参数

名称	类型	是否必填	最大长度	描述	示例值
app_id	string	是	64	小程序APPID	tt07e3715e98c9aac0
out_order_no	string	否	64	开发者侧支付订单号	out_order_no_123123
query_type	number	是	-	查询类型枚举： 1：自动分账	1
sign	string	是	344	签名，详见签名DEMO	d17931f44e2de4aeb12a797fb8a4450d

请求示例

{
  "app_id": "tt07e3715e98c9aac0",
  "out_order_no": "out_order_no_123123",
  "query_type": 1,
  "sign": "d17931f44e2de4aeb12a797fb8a4450d"
}

响应参数

公共响应参数

名称	类型	是否必填	最大长度	描述	示例值
error_no	number	是	-	详见错误码	详见错误码
error_tips	string	是	-	详见错误描述	详见错误描述

业务响应参数

名称	类型	是否必填	最大长度	描述	示例值
platform_order	object	否	-	订单详情

platform_order 参数

名称	类型	是否必填	最大长度	描述	示例值
app_id	string	是	64	小程序APPID	tt07e3715e98c9aac0
out_order_no	string	否	64	开发者侧支付订单号	7021447466642032945
query_type	string	是	10	对应的查询类型	Settle
settle_info_list	array	否	-	自动结算明细List

settle_info_list 参数

名称	类型	是否必填	最大长度	描述	示例值
created_at	string	是	18	结算单创建时间	2023-01-01 00:00:00
out_settle_no	string	是	64	自动结算单号	7021447466642032940
settle_no	string	是	64	小程序分账单号	7011447466542032941
settle_param_list	array	是	-	分账详情
settle_status	string	是	-	分账状态枚举值： SUCCESS：成功 FAIL：失败	SUCCESS
service_charge	number	是	[1,99999999999]	技术服务费	10
cps	number	是	[1,99999999999]	CPS佣金	20
settled_at	string	是	18	结算完成时间	2023-01-01 01:00:00
settle_way	string	是	-	结算渠道枚举值： 1：微信 2：支付宝 10：抖音支付	1

settle_param_list 参数

名称	类型	是否必填	最大长度	描述	示例值
merchant_uid	string	是	64	分账方商户号	6891537072713100000
amount	number	是	[1,99999999999]	分账金额	100

响应示例

正常示例

{
     "platform_order": {
         "app_id": "tt07e3715e98c9aac0",
         "out_order_no": "7021447466642032945",
         "query_type":  "Settle",
         "settle_info_list" : [
            {
                 "out_settle_no": "7021447466642032940",
                 "settle_no": "7011447466542032941",
                 "settle_status": "SUCCESS",
                 "created_at": 2023-01-01 00:00:00,
                 "settled_at": 2023-01-01 01:00:00,
                 "settle_way": "1",
                 "cps":  20,
                 "service_charge": 10,
                 "settle_param_list": [
                     {
                         "amount": 1,
                         "merchant_uid": "6891537072713100000"
                     }
                 ]
             }
        ]
    }
    "err_no": 0,
    "err_tips": ""
}

异常示例

{
  "err_no": 2000,
  "err_tips": "单号记录不存在",
  "platform_order": null
}

错误码

错误码err_no	描述err_tips	排查建议
0	success	成功
1000	系统异常，请原单号重试	服务内部异常，请稍后重试
1001	业务繁忙，请稍后重试	限流（单app_id维度限流50qps），请在业务低峰期后原参数重试