代付查单

POST /v1/api/disbursement/query_order

• 1、2、10、11、30 均不是付款成功。当前查单没有 error_message / total_fee / settlement_amount 字段，不要依赖这些未返回字段。
• 203006 表示当前商户及查询条件下未找到订单，不是不可更正的付款失败状态。

请求参数

字段	类型	要求	说明
tenant_id	string	必填	商户编号，须与 app_key 属于同一商户；最多 20 字符。
app_key	string	必填	商户应用标识，最多 16 字符；使用该应用对应的 app_secret 签名。
timestamp	string / integer	必填	当前 Unix 秒级时间戳。超过 60 秒的旧时间戳会被拒绝；不要传毫秒。
sign	string	必填	按签名规则计算的 32 位小写 MD5。
tenant_order_no	string	二选一	最多 64 字符。与 platform_order_no 至少提供一个；同时提供时必须对应同一订单。
platform_order_no	string	二选一	平台订单号，最多 32 字符。

签名计算见签名规则。

请求示例 · cURL

curl --request POST 'https://api.trpay2024.com/v1/api/disbursement/query_order' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "timestamp": "1791199800",
  "tenant_order_no": "DEMO-PAYOUT-001",
  "sign": "12010107711de8278226146267eab004"
}'

响应示例

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "path": "/v1/api/disbursement/query_order",
  "success": true,
  "code": 200,
  "message": "成功",
  "data": {
    "tenant_id": "DEMO0001",
    "tenant_order_no": "DEMO-PAYOUT-001",
    "platform_order_no": "PRT202610051700DEMO0001",
    "amount": "500.00",
    "utr": "123456789012",
    "status": 20,
    "pay_time": "2026-10-05 17:02:00",
    "notify_url": "https://merchant.example/webhooks/payout",
    "notify_status": 2,
    "created_at": "2026-10-05 17:00:00"
  }
}

data 字段

字段	类型	要求	说明
tenant_id	string	必填	商户编号。
platform_order_no	string	必填	平台订单号。
tenant_order_no	string	必填	商户订单号。
amount	string	必填	订单金额；不代表付款成功。
status	integer	必填	订单状态，参见状态表。
pay_time	string / null	必填	付款确认时间；未成功时可能为空。
notify_url	string	必填	该订单配置的回调地址，可能为空。
notify_status	integer	必填	通知状态：0 未通知、1 通知中、2 通知成功、3 通知失败。与付款状态独立。
created_at	string	必填	订单创建时间，按响应原值使用。
utr	string	必填	支付参考号，尚未取得时为空。

异常处理

请参阅HTTP 处理、请求异常处理和错误码。