Guía de integración del plugin QuantaPay para WordPress
Cómo instalar, configurar y depurar el gateway cripto QuantaPay en WooCommerce y Easy Digital Downloads.
Resumen
El plugin QuantaPay disponible en WordPress.org añade pagos cripto no custodiados a WooCommerce (checkout clásico, Blocks, HPOS) y EDD. Este documento reúne requisitos, instalación y resolución de problemas.
Requisitos
• WordPress 5.8+, WooCommerce 6.0+ o EDD 3.0+, PHP 7.4+ (ideal 8.x).
• Salida HTTPS hacia cloud.quantapay.app.
• Cuenta de QuantaPay Cloud con API Key y Webhook Secret.
• Permitir https://tusitio.com/wp-json/quantapay/webhook en el WAF/Cloudflare.
Instalación
1) Descarga el zip más reciente.
2) Plugins → Añadir nuevo → Subir plugin → instala quantapay-payment.zip.
3) Activa “QuantaPay Payment” para ver el menú Ajustes → QuantaPay.
Configura credenciales y checkout
• Ajustes → QuantaPay: pega API Key + Webhook Secret y guarda. Copia la URL de webhook generada.
• WooCommerce → Ajustes → Pagos → QuantaPay: habilita el método, define título/descripcion y moneda.
• Quick Config: ajusta wallets, redirección y mensajes sin editar código.
• Easy Digital Downloads → Settings → Payment Gateways → QuantaPay: activa para mostrarlo en EDD.
Webhook y firewall
1) En QuantaPay Cloud → Settings → Webhooks pega la URL de WordPress y guarda el secret.
2) Crea una regla en Cloudflare/WAF (Hostname + URI) para Allow/Bypass y opcionalmente filtra por “QuantaPay-Webhook”.
3) Evita modo “I’m Under Attack” en esa ruta para que el callback llegue antes de la verificación.
Pruebas y solución de problemas
• Genera un pedido de prueba de 1 USD en WooCommerce/EDD y selecciona QuantaPay.
• Marca la factura como pagada en Cloud o realiza un pago real; el pedido debe pasar a Processing/Completed con el hash guardado.
• Si no se actualiza, revisa API Key/Webhook Secret, la regla de Cloudflare y el log wp-content/uploads/quantapay/quantapay-debug.log.
• Usa “Test Cloud API” en Ajustes → QuantaPay para validar credenciales y actualizar wallets.
Recursos
• Soporte
Ayuda adicional
Para soporte adicional escribe a [email protected].