Créer un ordre de paiement sortant

Crée un ordre de paiement. En cas de succès, la plateforme gèle le montant du paiement et les frais de réseau, puis renvoie les détails de la commande.

Si fromAddress n’est pas fourni, le système sélectionne automatiquement une adresse avec un solde suffisant. Si aucun n’est disponible, le solde d’adresses est insuffisant.

POST/openapi/payout/orders

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
chainCode	string	Oui	Code de chaîne. Valeurs prises en charge : TRON / BSC / SOL.
tokenSymbol	string	Oui	Symbole de jeton.
fromAddress	string	Non	Adresse de l'expéditeur spécifiée. En cas d'omission, le système en attribue un automatiquement.
toAddress	string	Oui	Adresse de réception.
amount	string	Oui	Montant du paiement, jusqu'à 6 décimales.
deleteSourceAfterSuccess	boolean	Non	Booléen JSON facultatif, false par défaut. Si true, supprime logiquement la source uniquement après confirmation de ce paiement sur la blockchain ; aucun effacement en cas d’échec ou d’annulation. Les paiements n’exigent aucune réserve de solde.
merchantOrderNo	string	Oui	Numéro de commande côté marchand.
notifyUrl	string	Oui	Rappel spécifique à la commande URL. Un HTTPS URL public appartenant au commerçant est recommandé.

Exemple de requête

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
  "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
  "amount": "35.50",
  "deleteSourceAfterSuccess": false,
  "merchantOrderNo": "PO202604150001",
  "notifyUrl": "https://merchant.example.com/api/uugate/payout-notify"
}

Champs de réponse

Champ	Type	Obligatoire	Description
orderNo	string	Oui	Numéro d’ordre de paiement de la plateforme.
merchantOrderNo	string \| null	Oui	Numéro de commande du commerçant.
fromAddress	string \| null	Oui	Adresse réelle de l'expéditeur.
toAddress	string	Oui	Adresse de réception.
amount	string	Oui	Montant du paiement.
txHash	string \| null	Oui	Le hachage en chaîne est revenu après la diffusion.
status	string	Oui	soumis / diffusé / confirmed / failed.
submittedAt	string \| null	Oui	Heure soumise.
broadcastedAt	string \| null	Oui	Heure de diffusion.
confirmedAt	string \| null	Oui	Heure de confirmation.
failedAt	string \| null	Oui	Temps raté.
createdAt	string \| null	Oui	Temps créé.

Exemple de réponse

{
  "orderNo": "PO1776193200A1B2C3D4",
  "merchantOrderNo": "PO202604150001",
  "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
  "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
  "amount": "35.500000",
  "txHash": "b3d4fb0cb11eb86bb906d1e0ee3b84e17f40d5441d1e4c651ea46920a48a9a01",
  "status": "broadcasted",
  "submittedAt": "2026-04-15T03:00:00Z",
  "broadcastedAt": "2026-04-15T03:00:08Z",
  "confirmedAt": null,
  "failedAt": null,
  "createdAt": "2026-04-15T03:00:00Z"
}

Exemples de code

cURL Exemple de demande

curl -X POST 'https://api.uugate.com/openapi/payout/orders' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: mch_xxxxxxxxxxxxxxxxxxxx' \
  -H 'x-merchant-uid: 880001' \
  -H 'x-timestamp: 1776193200000' \
  -H 'x-nonce: 2f5c7b147c3748f0a8b3d9bb38aa91a4' \
  -H 'x-signature: <SIGNATURE_HEX>' \
  -d '{
    "chainCode": "TRON",
    "tokenSymbol": "USDT",
    "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
    "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
    "amount": "35.50",
    "deleteSourceAfterSuccess": false,
    "merchantOrderNo": "PO202604150001",
    "notifyUrl": "https://merchant.example.com/api/uugate/payout-notify"
  }'

Notes

L API publique prend uniquement en charge les paiements unitaires. Les paiements par lot sont disponibles uniquement dans le tableau de bord marchand.
Un paiement de 10 nécessite au moins 10 de solde disponible à la source, sans réserve supplémentaire, quelle que soit la valeur de deleteSourceAfterSuccess. Le montant n’est pas réduit ; le compte de frais doit couvrir les frais réseau.
Transmettez true / false, pas des chaines. Les nouvelles tentatives avec le meme merchantOrderNo doivent conserver ce parametre. La suppression est impossible si d autres transferts sont inacheves.
La creation ou la diffusion reussie ne vaut pas confirmation sur la blockchain. La suppression logique conserve historique, comptabilite et references de cles. L echec ou l annulation conserve la source.
The create API automatically attempts submission. Use status from the response or a later query; an HTTP 2xx alone is not on-chain success.