查询 UTR

POST /v1/api/collection/query_utr

• 成功响应不是通用结构。body.errorCode="0" 表示有匹配记录；"1001" 表示未找到。匹配 UTR 不等于证明订单已经支付成功。
• 当前只返回首个匹配订单，不返回完整订单列表。

请求参数

字段	类型	要求	说明
tenant_id	string	必填	商户编号，须与 app_key 属于同一商户；最多 20 字符。
app_key	string	必填	商户应用标识，最多 16 字符；使用该应用对应的 app_secret 签名。
timestamp	string / integer	必填	当前 Unix 秒级时间戳。超过 60 秒的旧时间戳会被拒绝；不要传毫秒。
sign	string	必填	按签名规则计算的 32 位小写 MD5。
utr	string	必填	支付参考号，最多 64 字符。仅查询本商户相关订单。

签名计算见签名规则。

请求示例 · cURL

curl --request POST 'https://api.trpay2024.com/v1/api/collection/query_utr' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "timestamp": "1791199800",
  "utr": "123456789012",
  "sign": "6be8d4b6a9378d79c58ec7906069b029"
}'

响应示例

{
  "status": "200",
  "timestamp": "2026-10-05 17:00:00",
  "message": "成功",
  "body": {
    "mcOrderNum": "DEMO-PAYIN-001",
    "platformOrderNum": "CRT202610051700DEMO0001",
    "amount": 500,
    "errorCode": "0",
    "errorMsg": ""
  }
}

响应字段

字段	类型	要求	说明
status	string	必填	外层 "200" 表示查询请求成功。
timestamp	string	必填	查询时间。
message	string	必填	说明文字。
body.mcOrderNum	string	必填	匹配商户订单号。
body.platformOrderNum	string	必填	匹配平台订单号。
body.amount	number	必填	订单金额，不是净结算金额。
body.errorCode	string	必填	"0" 有匹配；"1001" 未找到。
body.errorMsg	string	必填	匹配结果说明。

异常处理

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