Tutorial WooCommerce: cómo aceptar pagos con stablecoins (USDT y USDC) paso a paso desde cero

Tienes dos caminos según tu hosting:

Opción A — Instalador en un click (recomendado para principiantes):

1. Entra al panel de tu hosting (cPanel, hPanel de Hostinger, Site Tools de SiteGround, etc.).
2. Busca la sección "Auto Installer", "Softaculous Apps Installer" o "Install WordPress".
3. Selecciona tu dominio, define usuario admin (no uses admin literal, es el primero que prueban los bots), una contraseña fuerte y un email de recuperación.
4. Espera 1–2 minutos y entra a https://tudominio.com/wp-admin.

Opción B — Instalación manual (cuando tu hosting no trae auto-installer):

# 1. Descarga la última versión
wget https://wordpress.org/latest.tar.gz
tar -xzf latest.tar.gz
 
# 2. Sube el contenido de wordpress/ a public_html/ vía FTP/SFTP
# (tu cliente FTP: FileZilla, Cyberduck, etc.)
 
# 3. Crea la base de datos desde phpMyAdmin:
#    - Nombre: wp_tienda
#    - Usuario: wp_user
#    - Contraseña: una larga y aleatoria
 
# 4. Visita https://tudominio.com y completa el wizard de WordPress
#    pegando los datos de la base de datos.

Una vez dentro del wp-admin:

• Ve a Ajustes > Generales y confirma que la URL del sitio empieza por https://.
• Ve a Ajustes > Enlaces permanentes y elige "Nombre de la entrada". Esto es esencial para SEO y para que la URL del webhook (/wp-json/tdp/v1/webhook) responda correctamente.

WooCommerce es el plugin de e-commerce más usado del mundo (potencia ~30% de todas las tiendas online). Es gratuito, mantenido por Automattic y tiene la mayor oferta de extensiones.

1. En el wp-admin ve a Plugins > Añadir nuevo.
2. Busca WooCommerce (autor: Automattic).
3. Pulsa Instalar ahora y luego Activar.
4. Se abrirá el asistente de configuración (Setup Wizard). Completa los pasos:
   • Detalles de la tienda: país, dirección, email de contacto.
   • Industria: elige la que mejor describa tus productos.
   • Tipos de producto: físico, digital, suscripciones, etc.
   • Detalles del negocio: número aproximado de productos y si vendes en otra plataforma.
   • Tema: puedes mantener el tema actual de WordPress; Storefront y Astra son los más livianos y compatibles.

Después del wizard, ve a WooCommerce > Ajustes > General y confirma:

Ahora la parte cripto. Vas a registrar el negocio en TronDealer para que te entregue una API key (la credencial que el plugin de WordPress usará para pedir direcciones de depósito).

1. Entra a https://trondealer.com/es/onboard (registro público, sin KYC para empezar).

2. Completa el formulario:

   • Nombre del negocio: el que quieras que aparezca en facturas internas (no se muestra al cliente).
   • Email: usa uno que revises a diario, las alertas operacionales llegan ahí.
   • Método de payout: cómo quieres recibir los fondos cuando se barran (sweep) las direcciones.

   Payout method	Para quién	Comisión TronDealer
   wallet	Comerciante con wallet propia (Trust, MetaMask, Phantom, TronLink)	0.4% por transacción o $0.30 fijo si el monto es menor a $10 USD
   qvapay	Comerciante que quiere recibir en USD/CUP/EUR vía QvaPay	0% (gratis)
   zelle	Comerciante con Zelle activo en EE.UU.	Según QvaPay

3. Si elegiste wallet, define sweep_wallet_evm (tu dirección EVM, ej: 0xABC...), sweep_wallet_tron (Base58, ej: TXX...) y sweep_wallet_sol (Base58 Solana). Solo necesitas configurar las redes que vas a habilitar en el plugin.

4. Resuelve el captcha Cloudflare Turnstile y pulsa Crear cuenta.

5. Vas directo al dashboard. En la barra superior verás tu API key con prefijo td_ seguido de 64 caracteres hexadecimales. Cópiala a un gestor de contraseñas (1Password, Bitwarden) ahora mismo: es la única vez que se mostrará completa.

Si quieres entender qué hace cada endpoint que el plugin va a invocar bajo el capó, échale un ojo a la guía de integración por API en 6 pasos.

El plugin se distribuye como ZIP descargable.

1. Descarga la última versión desde la página oficial del plugin (link directo a la release en GitHub: github.com/qvapay/trondealer-woocommerce/releases). Pronto también estará en el directorio oficial de WordPress.org.
2. En tu wp-admin ve a Plugins > Añadir nuevo > Subir plugin.
3. Selecciona el ZIP trondealer-payments-vX.X.X.zip y pulsa Instalar ahora.
4. Cuando termine, pulsa Activar plugin.

Al activarse, el plugin:

• Registra una pasarela de pago llamada Trondealer dentro de WooCommerce.
• Crea un endpoint REST en https://tudominio.com/wp-json/tdp/v1/webhook que recibirá las notificaciones firmadas de TronDealer.
• Programa un WP-Cron de fallback cada 5 minutos que reconcilia pedidos por si un webhook se pierde por una caída temporal del sitio.

Aquí ocurre la magia: en una sola pulsación el plugin se autenticará contra TronDealer y registrará tu URL de webhook con un secreto HMAC generado automáticamente.

1. Ve a WooCommerce > Ajustes > Pagos.
2. En la lista de métodos verás Trondealer. Pulsa Gestionar (o Manage).
3. Marca la casilla Habilitar Trondealer.
4. Rellena los campos:

5. Pulsa Guardar cambios.
6. Aparecerá un botón Run connection test. Pulsa.

Lo que hace ese botón internamente:

1. GET /api/v2/clients/me con tu x-api-key
   -> verifica que la key existe y está activa
2. Genera un secreto webhook aleatorio de 64 chars hex
   (solo si tdp_webhook_secret aún no existe)
3. PATCH /api/v2/clients/me con:
   - webhook_url: https://tudominio.com/wp-json/tdp/v1/webhook
   - webhook_secret: el generado
4. POST /api/v2/clients/me/webhook-test
   -> TronDealer dispara un POST de prueba a tu webhook
5. Verifica que respondiste 2xx

Si todo va bien verás un aviso verde tipo:

Connected as Mi Tienda. Webhook URL https://tudominio.com/wp-json/tdp/v1/webhook registered and verified.

Si ves un warning del tipo "test ping failed", revisa: certificado HTTPS válido (no autofirmado), enlaces permanentes en modo "Nombre de la entrada", y que ningún plugin de seguridad (Wordfence) esté bloqueando peticiones POST sin user-agent estándar.

En la misma página de ajustes del plugin verás Enabled networks: un multiselect con todos los pares red:asset disponibles.

Recomendación para empezar: habilita tron:USDT, bsc:USDT, pol:USDT y pol:USDC. Cubre el 80% de los casos hispanos con fees mínimos. Ethereum mainnet déjalo para tickets superiores a $100 USD por el gas.

Ajusta también:

• Tolerance: 1% es seguro. Algunos exchanges retiran cantidades ligeramente menores por fees internas; con 1% de tolerancia evitas marcar como "underpaid" pedidos que en realidad están bien.
• Whitelabel: si quieres branding 100% propio, actívalo. El cliente verá solo "Pagar con USDT/USDC" sin mención a TronDealer.

Pulsa Guardar cambios.

Antes de promocionar el checkout, siempre haz una compra real con cantidad mínima para validar el flujo completo.

1. Crea un producto barato: ve a Productos > Añadir nuevo, ponle precio $1.00 USD y publícalo.

2. Abre el sitio en una ventana incógnita (para no usar tu sesión de admin).

3. Añade el producto al carrito y ve a checkout.

4. En la sección de pago verás el método Trondealer con un selector de red+asset.

5. Elige TRON: USDT (la opción más rápida y barata para probar).

6. Completa el checkout. Llegarás a la página de agradecimiento con:

   • La dirección de depósito generada exclusivamente para ese pedido (label wc_<order_id>).
   • Un código QR escaneable.
   • El monto exacto en USDT a enviar.
   • Un contador en vivo que poll-ea el estado del pedido.

7. Desde tu wallet (TronLink, Trust Wallet, Binance App) envía exactamente $1.00 USDT-TRC20 a esa dirección.

8. En 60–90 segundos deberías ver:

   • El pedido pasa a on-hold (transaction.incoming recibido).
   • Tras 19 confirmaciones (~1 minuto en TRON) pasa a processing o completed (transaction.confirmed).
   • Una nota interna con el tx_hash queda en el pedido para auditoría.

Si todo eso ocurrió: estás operativo.

Antes de anunciar el método a tus clientes:

• Backups automáticos: configura UpdraftPlus para hacer backup diario de la base de datos y semanal de archivos. Si tu hosting cae, recuperas la tienda en horas, no en días.
• Monitoring de uptime: usa UptimeRobot (gratis) para alertarte si el sitio cae. Un sitio caído = webhooks fallando = pedidos que no se confirman.
• Email transaccional confiable: configura WP Mail SMTP con SendGrid o Brevo para que los emails de "pedido pagado" lleguen al cliente sin pasar por spam.
• Reconciliación cruzada: cada semana entra al dashboard de TronDealer y compara el listado de transacciones con tus pedidos en WooCommerce. El WP-Cron de 5 minutos reduce a casi cero los fallos, pero la conciliación manual es buena higiene contable.
• Alertas de payout: en el dashboard activa las notificaciones por email para sweeps fallidos. Si un sweep falla (gas insuficiente en alguna red, RPC caído), tendrás los fondos retenidos hasta que se reintente.