Guía de integración del plugin de WordPress
Instala, configura y soluciona problemas del plugin de pago QuantaPay para WooCommerce y Easy Digital Downloads.
Descripción general
El plugin de pago QuantaPay enWordPress.orgañade una pasarela cripto sin custodia a WooCommerce (pago clásico, Blocks, HPOS) y Easy Digital Downloads. Utilice este documento para tener cada paso en un solo lugar en lugar de saltar entre archivos de preguntas frecuentes/Readme.
Requisitos
• WordPress 5.8+ con WooCommerce 6.0+ o EDD 3.0+, PHP 7.4+ (se recomienda 8.x).
• Acceso HTTPS saliente a cloud.quantapay.app para la verificación de API + Webhook.
• Área de trabajo activa de QuantaPay Cloud con clave API y secreto de Webhook.
• Capacidad de permitir solicitudes a https://yoursite.com/wp-json/quantapay/webhook a través de WAF/Cloudflare.
Instalar el plugin
1) Descargue el zip más reciente de WordPress.org o de su compilación interna.
2) En el administrador de WordPress, vaya a Plugins → Añadir nuevo → Subir plugin y suba quantapay-payment.zip.
3) Active "QuantaPay Payment". Aparecerá una nueva pantalla de Ajustes → QuantaPay para las credenciales.
Configurar las credenciales y el pago
• AbraAjustes → QuantaPayy pegue la clave API de Cloud + el secreto de Webhook, luego guarde. La página muestra la URL de Webhook generada (https://yourdomain.com/wp-json/quantapay/webhook).
• WooCommerce: vaya aWooCommerce → Ajustes → Pagos → QuantaPay(o Pagos → Administrar en la nueva interfaz de usuario) y active "Habilitar". Elija el título/descripción del pago y la moneda predeterminada.
• Configuración rápida: aún en Ajustes → QuantaPay puede sincronizar las direcciones de los monederos, la redirección de agradecimiento, la copia de pago localizada y la preferencia de registro sin editar PHP.
• Easy Digital Downloads: active la pasarela enDownloads → Ajustes → Pasarelas de pago → QuantaPaypara exponerla en los formularios de pago de EDD.
Lista de verificación de Webhook y Firewall
1) En QuantaPay Cloud, vaya a Ajustes → Webhooks y pegue el endpoint de WordPress que se muestra en el plugin. Haga clic en "Verificar secreto" para almacenar la firma.
2) Si ejecuta Cloudflare u otro WAF, cree una regla: Nombre de host es igual a yourdomain.com Y URI contiene /wp-json/quantapay, acción Permitir/Omitir. Opcionalmente, filtre por el agente de usuario o el encabezado de firma de QuantaPay-Webhook.
3) Mantenga el sitio fuera del modo "Estoy bajo ataque" para ese endpoint para que las devoluciones de llamada firmadas lleguen a WordPress antes de que el plugin las valide.
Pruebas y resolución de problemas
• Realice un pedido de prueba de 1 $ en WooCommerce o EDD y elija QuantaPay. Confirme que la página alojada muestra la misma moneda e importe.
• En QuantaPay Cloud, marque la factura como pagada o envíe una transferencia cripto real; WordPress debería mover el pedido de Pendiente a En proceso/Completado con el hash de blockchain almacenado en las notas del pedido.
• Si los pedidos no se actualizan, compruebe la clave API/secreto de Webhook de Cloud, confirme que Cloudflare permite el endpoint y revise wp-content/uploads/quantapay/quantapay-debug.log (solo active el registro durante las pruebas; los secretos se redactan).
• Utilice el botón "Probar API de Cloud" dentro de Ajustes → QuantaPay para confirmar las credenciales y actualizar las instantáneas del monedero sin crear un nuevo pedido.
Eliminación o reinstalación
Desactivar el plugin mantiene la configuración para más adelante. Elegir Eliminar elimina las opciones almacenadas y las preferencias de registro, pero nunca toca los pedidos de WooCommerce o EDD. Siempre haga una copia de seguridad antes de reemplazar el conector en producción.
Enlaces útiles
•Descarga / registro de cambios en WordPress.org
•Panel de control de QuantaPay Cloud
• Soporte:[email protected]
¿Necesita ayuda?
¿Necesita ayuda? Envíe un correo electrónico a[email protected]y mencione la URL del sitio y el ID del pedido.