Interroger le statut de la commande de paiement

Interroge les détails de la commande de paiement par numéro de commande de plateforme, en renvoyant le status actuel et les clés timestamp.

GET/openapi/payin/orders/{orderNo}

En-têtes

Champ	Type	Obligatoire	Description
x-api-key	string	Oui	Marchand API Key. Utilisez la valeur commençant par mch_ de la page des paramètres API du marchand.
x-merchant-uid	string	Oui	Merchant UID.
x-timestamp	string	Oui	Milliseconde à 13 chiffres timestamp. La dérive d'horloge autorisée par défaut est de 5 minutes.
x-nonce	string	Oui	Chaîne aléatoire unique pour chaque requête, jusqu'à 128 caractères. La réutilisation est rejetée.
x-signature	string	Oui	Signature hexadécimale générée avec HMAC-SHA256. La charge utile contient Merchant UID, timestamp, nonce, la méthode, le chemin, le query canonique et le body canonique.

Paramètres

Champ	Type	Obligatoire	Description
orderNo	string	Oui	Paramètre de chemin. Le numéro de commande de la plateforme renvoyé lors de la création de l'ordre de paiement.

Exemple de requête

GET /openapi/payin/orders/PI1776193200123ABCD1234

Champs de réponse

Champ	Type	Obligatoire	Description
orderNo	string	Oui	Numéro de commande de la plateforme.
merchantOrderNo	string \| null	Oui	Numéro de commande du commerçant.
bindKey	string \| null	Oui	Clé de liaison pour la recharge des membres. Généralement vide pour les ordres de paiement partagés.
amount	string \| null	Oui	Montant de la commande.
paidAmount	string \| null	Oui	Montant payé.
address	string \| null	Oui	Adresse de réception.
cashierUrl	string \| null	Oui	Commander URL.
paymentUri	string \| null	Oui	Paiement par portefeuille URI.
expireAt	string \| null	Oui	Délai d'expiration de la commande.
createdAt	string \| null	Oui	Temps créé.
detectedAt	string \| null	Oui	Heure de détection du paiement.
confirmedAt	string \| null	Oui	Heure de confirmation.
completedAt	string \| null	Oui	Temps de réalisation.
status	string	Oui	Commandez status.

Exemple de réponse

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

Exemples de code

cURL Exemple de demande

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

Pour le succès commercial final, utilisez status=completed.