# Recibir pagos en USDT TRC20 (TRON)

> Recibe pagos en USDT TRC20 con CryptoLike: tu cliente ve el monto, la red y el tiempo restante; el saldo se acredita tras las confirmaciones, con webhook firmado.

Source: https://cryptolike.net/es/coins/usdt-trc20
Updated: 2026-09-25

Para cobrar en USDT por la red TRON, CryptoLike acredita el pago en USDT (TRC20) a tu saldo tras 19 confirmaciones de la red TRON y se lo informa a tu servidor con un webhook firmado. Tú creas el pago y tu cliente envía los USDT desde su propia billetera. CryptoLike vigila la dirección, cuenta las confirmaciones y cambia el estado de `pending` a `paid`.

## Cómo funciona un pago en USDT (TRC20)

Un pago en USDT (TRC20) en CryptoLike pasa por cuatro pasos y tres estados: `new`, `pending` y `paid`. La página de pago, la API y los webhooks muestran el mismo estado, así que la lógica de tus pedidos lee un solo campo. Tu cliente no necesita cuenta en CryptoLike: solo una billetera de TRON con USDT y algo de TRX.

1. **Creas el pago** con `POST /v1/invoices`, el [plugin para WooCommerce](https://cryptolike.net/es/integrations/woocommerce), la [extensión para OpenCart](https://cryptolike.net/es/integrations/opencart) o un [enlace de pago](https://cryptolike.net/es/use-cases/payment-links). Estado: `new`.
2. **Tu cliente ve qué debe enviar:** el monto exacto en USDT, la red (TRON), la dirección con código QR y el tiempo restante.
3. **Se detecta la transferencia.** Estado: `pending`, «Pago detectado. Esperando confirmación.»
4. **Se confirma el pago.** Tras 19 confirmaciones el estado pasa a `paid`, los fondos están en tu saldo y llega un [webhook](https://cryptolike.net/docs/webhooks) `invoice.paid` firmado.

## Qué debe saber tu cliente sobre TRON

En TRON, CryptoLike acepta solo los USDT del contrato oficial de Tether enviados a una dirección de TRON que empieza con `T`. La billetera del cliente paga la comisión de red de TRON en TRX, en forma de energía y ancho de banda, por lo que necesita algo de TRX junto a los USDT. El monto de la página de pago debe llegar completo y únicamente por la red TRON.

- **Dirección.** Tiene 34 caracteres y empieza con `T`. Después de pegarla, compara los primeros y los últimos caracteres con los de la página.
- **Comisión de red.** Una transferencia TRC20 consume energía y ancho de banda; si la cuenta no tiene energía propia, quema TRX para cubrirla. Una billetera con USDT y 0 TRX no puede enviar.
- **Contrato.** Solo se acreditan los USDT del contrato de Tether `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t`.
- **Monto exacto.** Si un exchange descuenta su comisión de retiro, el pago llega incompleto y queda en `underpaid`. Envía la diferencia a la misma dirección antes de que se acabe el tiempo.
- **Red.** Los USDT enviados por otra red nunca llegan a este pago y no se pueden recuperar.

## Crea un pago en USDT (TRC20)

Para crear un pago en USDT (TRC20) en CryptoLike, toma de `GET /v1/currencies` el `id` del activo con `ticker` USDT y `network` tron, y pásalo como `coin_id` a `POST /v1/invoices`. Pon el precio en USDT o en USD: en ese caso CryptoLike convierte al tipo de cambio actual y lo fija durante el plazo del pago.

```bash
COIN_ID=$(curl -s https://api.cryptolike.net/v1/currencies \
  | jq -r '.currencies[] | select(.ticker=="USDT" and .network=="tron") | .id')

BODY='{"amount":"49.90","currency":"USD","coin_id":"'"$COIN_ID"'","order_id":"A-1001"}'
curl -s https://api.cryptolike.net/v1/invoices \
  -H "Content-Type: application/json" -H "Idempotency-Key: order-A-1001" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" -d "$BODY"
```

La respuesta incluye `address`, `payer_amount` y `checkout_url`: envía a tu cliente a esa URL. Cómo firmar la solicitud: [autenticación de la API](https://cryptolike.net/docs/auth); todos los campos: [referencia de la API](https://cryptolike.net/docs/api).

## Preguntas frecuentes

### ¿Cuántas confirmaciones necesita USDT TRC20?

CryptoLike acredita USDT (TRC20) tras 19 confirmaciones de la red TRON. El umbral se define por activo, lo devuelve `GET /v1/currencies` y tu cliente ve el avance en la página de pago. Más sobre las [confirmaciones](https://cryptolike.net/es/glossary/confirmations).

### ¿Qué pasa si el cliente envía USDT por Ethereum (ERC20)?

La transferencia no llega a este pago y no se puede recuperar: un pago TRC20 vigila únicamente una dirección de TRON. Para que el cliente elija la red, crea el pago con `currency: "USDT"` y sin `coin_id`; así elige en la página entre TRON y [Ethereum (ERC20)](https://cryptolike.net/es/coins/usdt-erc20).

### ¿Puedo poner el precio en USD?

Sí. Envía `currency: "USD"` con el `coin_id` de USDT: CryptoLike convierte al tipo de cambio actual y lo fija durante el plazo del pago. Si no hay un tipo de cambio reciente disponible, la API responde `503`: vuelve a intentarlo o pon el precio del pago en USDT.

### ¿Puede un cliente tener una dirección USDT TRC20 permanente?

Sí. `POST /v1/addresses` con el `coin_id` de USDT (TRC20) y tu `customer_id` emite una [dirección estática](https://cryptolike.net/glossary/static-address). Cada transferencia a ella se acredita tras 19 confirmaciones y se notifica con `deposit.confirmed`; si una transferencia queda retenida para revisión, llega `deposit.on_hold` en su lugar.

### ¿Cómo funcionan los retiros en USDT TRC20?

Con `POST /v1/withdrawals` y los campos `coin_id`, `amount`, `to_address` y tu `payout_id`, o con un CSV de hasta 1,000 filas en el panel ([pago masivo](https://cryptolike.net/es/use-cases/mass-payouts)). Antes, `POST /v1/withdrawals/estimate` muestra la comisión de la plataforma, la comisión de red reservada (en USDT, sin necesidad de saldo en TRX) y el total que se descuenta. Los retiros requieren una cuenta verificada; las comisiones están en la [página de precios](https://cryptolike.net/es/pricing).
