Come accettare pagamenti in USDT (TRC20) sul tuo sito o bot

USDT su TRON è il modo più diffuso di pagare in crypto in molte regioni: trasferimenti rapidi ed economici per chi paga. Questa guida mostra l’integrazione minima con ChainPay.

Il modello

1. Il tuo backend chiede a ChainPay un indirizzo di deposito per ogni ordine (o per ogni utente).
2. Chi paga invia USDT a quell’indirizzo.
3. Dopo la conferma della rete, ChainPay lo inoltra al tuo wallet e chiama il tuo webhook.

La custodia resta tua: la destinazione è il tuo forwardAddress e ChainPay non detiene un saldo del merchant.

Un indirizzo per ordine o per utente

• Per ordine: un nuovo externalReference per ogni ordine. Riconciliazione semplice, un pagamento per indirizzo.
• Per utente: riusa lo stesso externalReference. L’indirizzo è permanente e può ricevere molti depositi; adatto a ricariche e saldi.

Crea l’indirizzo

curl -X POST https://api.chainpay.site/deposit-address \
  -H 'content-type: application/json' \
  -d '{
    "ticker": "trc20/usdt",
    "callbackUrl": "https://shop.example.com/crypto-webhook?token=SECRET",
    "forwardAddress": "TYourOwnTronWallet...",
    "externalReference": "order-123"
  }'

Gestisci il webhook

• Verifica il valore token della tua query.
• Abbina il pagamento tramite externalReference.
• Accredita l’ordine solo con status: "confirmed".
• Rendi l’handler idempotente: lo stesso evento può arrivare più volte.

Cosa paga chi paga

Ogni trasferimento TRC20 richiede Energy di TRON, quindi la commissione ha una parte percentuale (1 %) e una parte fissa calcolata sul costo reale della rete. Su TRON questa parte fissa è di circa 4 USDT alle tariffe attuali, quindi i pagamenti molto piccoli non convengono. Imposta un importo minimo ragionevole. Valori attuali in Prezzi.

Provalo

Se vuoi vedere l’indirizzo nel tuo account, registrati nel cabinet, crea una API key e invia la stessa richiesta con x-api-key. Inizia con un importo piccolo.

Correlati

• Quickstart
• Deposits API
• Networks