支付结果查询
开发环境
开发环境
POST
/api/apps/ecpay/v1/query_order
接口说明
1.
2.
基本信息
| 基本信息 | |
|---|---|
| HTTP URL | 正式环境： https://developer.toutiao.com/api/apps/ecpay/v1/query_order 沙盒环境：https://open-sandbox.douyin.com/api/apps/ecpay/v1/query_order |
| HTTP Method | POST |
| 请求频次 | app_id维度限流150QPS，thirdparty_id维度限流150QPS |
cps_info 参数说明
| 名称 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| share_amount | string | 是 | - | 达人分佣金额，单位为分。后续商户在进行分账时需要注意可分账金额应扣除达人分佣金额。 注意：由于订单归因与佣金计算存在延迟，支付成功后立即查询可能未计算完成，建议开发者在支付成功后分账前再进行查询。 | 100，即1元 |
| douyin_id | string | 是 | - | 达人抖音号 | 1234567 |
| nickname | string | 是 | - | 达人昵称 | 达人昵称 |
错误码
| 错误码 err_no | 描述 err_tips | 排查建议 |
|---|---|---|
| 0 | 查询到支付结果 | - |
| 1000 | 内部异常 | 当前请求可能成功也可能失败。 1、请使用相同的参数再次重试调用 2、若多次重试仍报错，请联系小程序平台处理 |
| 1001 | 业务繁忙，请稍后重试 | 系统限流，稍后原单号重试 |
| 2000 | 支付记录不存在 | 检查请求中的支付单号、商户支付单号是否正确，确认后重新发起 |
| 2008 | 验签异常 | 请检查参数，详见签名DEMO |
| 2010 | 业务参数处理异常 | 检查请求参数，修改后重新发起请求 |
| 2042 | 小程序appid无效，请检查app_id字段 | 检查app_id字段信息是否有误 |
| 2047 | 服务商id无效，请检查thirdparty_id字段 | 检查thirdparty_id字段信息是否有误 |
| 2048 | 未查询到服务商与小程序的授权关系 | 检查服务商与小程序的授权关系 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/apps/ecpay/v1/query_order' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id": "tt07e3715e98c9aac0",
"out_order_no": "out_order_no_1",
"sign": "569168789858734fecef2d5ae604ff1a"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_tips": "string",
"out_order_no": "string",
"order_id": "string",
"payment_info": {
"total_fee": 0,
"order_status": "string",
"pay_time": "string",
"way": 0,
"channel_no": "string",
"seller_uid": "string",
"item_id": "string"
},
"cps_info": "string"
}修改于 2025-11-12 07:47:11