Cómo aceptar pagos en USDT TRC20

Qué es realmente USDT TRC20

USDT es una stablecoin emitida por Tether pensada para seguir el dólar estadounidense. Existe en varias blockchains, y la red decide cómo se comporta una transferencia. TRC20 es el estándar de tokens en TRON. Una dirección de USDT TRC20 empieza por la letra T y una transferencia es una transacción de TRON.

Por qué es tan habitual entre los clientes:

• las transferencias son baratas en comparación con muchas otras redes, lo que importa en pedidos pequeños y medianos;
• la mayoría de exchanges y billeteras admiten retiros en esta red, así que es la opción por defecto de muchos compradores;
• el monto es en dólares, de modo que ni tú ni el cliente soportan oscilaciones de precio entre el pedido y el pago.

Para ti, como comerciante, la consecuencia práctica es que gran parte de los clientes que dicen «pago en USDT» se refieren a USDT en TRON. Si no lo ofreces, a los clientes les resulta más difícil pagarte.

La red forma parte del pago

La misma moneda en otra red es otro pago. USDT en TRON, en Ethereum (ERC20) y en BNB Smart Chain (BEP20) usan direcciones y vías distintas, y los fondos enviados por la red equivocada no llegan adonde el remitente espera. Es el error más caro en los pagos con stablecoins, y lo cometen los clientes, no los comerciantes.

Qué ayuda:

• que la página de pago, y no el texto de tu checkout, defina la red: el cliente elige allí el activo y la red y recibe la dirección correspondiente;
• indicar claramente en tu checkout qué redes aceptas (consulta las monedas admitidas);
• si quieres dirigir a todos a TRON, pasa el método de pago de USDT TRC20 al crear el pago, de modo que la página se abra con él ya seleccionado.

Qvard admite, entre sus redes, TRON (TRC20), Ethereum (ERC20) y BNB Smart Chain (BEP20). Ofrecer varias redes no es malo, pero cada opción extra es otra oportunidad para que un cliente elija por costumbre una distinta de la que pretendía; la página de pago muestra la red y la dirección juntas para que esto se vea con claridad.

Cómo fluye un pago en USDT

El camino del pedido al pago:

1. El cliente elige pagar con cripto y tu servidor crea un pago para el pedido.
2. La pasarela devuelve una página de pago alojada. Tu cliente elige USDT y la red TRC20 y ve la dirección y el monto exacto.
3. Envía el monto desde su billetera o su exchange. El tipo de cambio de la página queda fijado durante una hora, así que el monto no cambia mientras paga.
4. La pasarela vigila la red TRON. Cuando llega el monto completo y el pago es definitivo, llama a tu webhook.
5. Tu sistema marca el pedido como pagado.

Nunca generas direcciones TRON ni operas un nodo. Crear el pago es una sola solicitud: un POST a https://api.qvard.com/api/v1/payment con el encabezado x-api-key y un cuerpo con el id de tu pedido y el price en dólares estadounidenses. La versión paso a paso con código está en cómo aceptar pagos cripto en un sitio web.

Comisiones: quién paga qué

Se mezclan tres costos distintos, y conviene separarlos.

• La comisión de red de la transferencia. Quien envía USDT en TRON paga la transacción con los recursos propios de la red (TRX o energía). Es un costo del cliente cuando te paga. Tu precio no necesita incluirlo, aunque a un cliente que paga desde un exchange se le puede descontar una comisión de retiro de lo que envía.
• La comisión de la pasarela. Según la página de precios, es individual para tu proyecto, parte del 1% y, por acuerdo, puede bajar hasta el 0,1%. No hay cuota de suscripción.
• La comisión de red cuando retiras. Retirar tu saldo a tu propia billetera cuesta solo la comisión de red.

Lo que importa en el checkout es el primer punto: si un cliente envía menos porque un exchange descontó una comisión del monto, el pago está incompleto, no completado.

Pagos parciales y otros casos límite

Un pago termina en uno de cuatro estados: wait (creado), partial (llegó menos de lo requerido), completed (llegó el monto completo) y rejected. Solo completed activa el webhook.

Con USDT TRC20, los problemas realistas son:

• Pago parcial desde un exchange. La comisión de retiro se restó del monto. El estado es partial. Decide de antemano si pides la diferencia o reembolsas al cliente, e infórmale en la página del pedido.
• Pago fuera del plazo del tipo de cambio. El tipo de cambio se fija durante una hora. Si el cliente paga mucho después, trátalo como un caso para soporte en lugar de construir automatización para ello.
• Red equivocada. El cliente pagó en una red distinta de la que mostraba la página. Requiere revisión manual y el código no lo arregla; mantén un contacto de soporte claro en el flujo de pago.

Haz que el manejador del pedido sea idempotente, porque el webhook se reintenta hasta que tu endpoint responde exactamente HTTP 200, y compara el encabezado x-api-key con tu clave. Más información en cómo proteger los webhooks de pagos cripto.

Qué configurar primero

Un orden de trabajo corto que lleva a un checkout con USDT TRC20 funcionando:

1. Crea una cuenta y un proyecto, y obtén tu clave API.
2. Mira una factura de demostración para ver lo que verá tu cliente.
3. Añade la llamada de creación de pago a tu checkout, con tu número de pedido como id.
4. Añade el endpoint del webhook, guarda su dirección como callback URL y marca los pedidos como pagados solo con completed.
5. Paga un monto real pequeño en USDT sobre TRON y comprueba todo el recorrido, incluido un retiro a tu billetera.

Un sandbox independiente está en la hoja de ruta, así que por ahora usa montos reales pequeños. La documentación para desarrolladores tiene los formatos exactos de solicitud y respuesta.

A dónde puedes retirar

Los fondos de los pagos quedan en tu saldo de Qvard y los retiras a tu propia billetera cripto; el costo es la comisión de red. El retiro a una cuenta bancaria en moneda fiat no está disponible, así que prevé una salida cripto, por ejemplo a un exchange que ya uses, si necesitas convertir a efectivo.

FAQ