Recibir pagos en TRON (TRX)

#Cómo funciona un pago en TRX

Un pago en TRX en CryptoLike pasa por cuatro pasos y tres estados: new (Nuevo), pending (Pendiente) y paid (Pagado). 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. El cliente no necesita una cuenta en CryptoLike, solo una billetera TRON con TRX suficiente para el monto y la comisión de red.

1. Creas el pago con POST /v1/invoices, la extensión para OpenCart o un enlace de pago. Estado: new.
2. El cliente ve qué enviar: el monto exacto en TRX, 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. El pago se confirma. Tras 19 confirmaciones el estado pasa a paid, los fondos están en tu saldo y llega un webhook invoice.paid firmado.

#Lo que el cliente debe saber sobre TRON

CryptoLike asigna a cada pago en TRX su propia dirección TRON, que empieza por T y nunca se reutiliza. Una transferencia de TRX consume ancho de banda; cuando a la cuenta que envía no le queda, la red quema TRX para cubrirlo, así que el cliente debe tener un poco de TRX además del monto. CryptoLike detecta una transferencia directa de TRX; el TRX que mueve un contrato inteligente no se detecta automáticamente.

• Dirección. 34 caracteres, empieza por T.
• Comisión de red. La paga el remitente en TRX. Las direcciones de pago son nuevas, así que la primera transferencia a una de ellas también lleva la comisión de activación de cuenta de TRON en TRX; la billetera muestra el total antes de enviar.
• Solo cuenta TRX. Un pago en TRX se paga en TRX. USDT y otros tokens de TRON no cuentan para él.
• Monto exacto. Si un exchange descuenta su comisión de retiro, el pago llega incompleto y queda en underpaid (Pago insuficiente). Envía la diferencia a la misma dirección antes de que se acabe el tiempo.
• Red. Envía TRX solo en la red TRON. Los fondos enviados por otra red nunca llegan al pago y no se pueden recuperar.

#Crea un pago en TRX

Para crear un pago en TRX en CryptoLike, toma el id del activo con ticker TRX y network tron de GET /v1/currencies y pásalo como coin_id a POST /v1/invoices. Pon el precio en USD, como en el ejemplo, o en TRX; un monto en moneda fiat se convierte al tipo de cambio actual, que queda fijado durante el plazo del pago.

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

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

La respuesta trae address, payer_amount y checkout_url: envía al cliente a esa página. Firma de las solicitudes: autenticación de la API; todos los campos: referencia de la API.

#Preguntas frecuentes

#¿Cuántas confirmaciones necesita un pago en TRX?

CryptoLike acredita TRX tras 19 confirmaciones de la red TRON. El umbral se define para cada activo, lo devuelve GET /v1/currencies y el cliente ve el avance en la página de pago. Más información sobre las confirmaciones.

#¿Qué pasa si el cliente envía USDT en lugar de TRX?

USDT no cuenta para un pago en TRX, así que el estado no cambia; si ya se envió, escribe a soporte con el identificador de la transacción. La próxima vez, crea el pago en USDT (TRC20), o con currency: "USD" y sin coin_id, y el cliente elige el activo en la página de pago.

#¿Qué pasa si el cliente envía TRX por otra red?

La transferencia no llega a este pago y no se puede recuperar: un pago en TRX vigila solo una dirección TRON. Si el tiempo ya se acabó, crea un pago nuevo.

#¿Puedo poner el precio en USD?

Sí. Envía currency: "USD" con el coin_id de TRX: CryptoLike convierte al tipo de cambio actual y lo deja fijado durante el plazo del pago. Si no hay un tipo de cambio reciente, la API responde 503: reintenta o pon el precio del pago en TRX.

#¿Cómo funcionan los retiros en TRX?

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 (pagos masivos). Antes, POST /v1/withdrawals/estimate muestra la comisión de la plataforma, la comisión de red reservada y el total a debitar. Los retiros requieren una cuenta verificada; las comisiones están en la página de precios.