Webhook – USDT Reçu Événement : usdt.received

Déclenché dès qu'un paiement USDT TRC-20 est reçu sur une adresse générée via votre compte API.

Lorsqu'un paiement est détecté, PentrraWallet vérifie la transaction, met à jour votre solde (après déduction des frais), puis envoie une requête HTTP POST vers l'URL webhook_url que vous avez fournie lors de la génération de l'adresse.

Exemple de notification reçue sur votre webhook_url

{
  "event": "usdt.received",
  "reference": "RECV83K2PX7QAM",
  "address": "TQfV3K7KAd1bsrsdtqR7Pg8uLmMnKJHFsM",
  "label": "client_john_doe",
  "amount_gross": 50.00,
  "amount_net": 48.55,
  "network": "TRC-20",
  "status": "completed",
  "description": "received USDT payment"
}

Description des champs

Champ	Type	Description
`event`	string	Toujours `usdt.received`
`reference`	string	Référence interne de la transaction — utilisable avec `/verify-trx`
`address`	string	Adresse USDT TRC-20 qui a reçu le paiement
`label`	string	Identifiant client que vous avez défini lors de la génération de l'adresse
`amount_gross`	float	Montant brut reçu en USDT (avant déduction des frais)
`amount_net`	float	Montant net crédité sur votre solde (USD), après frais
`network`	string	Réseau blockchain utilisé. Toujours `TRC-20`
`status`	string	Toujours `completed`
`description`	string	Description de la transaction

Vérifier l'authenticité de la notification

Après réception du webhook, nous vous recommandons de vérifier la transaction via l'endpoint /verify-trx en croisant la reference et le amount_net :

POST /api/v1/verify-trx
{
  "api_key": "pk_live_xxxxxxxxxxxxxxxxxxxx",
  "secret_key": "sk_live_xxxxxxxxxxxxxxxxxxxx",
  "reference": "RECV83K2PX7QAM",
  "amount": 48.55
}

Réponse attendue si la transaction est valide :

{
  "success": true,
  "message": "Transaction received.",
  "data": {
    "reference": "RECV83K2PX7QAM",
    "amount": 48.55,
    "type": "deposit",
    "status": "completed",
    "processed_at": "2026-03-09 14:22:10"
  }
}

Notes importantes

Le webhook est envoyé après que le crédit a été appliqué sur votre solde.
Si votre serveur ne répond pas dans les 10 secondes, la requête est abandonnée — le crédit reste effectif.
Votre endpoint doit retourner un HTTP 2xx pour confirmer la réception.
La webhook_url est définie lors de l'appel à /api/v1/generate-usdt-adresse — une adresse différente peut avoir une webhook_url différente.
Le champ label vous permet d'identifier quel client est concerné par le paiement reçu.