收款订单状态查询

通过平台订单号查询收款订单详情，返回当前单一状态以及订单的关键时间点。

GET/openapi/payin/orders/{orderNo}

请求头

字段名称	字段类型	是否必填	说明
x-api-key	string	是	商户 API Key，使用商户后台 API 接入页面中的 mch_ 开头字符串。
x-merchant-uid	string	是	商户 UID。
x-timestamp	string	是	13 位毫秒时间戳，默认允许和服务器时间相差 5 分钟。
x-nonce	string	是	每次请求唯一的随机字符串，最长 128 位，重复使用会被拒绝。
x-signature	string	是	使用 HMAC-SHA256 生成的十六进制签名，签名原文由 Merchant UID、时间戳、nonce、请求方法、路径、规范化 query 和规范化 body 组成。

接口参数

字段名称	字段类型	是否必填	说明
orderNo	string	是	路径参数，创建收款订单时返回的平台订单号。

请求示例

GET /openapi/payin/orders/PI1776193200123ABCD1234

接口返回

字段名称	字段类型	是否必填	说明
orderNo	string	是	平台订单号。
merchantOrderNo	string \| null	是	商户订单号。
bindKey	string \| null	是	会员充值场景下的绑定键；共享收款订单通常为空。
amount	string \| null	是	订单金额。
paidAmount	string \| null	是	实收金额。
address	string \| null	是	收款地址。
cashierUrl	string \| null	是	收银台地址。
paymentUri	string \| null	是	钱包拉起 URI。
expireAt	string \| null	是	订单失效时间。
createdAt	string \| null	是	创建时间。
detectedAt	string \| null	是	检测到付款时间。
confirmedAt	string \| null	是	确认完成时间。
completedAt	string \| null	是	订单完成时间。
status	string	是	订单状态。

返回示例

{
  "orderNo": "PI1776193200123ABCD1234",
  "merchantOrderNo": "M202604150001",
  "bindKey": "USER_90001",
  "amount": "100.000000",
  "paidAmount": "100.000000",
  "address": "TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9",
  "cashierUrl": "https://open.uugate.com/SK/PI1776193200123ABCD1234",
  "paymentUri": "TRON:TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9?token=USDT&amount=100.000000",
  "expireAt": "2026-04-18T06:30:00.000Z",
  "createdAt": "2026-04-18T06:00:00.000Z",
  "detectedAt": "2026-04-18T06:08:15.000Z",
  "confirmedAt": "2026-04-18T06:09:02.000Z",
  "completedAt": "2026-04-18T06:09:02.000Z",
  "status": "completed"
}

代码示例

cURL 请求示例

curl 'https://api.uugate.com/openapi/payin/orders/PI1776193200123ABCD1234' \
  -H 'x-api-key: mch_xxxxxxxxxxxxxxxxxxxx' \
  -H 'x-merchant-uid: 880001' \
  -H 'x-timestamp: 1776193500000' \
  -H 'x-nonce: 0d51f901bb7340ffb0cf70f5f0f26018' \
  -H 'x-signature: <SIGNATURE_HEX>'

说明

商户业务系统判断是否最终成功时，建议直接以 status=completed 为准。