订单查询
业务转账 / 业务付款 / 业务提现 3 个下单接口共用此查询接口,简化调用方的状态处理。
请求接口
openapi/v2/fund/biz/op/orderquery
公共参数
请求参数
order_no、out_trade_no 必须至少传一个;都传时 order_no 优先。
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| order_no | 否 | String(32) | 业务订单号(创建接口返回的 order_no) |
| out_trade_no | 否 | String(32) | 业务侧外部单号(下单时调用方传入的 out_trade_no) |
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| order_no | 是 | String(32) | 业务订单号 |
| out_trade_no | 是 | String(32) | 业务侧外部单号 |
| account_no | 是 | String(32) | 出金账户 |
| amount | 是 | Long | 原始订单金额,单位分 |
| service_fee | 是 | Long | 手续费金额,单位分 |
| order_status | 是 | Int | 订单状态码,见下方「订单状态码映射」 |
| remark | 否 | String(127) | 备注 |
| fail_msg | 否 | String(127) | 失败原因,仅 order_status 为失败档(202)时可能返回 |
| order_time | 是 | String(64) | 订单创建时间,格式 yyyy-MM-dd HH:mm:ss |
| succ_time | 否 | String(64) | 成功时间,资金处理成功(order_status=200)时通常非空,格式 yyyy-MM-dd HH:mm:ss |
订单状态码映射
| order_status | 描述 | 说明 |
|---|---|---|
| 101 | 审核中 | 在后台【设置中心】-【转账设置】开启了订单审核,则会进入审核流程 |
| 102 | 审核不通过 | 在后台【设置中心】-【转账设置】开启了订单审核,则会进入审核流程 |
| 201 | 资金处理中 | |
| 200 | 资金处理成功 | |
| 202 | 资金处理失败 | |
| 203 | 资金已关闭 | 【102-审核不通过】以及【202-资金处理失败】超过24小时或者【101-审批中】超过30天,则订单置为关闭 |
提示
- 终态:
order_status ∈ {102, 200, 202, 203},轮询拿到终态即可停止。 - 非终态:
order_status ∈ {101, 201},建议继续轮询查询。 - 出错时,公共返回值
msg会返回出错信息。
请求参数示例
{
"order_no": "tfYYYYMMDDxxxxxxxx"
}
响应参数示例(审核中)
{
"code": 0,
"msg": "成功",
"data": {
"order_no": "tfYYYYMMDDxxxxxxxx",
"out_trade_no": "TF202605131001",
"account_no": "30001234",
"product": "TF_S0",
"amount": 100000,
"service_fee": 100,
"order_status": 101,
"remark": "供货款 5 月",
"order_time": "2026-05-13 14:23:01"
}
}
响应参数示例(资金处理成功)
{
"code": 0,
"msg": "成功",
"data": {
"order_no": "tfYYYYMMDDxxxxxxxx",
"out_trade_no": "TF202605131001",
"account_no": "30001234",
"product": "TF_S0",
"amount": 100000,
"service_fee": 100,
"order_status": 200,
"remark": "供货款 5 月",
"order_time": "2026-05-13 14:23:01",
"succ_time": "2026-05-13 15:02:17"
}
}
响应参数示例(资金处理失败)
{
"code": 0,
"msg": "成功",
"data": {
"order_no": "tfYYYYMMDDxxxxxxxx",
"out_trade_no": "PO202605131001",
"account_no": "30001234",
"product": "PAYOUT_BANK",
"amount": 50000,
"service_fee": 50,
"order_status": 202,
"fail_msg": "对方账户不存在",
"order_time": "2026-05-13 09:00:01"
}
}