Cómo aceptar pagos en USDT en tu sitio web

Para aceptar USDT en tu sitio, prepara una dirección de recepción en la red elegida, conéctala al servicio de Cryptanio correspondiente y muestra al comprador los datos de su pago concreto. Para un pago puntual puedes publicar un enlace de pago. En una tienda que gestiona los pedidos automáticamente, resulta más práctico crear una factura independiente para cada compra.

Esta guía trata las particularidades de USDT: cómo distinguir la red, el token y la moneda del precio, y después verificar correctamente el ingreso. El proceso general de integración del sitio se explica en una guía independiente.

Decide primero qué versión de USDT aceptas

USDT existe en varias blockchains. Por eso no basta con mostrar «Pagar con USDT»: también debe quedar clara la red. El mismo formato de dirección y el mismo símbolo en dos aplicaciones no demuestran que la transferencia sea compatible.

Para la opción elegida, comprueba las tres condiciones a la vez:

• la billetera del destinatario admite USDT en esa red y proporciona una dirección de recepción adecuada;
• Cryptanio permite esa combinación de red y activo en el servicio correspondiente del proyecto;
• la billetera o el servicio del remitente puede enviar esa versión concreta de USDT.

Coteja el identificador del token con el directorio oficial de Tether, sin fiarte solo del nombre y el logotipo. El directorio incluye información histórica sobre redes que han dejado de admitirse: que exista una sección antigua no significa que el protocolo siga siendo compatible. La disponibilidad en Cryptanio debe comprobarse aparte. El directorio se consultó el 14 de noviembre de 2026.

Prepara la dirección y conecta el activo correcto

En el panel, selecciona el proyecto del sitio con Payments activo para las facturas o Links para los enlaces de pago. Añade una dirección pública de recepción o selecciónala en la libreta de direcciones y conéctala al servicio elegido. Guardarla solo en la libreta no activa la recepción de pagos por ese servicio.

En los ajustes de uso de la dirección, revisa el campo «Activo». Para USDT debe identificar el token admitido en la red seleccionada. Un campo vacío significa la moneda nativa, no USDT. Las denominaciones admitidas, como USDT, se resuelven mediante el catálogo del servicio; si indicas un contrato o un mint, utiliza el identificador exacto de esa red. No introduzcas la dirección de un token de otra red.

Esta conexión no necesita una frase semilla ni una clave privada que permita gastar los fondos. Comprueba que la dirección pertenezca a tu billetera y que puedas gestionar por tu cuenta el USDT recibido.

Elige un enlace o una factura

Si tu sitio presenta un servicio y confirmas los pagos manualmente, abre «Enlaces de pago» y pulsa «Nuevo enlace de pago». Define un importe fijo y deja la versión de USDT necesaria entre los métodos de pago disponibles. Publica el enlace permanente obtenido en tu sitio. El proyecto debe disponer de direcciones conectadas específicamente a Links.

Para una tienda automatizada, crea las facturas mediante la API v1 en tu servidor. Con un activo elegido de antemano se indican project, chain, asset y una cadena amount en unidades de USDT. El precio del pedido en dólares y el importe esperado en criptomonedas tienen funciones distintas: una cotización en USD no implica aceptar dólares ni cambiar los tokens recibidos.

Guarda la relación del pedido con el ID de la factura. Utiliza un Idempotency-Key único para cada operación nueva y conserva el anterior al repetir la misma solicitud después de un fallo. La clave API secreta debe permanecer en el servidor.

Muestra los datos sin redondeos ni sustituciones

El comprador necesita la red, el activo, la dirección, el importe exacto y el plazo de pago de la página actual o de la respuesta de la factura. También debes transmitir cualquier memo, destination tag u otro dato adicional obligatorio. Para el QR, utiliza el payment_uri devuelto, si existe: no lo reconstruyas a partir de la dirección sola ni pierdas los datos adicionales.

No sustituyas el importe exacto por un precio redondeado del escaparate. No prometas que se aceptará USDC u otro token en lugar de USDT por tener un valor parecido. Al cambiar de método de pago, el comprador debe utilizar los datos actuales de su intento, no una dirección guardada anteriormente.

Comprueba aparte la comisión de transferencia de USDT: qué activo necesita la billetera para pagarla y cuánto recibirá realmente el vendedor. La comisión no debe reducir sin advertencia el importe esperado para el pedido.

Verifica el pago mediante la factura

Una captura de pantalla, un mensaje del comprador y una transacción detectada no confirman que el pedido esté pagado por completo. Para el procesamiento automático, comprueba el estado actual de la factura: el estado de éxito es paid. Un pago insuficiente, parcial o excesivo, o una transferencia tardía, pueden requerir una decisión específica.

El servidor puede recibir un webhook firmado y verificar el resultado mediante la API, o consultar el estado mediante la API sin webhook. Un evento o una comprobación repetidos no deben entregar el producto por segunda vez. Si necesitas un manejador de notificaciones, utiliza la guía de webhook.

Qué comprobar antes del primer pedido

Abre el pago desde el punto de vista del comprador y coteja la red, el activo y los datos. Si haces una prueba con una transferencia real, ten en cuenta la comisión y utiliza fondos propios: abrir la página no verifica por sí solo el ingreso.

Si se ha enviado la transferencia pero el pedido sigue sin pagarse, guarda el TXID y comprueba la red, el token exacto, el importe recibido y las confirmaciones. La guía sobre pedidos sin pagar explica cómo investigar pagos insuficientes y errores del sitio.