订单查询接口
此接口几乎在所有场景下都用不到,仅供测试使用。
严禁使用此接口做订单状态的循环查询,否则将自动导致IP进入黑名单!此接口几乎用不到,为减轻系统负担,每天限制查询100次,仅供测试使用,若需要更高查询量,请发工单并说明理由
正确的业务逻辑:本平台收到支付成功消息后,会通过你发起付款接口填入的notify_url参数网址进行回调,开发者服务器通过接收异步回调通知后更新自己的订单状态,并且开发者前端的订单查询页面应接入自己的服务器数据库查询接口。回调的参数请见左侧的回调通知接口
注意只能查询最近30天的订单
请求地址(不支持浏览器直接打开):https://open.h5zhifu.com/api/query
调用方法:POST
请求格式:application/json
请求参数:
字段名称 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
app_id | int(16) | Y | 应用ID,在后台系统设置页面查看 |
trade_no | string(32) | N | (三选一)本平台唯一订单编号 |
in_trade_no | string(32) | N | (三选一)微信和支付宝官方的订单编号 |
out_trade_no | string(32) | N | (三选一)商家订单编号 |
sign | string(32) | Y | 数据签名,请查看左侧签名算法 |
接口返回:
字段名称 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
code | int(16) | Y | 状态码,200:成功调用,1001:签名错误,1003:缺少参数 |
msg | string(32) | Y | code字段所对应的详细描述信息 |
data | string(32) | Y | 将下面的所有参数括起来 |
list | array(32) | Y | 这是一个数组,每个成员都包括下面的所有参数。若未查到相关数据,则为空数组。通过trade_no、in_trade_no查询的最多有一个成员,通过out_trade_no查询的可能有多个成员 |
trade_no | string(32) | Y | 本平台唯一订单编号 |
in_trade_no | string(32) | Y | 微信和支付宝官方的订单编号,可能为空字符串 |
out_trade_no | string(32) | Y | 商家订单编号 |
description | string(32) | Y | 销售商品描述 |
trade_type | string(255) | Y | 交易类型,枚举值: native/jsapi/miniapp/h5/app |
pay_type | string(32) | Y | 支付类型,枚举值:alipay/wechat |
amount | int(16) | Y | 订单价格(单位为分) |
attach | string(255) | Y | 用户自定义数据,原样返回 |
trade_status | string(32) | Y | 订单状态,枚举值。"wait":新订单等待支付。"paid":已支付,正在回调。"success":订单已支付并且回调成功。"closed":订单未支付已关闭。"refund":进入退款流程。"notify_error":订单已支付但回调失败,可以在历史回调日志页面查询具体错误。"fee_error":账户余额不足扣除手续费失败,订单未回调。为防范道德风险,"fee_error"状态下仍返回"wait" |
notify_count | int(16) | Y | 通知的次数 |
create_time | string(32) | Y | 订单创建的时间 |
pay_time | string(32) | Y | 用户支付的时间(若未支付则此字段值为空字符串"") |
expire_time | string(32) | Y | 订单过期具体时间,目前暂时指定为2小时 |
接口返回示例:
{
"code":200,
"msg":"success",
"data":{
"list":[{
"trade_no": "cad5076f55834f5fadddcfc018cc4068",
"in_trade_no": "20190501567568768",
"out_trade_no": "20190501567567653",
"description": "商品描述",
"trade_type": "native",
"pay_type": "wechat",
"amount": 3500,
"attach": "",
"trade_status": "success",
"notify_count":1,
"create_time": "2019-03-23 04:13:12",
"pay_time": "2019-03-23 04:13:12",
"expire_time": "2019-03-23 04:13:12",
}]
},
}
常见问题解决办法:
1、出现防火墙拦截提示:请将http请求头中的user-agent设置为常见浏览器请求头,或者检查请求内容是否含有非法内容