Callback de paiement sortant

Les rappels de paiement utilisent les mêmes en-têtes de signature et le même mécanisme de nouvelle tentative que les rappels de paiement.

The platform calls back only when a payout reaches the confirmed or failed final state.

POSTnotifyUrl de la demande de création d'ordre de paiement body

En-têtes

Champ	Type	Obligatoire	Description
content-type	application/json	Oui	Toujours application/json.
x-callback-timestamp	string	Oui	Rappel timestamp en millisecondes.
x-callback-nonce	string	Oui	Rappel nonce.
x-callback-signature	string	Oui	HMAC-SHA256(apiKey, timestamp + "." + nonce + "." + rawBody)。
x-callback-signature-algorithm	string	Oui	Toujours HMAC-SHA256.
x-callback-signature-version	string	Oui	Toujours v1.

Paramètres

Champ	Type	Obligatoire	Description
merchantUid	string	Oui	Merchant UID.
orderNo	string	Oui	Numéro d’ordre de paiement de la plateforme.
merchantOrderNo	string \| null	Oui	Numéro de commande du commerçant.
chainCode	string	Oui	Code de chaîne.
tokenSymbol	string	Oui	Symbole de jeton.
fromAddress	string \| null	Oui	Adresse de l'expéditeur.
toAddress	string	Oui	Adresse de réception.
txHash	string \| null	Non	Hachage en chaîne.
amount	string	Oui	Montant du paiement.
status	string	Oui	Final payout state: confirmed or failed.
failedStage	string	Non	Returned only when status=failed.

Exemple de requête

{
  "merchantUid": "880001",
  "orderNo": "PO1776193200A1B2C3D4",
  "merchantOrderNo": "PO202604150001",
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
  "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
  "txHash": "b3d4fb0cb11eb86bb906d1e0ee3b84e17f40d5441d1e4c651ea46920a48a9a01",
  "amount": "35.500000",
  "status": "confirmed"
}

Champs de réponse

Champ	Type	Obligatoire	Description
HTTP Status	200-299	Oui	Toute réponse 2xx est considérée comme un succès.
Response Body	string \| json	Non	La réponse body peut être personnalisée.

Exemple de réponse

HTTP/1.1 200 OK
Content-Type: text/plain

success

Exemples de code

Exemple de gestionnaire express

app.post('/merchant/callback', (req, res) => {
  if (req.body.status === 'confirmed') {
    // Paiement réussi
  }

  if (req.body.status === 'failed') {
    // Paiement failed
  }

  return res.status(200).send('success');
});

Notes

Handle callbacks idempotently by orderNo; only confirmed or failed final states are sent automatically.