自动结算结果查询

更新时间 2024-07-24 02:58:49

我的收藏

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

使用限制

仅适用于未接交易模板 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

请求示例

json复制
{
  "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

响应示例

正常示例

json复制
{
     "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": ""
}

异常示例

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

错误码

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