CryptoLike recibe USDT en la red TRON (TRC20) con la misma API de pagos, los mismos plugins y los mismos enlaces de pago que cualquier otro activo del catálogo. Creas un pago, el pagador envía USDT a una dirección TRON que empieza con «T» y el pago pasa a paid (Pagado) cuando se alcanza el umbral de confirmaciones del activo. Después, un webhook firmado se lo informa a tu servidor.
Qué es USDT TRC20 para CryptoLike
Para CryptoLike, USDT en TRON es un activo propio: el mismo ticker en otra red, USDT en Ethereum (ERC20), es un activo distinto, con su propio formato de dirección, sus confirmaciones y sus comisiones. Los pagos, las direcciones estáticas y los retiros funcionan con USDT TRC20, y los fondos se acreditan en un saldo de USDT TRC20 de tu cuenta.
| Dato | USDT TRC20 en CryptoLike |
|---|---|
| Activo · red | USDT · TRON (TRC20); network en la API es tron |
| Formato de dirección | Dirección TRON que empieza con «T» |
| Confirmaciones | Se definen por activo: confirmations en GET /v1/currencies, y se muestran en la página de USDT TRC20 |
| Comisión de la plataforma | Por activo y dirección de la operación, en la página de precios |
| Comisión de red del pagador | La paga la billetera del remitente en TRX (energía y ancho de banda) |
| Formas de recibir | Pago (factura), dirección estática, enlace de pago, plugins para CMS |
| Retiros | Sí, con una estimación de la comisión antes de confirmar |
Cómo elegir entre las dos redes de USDT se explica en USDT TRC20 vs ERC20.
Antes de empezar
Para CryptoLike necesitas una cuenta con USDT TRC20 habilitado, una clave API con create_invoice y read (o un plugin para CMS, o solo el panel para enlaces de pago) y un endpoint de webhook en tu servidor. Prueba primero con una clave ck_test_ y la URL de la API de prueba que te da el soporte de CryptoLike: las claves de prueba funcionan con redes de prueba, donde el USDT de prueba no tiene valor; el soporte de CryptoLike te puede enviar monedas de prueba.
Si usas un plugin, nada cambia para USDT: el pagador elige USDT TRC20 en la página de pago y el pedido sigue el estado del pago. Consulta la página de integraciones.
1. Encuentra USDT TRC20 en el catálogo
CryptoLike lista en GET /v1/currencies todos los activos habilitados para tu cuenta: toma la entrada con ticker USDT y network tron. Su id es el coin_id que envías al crear pagos o retiros, y la entrada también trae decimals, el umbral confirmations y el indicador maintenance.
Si la entrada no aparece, el activo está desactivado para tu cuenta: actívalo en el panel, en la página Monedas, y escribe a soporte solo si no se ofrece ahí. Si maintenance es true, por ahora el activo no se puede elegir para pagos nuevos; ofrece al pagador otro activo o inténtalo más tarde.
2. Crea un pago en USDT TRC20
CryptoLike crea un pago en USDT TRC20 con una sola llamada a POST /v1/invoices. Pon el precio en USD u otra moneda fiat habilitada y envía el coin_id de USDT TRC20: el tipo de cambio queda fijado al crear el pago, y la respuesta ya trae la dirección TRON y el monto exacto en USDT. Sin coin_id, el pagador elige el activo en la página de pago.
{
"amount": "49.90",
"currency": "USD",
"coin_id": "<id of USDT on tron from GET /v1/currencies>",
"order_id": "A-1002",
"idempotency_by_order_id": true
}No dependas solo de currency: "USDT": el ticker existe en dos redes, y coin_id identifica exactamente una. Un reintento con el mismo Idempotency-Key devuelve el mismo pago en lugar de crear un segundo. Un 503 unavailable significa que no había un tipo de cambio actualizado: reintenta o crea el pago en USDT.
3. Muéstrale al pagador la red correcta
La página de pago de CryptoLike muestra el monto, la red, una dirección TRON con código QR y el tiempo restante, junto al aviso «Envía a esta dirección solo USDT en la red TRON (TRC20). Los fondos enviados por otra red no se pueden recuperar.» Envía ahí al pagador con checkout_url o integra la página con el widget de pago.
El código QR contiene solo la dirección; el pagador copia el monto que aparece al lado. Una billetera de autocustodia también necesita TRX: en TRON, una transferencia TRC20 consume energía y ancho de banda, que se pagan en TRX cuando la billetera no los obtuvo con staking. Esa comisión de red la paga el pagador y no forma parte de tu monto. Si la transferencia se envió por otra red, nunca llega al pago: pide al pagador que la envíe de nuevo por TRON.
4. Espera las confirmaciones y entrega con paid
CryptoLike pasa el pago a pending («Pago detectado. Esperando confirmación.») en cuanto la transferencia de USDT entra en un bloque de TRON, y a paid cuando se alcanza el umbral de confirmaciones del activo. En ese momento los fondos se acreditan en tu saldo y tu endpoint recibe el webhook firmado invoice.paid.
La página de pago muestra el avance como «n de N confirmaciones». CryptoLike acredita solo el contrato de USDT que figura en su catálogo; un token con el mismo nombre de otro contrato no se acredita. Si una reorganización de bloques revierte una transferencia confirmada, recibes invoice.reverted: detén la entrega hasta un nuevo invoice.paid. Detalles: confirmaciones de pagos cripto.
5. Maneja pagos insuficientes, excedentes y tardíos
CryptoLike resuelve los montos incorrectos con el estado del pago, no rechazando los fondos. Si llega menos del monto, el pago queda en underpaid (Pago insuficiente), la página muestra lo que falta y el pagador puede completar en la misma dirección hasta el vencimiento. Si llega más, el pago queda en paid con overpaid_amount. Los fondos que llegan después del vencimiento también se acreditan, con late_payment: true y un webhook invoice.late_payment.
Una diferencia pequeña dentro de la tolerancia de pago insuficiente de tu cuenta cuenta igual como paid. Ante un underpaid definitivo o un pago tardío, decide con el cliente: entregar, pedir lo que falta o devolver el dinero con un retiro. Más en pago insuficiente.
6. Retira USDT TRC20
CryptoLike envía retiros de USDT TRC20 desde tu saldo disponible con POST /v1/withdrawals. Llama primero a POST /v1/withdrawals/estimate: antes de crear nada, devuelve la comisión de la plataforma, la comisión de red reservada y total_debit, todo en USDT (la comisión de red de TRON se convierte al activo del retiro).
La comisión de red que se cobra depende del modo que la plataforma define para tu cuenta: por defecto, la estimación reservada; o bien la comisión realmente pagada, con devolución de la reserva no usada. Si el destino en TRON es un contrato inteligente, la respuesta trae un address_warning; revísalo antes de confirmar. Para muchos retiros a la vez, consulta el pago masivo de criptomonedas.
Comisiones: quién paga qué
CryptoLike separa tres comisiones en un pago en USDT TRC20, y cada una se muestra como un monto con su unidad: a ti, en la respuesta de la API o en la estimación del retiro; al pagador, en su billetera. Tu comisión de la plataforma se cobra solo cuando el pago se confirma; la comisión de red del pagador la paga en TRX la billetera del remitente; un retiro suma su propia comisión de la plataforma y de red en USDT.
| Comisión | Quién paga | En qué | Dónde la ves |
|---|---|---|---|
| Comisión de la plataforma sobre un pago | Tú por defecto, o el pagador con fee_paid_by: payer |
USDT | Precios; la respuesta de la API; el panel. La página de pago no muestra una línea de comisión: cuando la paga el pagador, está incluida en el monto |
| Comisión de red de la transferencia del pagador | La billetera del pagador | TRX (energía, ancho de banda) | La billetera del pagador |
| Comisión de la plataforma y de red de un retiro | Tú | USDT | POST /v1/withdrawals/estimate, el panel |
Cómo se suman las piezas: las comisiones de los pagos cripto, explicadas.
Errores y qué hacer
CryptoLike devuelve los errores de la API con el mismo formato: un estado HTTP, un code legible por máquina, un message para personas y details que nombran el campo o el motivo. Para pagos y retiros en USDT TRC20, estos son los que debes manejar; cada uno tiene su acción de recuperación, y la lista completa está en la referencia de la API.
| HTTP · código | Qué pasó | Qué hacer |
|---|---|---|
400 validation_error |
Un campo es incorrecto, por ejemplo, más decimales de los que tiene USDT (details.field) |
Corrige el campo y vuelve a enviar |
409 conflict en un pago |
El estado del pago no lo permite, por ejemplo, cancelar un pago ya pagado | Consulta primero el estado actual |
409 conflict, insufficient_funds |
El saldo de USDT TRC20 no cubre total_debit |
Espera nuevas acreditaciones o retira menos |
422 address_refused |
La plataforma no acepta este destino | Usa otra dirección TRON |
403 kyb_required |
Los retiros requieren una cuenta verificada | Completa la verificación de la cuenta en el panel |
503 unavailable |
No hay un tipo de cambio actualizado o el activo está en pausa | Reintenta con espera progresiva o pon el precio del pago en USDT |
Preguntas frecuentes
¿Cuántas confirmaciones necesita USDT TRC20?
CryptoLike define el umbral por activo. El número vigente para USDT TRC20 está en el campo confirmations de GET /v1/currencies y en la página de USDT TRC20; la página de pago muestra el avance como «n de N confirmaciones».
¿Qué pasa si el pagador envía USDT por Ethereum?
Una transferencia por otra red nunca llega a un pago en TRON, y la página de pago lo advierte junto a la dirección. Pide al pagador que la envíe de nuevo por TRON o crea un pago en USDT ERC20, un activo distinto con dirección de Ethereum.
¿Por qué el pagador necesita TRX para enviar USDT?
En TRON, una transferencia TRC20 consume energía y ancho de banda. Una billetera sin recursos obtenidos con staking los paga en TRX, así que un saldo en USDT no alcanza por sí solo.
¿Puedo poner el precio de un pago en USDT TRC20 en dólares?
Sí. Crea el pago en USD u otra moneda fiat habilitada; CryptoLike fija el tipo de cambio cuando se conoce el activo y lo mantiene durante toda la vigencia del pago, así que el monto en USDT que ve el pagador no cambia.