跳到主要内容

订单查询

业务转账 / 业务付款 / 业务提现 3 个下单接口共用此查询接口,简化调用方的状态处理。

请求接口

openapi/v2/fund/biz/op/orderquery

公共参数

接口协议 - 公共参数

请求参数

order_noout_trade_no 必须至少传一个;都传时 order_no 优先。

参数必填类型说明
order_noString(32)业务订单号(创建接口返回的 order_no
out_trade_noString(32)业务侧外部单号(下单时调用方传入的 out_trade_no

响应参数

名称必填类型说明
order_noString(32)业务订单号
out_trade_noString(32)业务侧外部单号
account_noString(32)出金账户
amountLong原始订单金额,单位分
service_feeLong手续费金额,单位分
order_statusInt订单状态码,见下方「订单状态码映射」
remarkString(127)备注
fail_msgString(127)失败原因,仅 order_status 为失败档(202)时可能返回
order_timeString(64)订单创建时间,格式 yyyy-MM-dd HH:mm:ss
succ_timeString(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"
}
}