🔍 单笔订单查询

POST

https://ypay.leikeb.cn/api/findorder

📝 请求参数

字段名

参数名

必填

类型

示例值

描述

订单号

order_no

必填

String

20160806151343349

需要查询的订单号

订单号类型

type

必填

Int

1:商户订单号, 2:系统订单号

📋 type参数说明

type = 1

商户订单号 (out_trade_no)

type = 2

系统订单号 (trade_no)

📋 响应参数

字段名

参数名

类型

示例值

描述

返回状态码

code

Int

200

200为成功，201为失败

返回信息

msg

String

获取成功!

成功/失败时返回对应信息

数据集合

data

Array

见下方表格

返回一个订单信息数组

📊 trade_status 订单状态说明

TRADE_WAIT

待支付

TRADE_SUCCESS

支付成功

TRADE_FAIL

支付失败

TRADE_REFUND

已退款

📋 data返回字段说明

字段名

参数名

类型

描述

订单ID

Int

订单ID

商户ID

pid

Int

商户ID

商户订单号

out_trade_no

String

商户系统内部的订单号

系统订单号

trade_no

String

平台订单号

支付方式

type

String

alipay/wxpay/qqpay

订单金额

money

String

订单金额

订单状态

trade_status

String

TRADE_WAIT/TRADE_SUCCESS/TRADE_FAIL/TRADE_REFUND

创建时间

addtime

String

订单创建时间

支付时间

paytime

String

订单支付时间

🌐 请求示例

POST
/api/findorder
Content-Type: application/x-www-form-urlencoded
order_no=20160806151343349&type=1

📡 响应示例

✅ 成功响应

{
  "code": 200,
  "msg": "获取成功!",
  "data": {
    "id": 1,
    "pid": 1000,
    "out_trade_no": "20160806151343349",
    "trade_no": "Y2026063012300012345",
    "type": "alipay",
    "money": "1.00",
    "trade_status": "TRADE_SUCCESS",
    "addtime": "2026-06-30 12:30:00",
    "paytime": "2026-06-30 12:35:00"
  }
}

❌ 失败响应

{
  "code": 201,
  "msg": "订单不存在!"
}

💡 使用建议

🔍

精确查询

根据type参数指定查询商户订单号或系统订单号

⏰

定时轮询

可设置定时任务查询订单状态，建议间隔30秒以上

🆔

订单号类型

type=1查询商户订单号，type=2查询系统订单号

📊

状态判断

只有trade_status=TRADE_SUCCESS才表示支付成功