Recibir pagos en USDT TRC20 (TRON)

#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, la extensión para OpenCart o un enlace de pago. 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 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.

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; todos los campos: referencia de la 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.

#¿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).

#¿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. 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). 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.