单笔订单查询
按商户订单号或系统订单号查询单笔支付订单状态与详情。
POST
https://pay.xzcloud.vip/api/findorder
请求示例
order_no={商户订单号}&type=1
请求参数
订单号
必填
order_no
需要查询的订单号，含义由 type 决定
订单号类型
必填
type
1:商户订单号（out_trade_no），2:系统订单号（trade_no）
类型说明
下单时商户传入的是
out_trade_no。日常查单请用：order_no=商户订单号&type=1。也可用系统返回的 trade_no 配合 type=2。
响应参数
返回状态码
code
200 为成功，其它值为失败
返回信息
msg
成功 / 失败时返回对应信息
数据集合
data
成功时返回订单信息对象，失败时无此字段
data 字段说明
商户ID
id
商户用户 ID（对应订单 user_id）
支付方式
type
支付方式：alipay / qqpay / wxpay 等
系统订单号
trade_no
系统生成的支付订单号
商户订单号
out_trade_no
商户下单时提交的订单号
商品名称
name
商品名称
商品金额
money
订单金额
付款状态
status
0:未支付，1:已支付
异步回调地址
notify_url
商户异步通知地址
同步回调地址
return_url
商户页面跳转通知地址
成功响应示例
{
"code": 200,
"msg": "获取成功!",
"data": {
"id": 2,
"type": "wxpay",
"trade_no": "Y2026071610552575148",
"out_trade_no": "Y2026071610552536647",
"name": "商品名称",
"money": "1.00",
"status": 0,
"notify_url": "http://example.com/notify_url.php",
"return_url": "http://example.com/return_url.php"
}
}
说明
常见错误
订单号为空返回「请输入订单号!」；类型为空返回「请输入订单号类型!」；查无订单返回「此订单号不是有效订单号」。以上失败时
code 均为 201。
