Query Pay-in Order Status

Queries pay-in order details by platform order number, returning the current status and key timestamps.

GET/openapi/payin/orders/{orderNo}

Request Headers

Field	Type	Required	Description
x-api-key	string	Yes	Merchant API Key. Use the value beginning with mch_ from the merchant API settings page.
x-merchant-uid	string	Yes	Merchant UID.
x-timestamp	string	Yes	13-digit millisecond timestamp. The default allowed clock drift is 5 minutes.
x-nonce	string	Yes	Unique random string for each request, up to 128 characters. Reuse is rejected.
x-signature	string	Yes	Hex signature generated with HMAC-SHA256. The payload contains Merchant UID, timestamp, nonce, method, path, canonical query, and canonical body.

Request Parameters

Field	Type	Required	Description
orderNo	string	Yes	Path parameter. The platform order number returned when creating the pay-in order.

Request Example

GET /openapi/payin/orders/PI1776193200123ABCD1234

Response Fields

Field	Type	Required	Description
orderNo	string	Yes	Platform order number.
merchantOrderNo	string \| null	Yes	Merchant order number.
bindKey	string \| null	Yes	Binding key for member recharge. Usually empty for shared pay-in orders.
amount	string \| null	Yes	Order amount.
paidAmount	string \| null	Yes	Paid amount.
address	string \| null	Yes	Receiving address.
cashierUrl	string \| null	Yes	Checkout URL.
paymentUri	string \| null	Yes	Wallet payment URI.
expireAt	string \| null	Yes	Order expiration time.
createdAt	string \| null	Yes	Created time.
detectedAt	string \| null	Yes	Payment detected time.
confirmedAt	string \| null	Yes	Confirmation time.
completedAt	string \| null	Yes	Completion time.
status	string	Yes	Order status.

Response Example

{
  "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"
}

Code Examples

cURL Request Example

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>'

Notes

For final business success, use status=completed.