查询 UPI

POST /v1/api/collection/query_upi

• 成功响应不是通用 success/code/data 结构。body.status=1 表示在本商户可查询订单中存在，2 表示不存在；不是银行账户有效性验证。

请求参数

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

签名计算见签名规则。

请求示例 · cURL

curl --request POST 'https://api.trpay2024.com/v1/api/collection/query_upi' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "timestamp": "1791199800",
  "upi": "demo@upi",
  "sign": "57903d6d8a92ac0e763c9bf98ad0f2f8"
}'

响应示例

{
  "status": "200",
  "timestamp": "2026-10-05 17:00:00",
  "message": "成功",
  "body": {
    "status": 1
  }
}

响应字段

字段	类型	要求	说明
status	string	必填	外层 "200" 表示本次查询成功。
timestamp	string	必填	查询时间。
message	string	必填	说明文字，不用于判断付款结果。
body.status	integer	必填	1 存在；2 不存在。

异常处理

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