结算及分账结果查询
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/api/apps/ecpay/v1/query_settle
1.
基本信息
| 基本信息 | |
|---|---|
| HTTP URL | 正式环境： https://developer.toutiao.com/api/apps/ecpay/v1/query_settle沙盒环境： https://open-sandbox.douyin.com/api/apps/ecpay/v1/query_settle |
| HTTP Method | POST |
| 接口频次 | 50QPS(小程序app_id维度) |
错误码
| 错误码err_no | 描述err_tips | 排查建议 |
|---|---|---|
| 0 | 业务成功 | 具体分账状态等信息以结构体中为准 |
| 1000 | 内部异常 | 业务异常，请稍后使用原请求重试 |
| 1002 | 数据异常，请检查必传参数与单号是否正确 | 业务异常，请稍后使用原请求重试 |
| 2000 | 单号记录不存在 | 请检查参数后重试 |
| 2008 | 验签异常 | 请检查参数，详见签名DEMO |
| 2010 | 业务参数处理异常 | 请检查参数后重试 |
| 2020 | 非法app_id | 请检查参数中的app_id是否有效 |
| 2033 | 结算号为空 | 请检查参数，调整外部分账单号后重试 |
| 2000 | 单号记录不存在 | 请检查参数，传入的外部分账单号无对应分账订单 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/v1/query_settle' \
--header 'Content-Type: application/json' \
--data-raw '{
"sign": "d17931f44e2de4aeb12a797fb8a4450d",
"app_id": "tt07e3715e98c9aac0",
"out_settle_no": "out_settle_no_123123",
"thirdparty_id": "tt07e3715e98c9aac0"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_tips": "string",
"settle_info": {
"settle_no": "string",
"settle_amount": 0,
"settle_status": "string",
"settle_detail": "string",
"settled_at": 0,
"rake": 0,
"commission": 0,
"cp_extra": "string",
"msg": "string"
}
}请求参数
Header 参数
Content-Type
string
必需
Body 参数application/json
返回响应
修改于 2023-12-04 09:16:27