guide

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.

Actualizado: 9/3/2026
WordPress QuantaPay Plugin - Connector Settings
WordPress QuantaPay Plugin - Connector Settings

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

Índice de documentos

• 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.