Cobros USDT y USDC en WordPress: configurar WooCommerce y EDD
El pago con stablecoins debe actualizar los pedidos nativos de la tienda. UUGate ofrece plugins para WooCommerce y Easy Digital Downloads (EDD). Selecciona el de tu plataforma: añadir un botón de pago no resuelve por sí solo la sincronización de pedidos.
Comprobar el entorno
Se necesitan PHP 8.1+, cURL, HTTPS y almacenamiento persistente. Sigue las instrucciones de instalación. Existen pruebas de pedidos nativos y callbacks en entornos concretos de WooCommerce/EDD; debes validar tus versiones, redes, tienda pública y modo de checkout. El flujo completo de Checkout Blocks no está verificado para todos los entornos.
Proteger configuración y archivos
Copia config.example.php fuera del directorio público. Configura merchant_uid, api_key y un asset admitido. UUGATE_CONFIG_FILE debe apuntar a ese archivo y state_dir a un directorio persistente escribible por PHP, nunca temporal ni de subidas públicas. Usa un store_id distinto por tienda y entorno; respalda base de datos y archivos de pedidos.
Activar el método
- WooCommerce: sube y activa el ZIP; habilita UUGate en Ajustes → Pagos. El callback utiliza
?wc-api=uugate. - EDD: activa su plugin y UUGate en ajustes de pagos. El receptor es
?edd-listener=uugate. - Selecciona TRC20-USDT, BEP20-USDT, BEP20-USDC o SPL-USDC y revisa la red mostrada.
Las tiendas en USD deben aceptar expresamente usd_at_par=true. Es una política de equivalencia del comerciante, no una cotización en tiempo real ni conversión fiduciaria. Otras monedas fiduciarias se rechazan.
Validar el pedido nativo
El retorno del navegador no debe liberar productos ni descargas. El plugin verifica notificación, pedido e importe antes de actualizar el pago. Prueba un pago y una notificación repetida: debe existir un único registro. Los pedidos sin pagar no deben acceder a contenido de pago. Consulta el protocolo de callback.
Recuperación y límites
Ante creación incierta o escritura interrumpida, concilia plataforma y tienda antes de actuar. No recrees pagos ni repitas operaciones parcialmente aplicadas a ciegas. No hay reembolsos automáticos ni débitos recurrentes; EDD no admite suscripciones recurrentes. Para flujos propios, usa PHP / Laravel y revisa las redes USDT y USDC.
Pagos USDT con WHMCS: adaptador de prueba y facturas
WHMCS utiliza el adaptador 0.1.0 de prueba para enlaces de facturas pendientes; no es un plugin WordPress. No se ha probado compatibilidad completa entre versiones y no admite débito automático de renovación. Consulta la instalación y la entrada al paquete de prueba.
Activa UUGate en interfaces de pago WHMCS y configura credenciales del servidor y almacenamiento persistente. El callback /modules/gateways/callback/uugate.php se genera desde la URL del sistema WHMCS.
El callback verifica el saldo pendiente actual. Pagos parciales, cancelaciones o cambios de pasarela durante el pago requieren revisión manual. Valida creación del enlace, pago, avisos repetidos y cambios de factura; una simulación no confirma compatibilidad productiva.