Cómo aceptar pagos en USDT (TRC20) en tu web o bot

USDT en TRON es la forma más habitual de pagar con cripto en muchas regiones: transferencias rápidas y baratas para quien paga. Esta guía muestra la integración mínima con ChainPay.

El modelo

Tu backend pide a ChainPay una dirección de depósito para cada pedido (o cada usuario).
El pagador envía USDT a esa dirección.
Cuando la red confirma la transferencia, ChainPay la envía a tu propia wallet y llama a tu webhook.

La custodia es tuya: el destino es tu forwardAddress y ChainPay no mantiene saldo del comercio.

Una dirección por pedido o por usuario

Por pedido: usa un externalReference nuevo en cada pedido. Conciliación sencilla, un pago por dirección.
Por usuario: reutiliza el mismo externalReference. La dirección es permanente y puede recibir muchos depósitos; encaja con recargas y saldos.

Crea la dirección

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

Gestiona el webhook

Verifica el valor token de tu query.
Asocia el pago por externalReference.
Acredita el pedido solo con status: "confirmed".
Haz el handler idempotente: el mismo evento puede llegar más de una vez.

Qué paga el pagador

Cada transferencia TRC20 necesita Energy de TRON, por lo que la comisión tiene una parte porcentual (1 %) y una parte fija calculada según el coste real de la red. En TRON esa parte fija ronda los 4 USDT con las tarifas actuales, así que los pagos muy pequeños no compensan. Fija un importe mínimo razonable. Cifras actuales en Precios.

Pruébalo

Si quieres ver la dirección en tu cuenta, regístrate en el cabinet, crea una API key y envía la misma petición con x-api-key. Empieza con un importe pequeño.