guide

WordPress / WooCommerce

Acepta pagos con criptomonedas en tu tienda WooCommerce utilizando el plugin oficial de QuantaPay Payment.

Actualizado: 9/3/2026

Acepta pagos en criptomonedas en tu tienda WooCommerce utilizando el plugin oficial de QuantaPay Payment.

WooCommerce Payment Gateway - QuantaPay settings
WooCommerce Payment Gateway - QuantaPay settings

Requisitos

  • WordPress 5.8+
  • WooCommerce (cualquier versión reciente)
  • PHP 7.4+ (se recomienda PHP 8.x)
  • Una cuenta de QuantaPay Cloud (cloud.quantapay.app)

Instalación

Desde el directorio de plugins de WordPress

  1. Ir aPlugins → Añadir nuevoen tu administrador de WordPress.
  2. Busca"QuantaPay Payment".
  3. Haz clic enInstalar ahora, luego enActivar.

Instalación manual

  1. Descarga el plugin desdewordpress.org/plugins/quantapay-payment.
  2. Sube la carpetaquantapay-paymenta/wp-content/plugins/.
  3. Activa el plugin enPlugins → Plugins instalados.

Configuración

Paso 1: Obtén tus credenciales

Desde tu panel de control de QuantaPay Cloud:

  1. API Key— Se encuentra enSettings → Account
  2. Webhook Secret Key— Se encuentra enSettings → Payments → Webhook

Paso 2: Introduce las credenciales en WordPress

  1. Navega al menúQuantaPayen la barra lateral de WordPress.
  2. Pega tuClave API de la nubeyWebhook Secret Key.
  3. Guardar ajustes.

Paso 3: Configurar la URL del webhook

  1. El plugin genera una URL de webhook:https://yoursite.com/wp-json/quantapay/webhook
  2. Copie esta URL y péguela enCloud → Ajustes → Pagos → URL del webhook.

Paso 4: Activar la pasarela de pago

Ir aWooCommerce → Ajustes → Pagos → QuantaPayy actívela.

Ajustes de WooCommerce

El plugin añade ajustes directamente en la página de Pagos de WooCommerce:

CampoDescripciónPredeterminado
Activar/DesactivarActivar o desactivar QuantaPay.Activado
Clave API de la nubeSu clave API de QuantaPay Cloud.
Webhook Secret KeySu clave secreta de webhook de QuantaPay.
Nombre de la opción de pagoEtiqueta que se muestra a los clientes al finalizar la compra."Pagar con criptomonedas"
Descripción de la opción de pagoTexto de ayuda debajo del título del pago."BTC · ETH · USDT · USDC · BNB — más de 30 criptomonedas adicionales."

Configuración rápida

El menúQuantaPaylateral proporciona una pestaña de configuración rápida donde puede gestionar:

  • Direcciones de monederos
  • Moneda predeterminada
  • URL de redireccionamiento de agradecimiento
  • Texto/mensajes de pago

Los cambios realizados aquí se sincronizan con la configuración de su QuantaPay Cloud.

Soporte de pago en bloque

El plugin es totalmente compatible con el pago en bloque de WooCommerce (el nuevo pago basado en React). Tanto el pago clásico como el pago en bloque comparten la misma configuración y muestran la tira de iconos de criptomonedas (BTC, ETH, USDT, USDC, BNB).

Flujo de pago

  1. El cliente selecciona "Pagar con criptomonedas" al finalizar la compra.
  2. WooCommerce crea el pedido y llama a la API de sesión de pago de QuantaPay.
  3. El cliente es redirigido a la página de pago de QuantaPay.
  4. El cliente selecciona la criptomoneda, escanea el código QR y envía el pago.
  5. Después de la confirmación en la blockchain, QuantaPay envía un webhook a su sitio de WordPress.
  6. El plugin actualiza el estado del pedido de WooCommerce a "Procesando" o "Completado".
  7. El cliente es redirigido a la página de agradecimiento de WooCommerce.

Sincronización del panel

Desde la página de administración de QuantaPay en WordPress, puede:

  • Ver los saldos de su billetera
  • Examinar las 100 transacciones más recientes
  • Consultar los registros de depuración
  • Ver notificaciones de pagos insuficientes y facturas vencidas

Seguridad

  • Los webhooks se verifican utilizando la firma de clave secreta compartida.
  • Los ajustes confidenciales (claves de API) se cifran en reposo.
  • Las firmas HMAC-SHA256 protegen la creación de la sesión de pago contra la manipulación.
  • Los registros de depuración redactan automáticamente los secretos.

Configuración de Cloudflare / WAF

Si su sitio está detrás de Cloudflare u otro WAF, permita el punto final del webhook:

  1. Cree una regla de Firewall/WAF que coincida conURI contiene /wp-json/quantapay.
  2. Establezca la acción enPermitiroOmitir seguridad.
  3. Asegúrese de que el nivel de seguridad no esté establecido en "Estoy bajo ataque" para esa URL.

Idiomas admitidos

El plugin se distribuye con traducciones para 9 idiomas:

  • Inglés, chino (simplificado), español, portugués (brasileño), ruso, francés, japonés, coreano, alemán

Precios

QuantaPay cobra una tarifa plana de0.8% por cada pago criptográfico exitoso. Sin cuotas mensuales ni cargos por retiro.