开发
API

支付结果查询

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

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

接口说明

请求URL

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

请求方式

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

签名

372368248d2c416bc009c242509999999

thirdparty_id

string

条件选填,服务商模式接入必传

64

第三方平台服务商 id,非服务商模式留空

tt84a4f2177777e29df

{
  "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

抖音侧的订单号

7101626671777776816

payment_info

object

-

支付信息

见下方「响应示例」

cps_info

string

-

若该订单为cps订单,该字段会返回该笔订单的达人分佣金额。
注意:由于订单归因与佣金计算存在延迟,支付成功后立即查询可能未计算完成,建议开发者在支付成功后数分钟或分账前再进行查询。

{\"share_amount\": 1}

参数

类型

是否必填

最大长度

描述

示例值

total_fee

number

取值范围:

[0,99999999999]

支付金额,单位为分

100,即1元

order_status

string

-

支付状态枚举值:

SUCCESS:成功 TIMEOUT:超时未支付 PROCESSING:处理中 FAIL:失败

SUCCESS

pay_time

string

64

支付时间, 格式为"yyyy-MM-dd hh:mm:ss"

2022-05-26 15:00:10

way

number

-

支付渠道, 1-微信支付,2-支付宝支付,10-抖音支付

1

channel_no

string

128

支付渠道侧的支付单号

2022052622001412479999452734

channel_gateway_no

string

128

支付渠道侧的商家订单号

12107010014028882037

seller_uid

string

64

该笔交易卖家商户号

69631798443938962290

item_id

string

-

订单来源视频对应视频 id

52fff5f7a4bf4a921c2daf83c

{
  "err_no": 0,
  "err_tips": "",
  "out_order_no": "out_order_no_1",
  "order_id": "6979643835974486313",
  "payment_info": {
    "total_fee": 68800,
    "order_status": "SUCCESS",
    "pay_time": "2021-07-01 01:43:15",
    "way": 2,
    "channel_no": "2021070122001432551415940569",
    "channel_gateway_no": "12107010014028882037",
    "seller_uid": "6943058549596520",
    "item_id": "6943058549596520",
    "cps_info": "{\"share_amount\": 1}"
  }
}
{
  "err_no": 2000,
  "err_tips": "支付记录不存在",
  "out_order_no": null,
  "order_id": null,
  "payment_info": null
}

公共错误码

错误码

描述

解决方案

0

查询到支付结果

-

1000

内部异常

当前请求可能成功也可能失败。 1、请使用相同的参数再次重试调用 2、若多次重试仍报错,请联系小程序平台处理

1001

业务繁忙,请稍后重试

系统限流,稍后原单号重试

2000

支付记录不存在

检查请求中的支付单号、商户支付单号是否正确,确认后重新发起

2008

验签异常

请检查参数,详见验签异常DEMO

2010

业务参数处理异常

检查请求参数,修改后重新发起请求

2042

小程序appid无效,请检查app_id字段

检查app_id字段信息是否有误

2047

服务商id无效,请检查thirdparty_id字段

检查thirdparty_id字段信息是否有误

2048

未查询到服务商与小程序的授权关系

检查服务商与小程序的授权关系

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助