支付结果查询
收藏
我的收藏

开发者/服务商可以通过支付结果查询接口主动查询订单状态，完成下一步的业务逻辑。

使用限制

无

接口说明

响应参数里的 cps_info 字段，由于订单归因与佣金计算存在延迟，支付成功后立即查询可能未计算完成，建议开发者在支付成功后分账前进行查询。

沙盒环境使用说明详见担保支付-沙盒环境。

基本信息

基本信息
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

请求头

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

请求参数

名称	类型	是否必填	最大长度	描述	示例值
app_id	string	是	64	小程序APPID	tt07e3715e98c9aac0
out_order_no	string	是	64	开发者侧的订单号, 同一小程序下不可重复	152977777701846528
sign	string	是	344	签名，详见签名DEMO	372368248d2c416bc009c242509999999
thirdparty_id	string	条件选填，服务商模式接入必传	64	第三方平台服务商 id，非服务商模式留空	tt84a4f2177777e29df

请求示例

json复制
{
  "app_id": "tt07e3715e98c9aac0",
  "out_order_no": "out_order_no_1",
  "sign": "569168789858734fecef2d5ae604ff1a" 
}

响应参数

公共响应参数

名称	类型	是否必填	最大长度	描述	示例值
err_no	number	是	-	返回码，详见错误码	0
err_tips	string	是	-	返回码描述，详见错误码描述	success
out_order_no	string	否	64	开发者侧的订单号	1529777777018465280
order_id	string	否	64	抖音侧的订单号	N7101626671777776816
payment_info	object	否	-	支付信息，详见下文 payment_info参数说明	见下方「响应示例」
cps_info	string	否	-	若该订单为CPS订单，该字段会返回该笔订单的CPS相关信息，详见下文 cps_info参数说明	见下方「响应示例」

payment_info 参数说明

名称	类型	是否必填	最大长度	描述	示例值
total_fee	number	是	取值范围： [0,99999999999]	支付金额，单位为分	100，即1元
order_status	string	是	-	支付状态枚举值： SUCCESS：成功 TIMEOUT：超时未支付 PROCESSING：处理中 FAIL：失败	SUCCESS
pay_time	string	是	64	支付完成时间，order_status不为SUCCESS时会返回默认值空字符串，order_status为SUCCESS时返回非空字符串，格式为"yyyy-MM-dd HH:mm:ss"	2022-05-26 15:00:10
way	number	是	-	支付渠道，order_status不为SUCCESS时会返回默认值0，order_status为SUCCESS时会返回以下枚举： 1-微信支付， 2-支付宝支付， 10-抖音支付	1
channel_no	string	是	128	支付渠道侧的支付单号	2022052622001412479999452734
seller_uid	string	是	64	该笔交易卖家商户号	69631798443938962290
item_id	string	是	-	订单来源视频对应视频 id	52fff5f7a4bf4a921c2daf83c
cp_extra	string	否	2048	开发者自定义字段	一些附加信息

cps_info 参数说明

名称	类型	是否必填	最大长度	描述	示例值
share_amount	string	是	-	达人分佣金额，单位为分。后续商户在进行分账时需要注意可分账金额应扣除达人分佣金额。注意：由于订单归因与佣金计算存在延迟，支付成功后立即查询可能未计算完成，建议开发者在支付成功后分账前再进行查询。	100，即1元
douyin_id	string	是	-	达人抖音号	1234567
nickname	string	是	-	达人昵称	达人昵称

响应示例

正常响应示例

json复制
{
  "err_no": 0,
  "err_tips": "",
  "out_order_no": "out_order_no_1",
  "order_id": "N7101626671777776816",
  "payment_info": {
    "total_fee": 68800,
    "order_status": "SUCCESS",
    "pay_time": "2021-07-01 01:43:15",
    "way": 2,
    "channel_no": "2021070122001432551415940569",
    "seller_uid": "6943058549596520",
    "item_id": "6943058549596520"
  },
  "cps_info": "{\"share_amount\":\"100\",\"douyin_id\":\"1234567\",\"nickname\":\"达人昵称\"}"
}

异常响应示例

json复制
{
    "err_no": 2000,
    "err_tips": "单号记录不存在",
    "out_order_no": "",
    "order_id": "",
    "payment_info": {
        "total_fee": 0,
        "order_status": "",
        "pay_time": "",
        "way": 0,
        "channel_no": "",
        "channel_gateway_no": "",
        "seller_uid": "",
        "item_id": "",
        "cp_extra": "",
        "msg": "",
        "author_id": 0
    },
    "cps_info": ""
}

错误码

错误码 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	未查询到服务商与小程序的授权关系	检查服务商与小程序的授权关系