自动结算结果查询

开发环境

POST

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

支持使用外部支付单号查询关联的自动结算信息。
接口频次
50QPS(小程序app_id维度)

使用限制

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

错误码

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/v1/query_platform_order' \
--header 'Content-Type: application/json' \
--data-raw '{
  "app_id": "tt07e3715e98c9aac0",
  "out_order_no": "out_order_no_123123",
  "query_type": 1,
  "sign": "d17931f44e2de4aeb12a797fb8a4450d"
}'

响应示例

200 - 示例 1

{
  "platform_order": {
    "app_id": "string",
    "out_order_no": "string",
    "query_type": "string",
    "settle_info_list": [
      {
        "out_settle_no": "string",
        "settle_no": "string",
        "settle_status": "string",
        "created_at": 0,
        "settled_at": 0,
        "settle_way": "string",
        "cps": 0,
        "service_charge": 0,
        "settle_param_list": [
          {
            "amount": 0,
            "merchant_uid": "string"
          }
        ]
      }
    ]
  },
  "err_no": 0,
  "err_tips": "string"
}

请求参数

Header 参数

Content-Type

string

必需

Body 参数application/json

app_id

string

小程序APPID

必需

out_order_no

string

开发者侧支付订单号

必需

query_type

integer

必需

查询类型枚举： 1：自动分账

sign

string

必需

签名，详见签名DEMO

示例

返回响应

🟢200成功

application/json

Body

platform_order

object

订单详情

必需

app_id

string

小程序APPID

必需

out_order_no

string

开发者侧支付订单号

必需

query_type

string

对应的查询类型

必需

settle_info_list

array [object {9}]

可选

自动结算明细List

err_no

integer

必需

err_tips

string

必需

🟠400请求有误

修改于 2023-12-04 09:30:18

自动结算结果回调

发起结算及分账

自动结算结果查询

使用限制#

错误码#

请求参数

返回响应

使用限制

错误码