VibeFox Quickpay for WooCommerce — Ayuda
Requisitos
WordPress: 6.2 o posterior.
WooCommerce: 7.1 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Cuenta de Quickpay: necesitas dos valores del panel de Quickpay: la clave de API de un usuario de API (para crear pagos, cobrar y reembolsar) y la clave privada de la cuenta (para comprobar la firma de los callbacks de Quickpay). No hay que configurar nada más en Quickpay. Tu sitio debe ser accesible desde internet, sin contraseña ni modo de mantenimiento, para que los callbacks de Quickpay puedan llegar.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta wcp_quickpay_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > Quickpay > Manage, o haz clic en Settings bajo el nombre del plugin en la página Plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.
5. Pega la clave de API y la clave privada del panel de Quickpay y haz clic en Test API key (ver Configuración).
6. Elige el modo de cobro y el estado del pedido tras el pago, activa Enable/Disable y guarda. Mientras tu cuenta de Quickpay esté en modo de prueba, activa Test payments y haz un pago con una tarjeta de prueba de Quickpay.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Quickpay. Mientras no se introduzcan la clave de API y la clave privada, Quickpay aparece marcado como pendiente de configuración en la lista de métodos de pago y se oculta en la finalización de compra, porque no se podría crear ni confirmar un pago.
General
Enable/Disable: Enable Quickpay activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que ven los clientes en la finalización de compra. Por defecto: Quickpay.
Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay securely by card or MobilePay on the Quickpay payment page.
Credenciales de la API de Quickpay
En el panel de Quickpay (manage.quickpay.net) abre Settings > Integration. Copia la clave de API de un usuario de API (Settings > Users) y la clave privada de la cuenta. La sección también muestra la URL de callback de tu tienda, que tiene el formato https://your-site/wc-api/qpg_quickpay/. Se envía automáticamente con cada pago, así que no hay que configurar nada en Quickpay.
API key: la clave de API de un usuario de API de Quickpay. Se usa para crear pagos, cobrar y reembolsar.
Debajo del campo, el botón Test API key comprueba la clave escrita en el campo (o la guardada, si el campo está vacío) mediante una petición autenticada a Quickpay. Responde Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. o Connection failed: seguido del motivo.
Private key: la clave privada de la cuenta. Se usa para comprobar la firma (HMAC-SHA256) de los callbacks de Quickpay. Sin ella no se puede confirmar ningún pago, y los callbacks se rechazan.
Test payments: Accept payments made with Quickpay test cards. Quickpay no tiene un sandbox independiente: mientras tu cuenta de Quickpay esté en modo de prueba, los pagos se hacen con tarjetas de prueba y se marcan como de prueba. Actívalo solo durante las pruebas. Cuando está desactivado, un pago de prueba nunca marca un pedido como pagado, y el pedido recibe una nota en su lugar. Cuando está activado, la finalización de compra muestra Test mode: Quickpay test cards are accepted. Por defecto: desactivado.
Pago
Capture: cuándo se cobra el dinero de la tarjeta.
Order status after payment: el estado del pedido una vez que Quickpay ha confirmado el pago cobrado. El estado se establece de una vez, con un único cambio de estado y un único envío de correos.
Avanzado
Debug log: Enable logging. El registro está en WooCommerce > Status > Logs, origen wcp_quickpay_gateway. Los errores y advertencias, como los callbacks rechazados y los errores de la API de Quickpay, siempre se registran. Actívalo para registrar también cada petición y callback. Las claves de API, los datos de tarjeta y los datos de los clientes nunca se registran. Por defecto: desactivado.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Desactivar el plugin nunca borra nada. Los datos de los pedidos (ID de pago de Quickpay, notas) siempre se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Quickpay, mostrado con los iconos de Visa y Mastercard) y realiza el pedido. El plugin crea un pago de Quickpay para el pedido en la moneda del pedido y un enlace de pago por el total del pedido, y envía al cliente a la ventana de pago de Quickpay. El cliente paga allí con uno de los métodos activados en tu ventana de pago de Quickpay. El correo electrónico de facturación se pasa a Quickpay. La ventana de pago se abre en el idioma de tu sitio cuando Quickpay lo ofrece (danés, alemán, inglés, español, finés, francés, italiano, neerlandés, noruego, polaco, sueco), y si no, en inglés.
Tras pagar, el cliente vuelve a la página de pedido recibido de tu tienda. El retorno en sí no marca nada como pagado. El pedido solo se marca como pagado cuando Quickpay lo confirma con el callback firmado y el importe y la moneda coinciden con el pedido. Con Authorize only, el pedido pasa a En espera en su lugar, y cobras el pago más tarde.
Si el cliente cancela en la ventana de pago durante la finalización de compra, el pedido no pagado se cancela de la forma estándar de WooCommerce y el carrito se restaura. En la página Pay for order, al cancelar el cliente vuelve a esa página, así que el pedido sigue siendo pagable. Un pago fallido o cancelado puede volver a intentarse: el nuevo intento reutiliza el pago de Quickpay del pedido con un enlace nuevo, así que un enlace antiguo nunca puede pagarse en paralelo. Cuando se cancela un pedido no pagado, su enlace de pago se elimina en Quickpay.
Si no se puede iniciar el pago, el cliente ve The Quickpay payment could not be started. Please try again or choose another payment method. El motivo técnico se añade a las notas del pedido y al registro. Si faltan las claves, el cliente ve Quickpay is not available at the moment. Please choose another payment method.
El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin solo admite pagos únicos. No tiene suscripciones ni pagos recurrentes, ni tarjetas guardadas, ni comisiones de pago, no envía la cesta ni las líneas de factura a Quickpay, y no tiene métodos separados de MobilePay, Apple Pay o Klarna: el cliente elige entre los métodos de tu ventana de pago de Quickpay.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a Quickpay y aún no ha pagado. Con cobro automático, un pago autorizado a la espera de cobro se anota en el pedido.
Processing or Completed: Quickpay confirmó el pago cobrado con el importe y la moneda correctos. El estado sigue a Order status after payment. La nota del pedido muestra el ID de pago de Quickpay (marcado como TEST en los pagos de prueba), y se guarda como ID de transacción del pedido.
On hold: el pago solo está autorizado y espera a Capture Quickpay payment; o Quickpay informó de un importe o una moneda distintos del total del pedido (por ejemplo, el pedido se editó después de iniciar el pago, o se cobró un importe diferente en el panel de Quickpay); o el cobro falló y el importe sigue solo reservado. La nota del pedido lo explica, también cuando el pedido ya estaba En espera.
Failed: el intento de pago fue rechazado. El cliente puede volver a pagar.
Cancelled: el cliente canceló en la ventana de pago, el pedido fue cancelado por ti o por el tiempo de espera de reserva de stock de WooCommerce, o el pago se canceló en el panel de Quickpay.
Un pago que llega para un pedido que ya está pagado, cancelado o reembolsado no cambia el pedido. Una nota te pide que revises el pago en el panel de Quickpay, por ejemplo para reembolsar un pago doble.
Cobro
Con Authorize only, abre el pedido, elige Capture Quickpay payment en las acciones del pedido y haz clic en el botón de actualizar. Se cobra el total del pedido; el cobro parcial no está disponible. Si Quickpay confirma de inmediato, el pedido se marca como pagado. Si no, una nota indica que se solicitó el cobro, y el pedido se marca como pagado cuando el callback de Quickpay lo confirma. Un cobro rechazado se muestra en la pantalla del pedido y se anota en el pedido.
Cancelar un pedido autorizado no libera automáticamente el importe reservado. La nota del pedido te recuerda que canceles el pago en el panel de Quickpay; si no, la reserva termina cuando caduca la autorización.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Quickpay. Se admiten reembolsos totales y parciales de pagos cobrados. Quickpay procesa los reembolsos de forma asíncrona: una nota indica que se solicitó el reembolso, y el callback añade el resultado final, confirmed o FAILED con el motivo. Si Quickpay rechaza el reembolso de inmediato, WooCommerce muestra el error y no se registra ningún reembolso. Un pago autorizado que nunca se cobró no puede reembolsarse; cancélalo en el panel de Quickpay.
Los pagos y reembolsos hechos directamente en el panel de Quickpay solo se anotan en el pedido. No se registran automáticamente como reembolsos de WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce sin usar Refund via Quickpay.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Quickpay. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un solo dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, Quickpay no se muestra a los clientes en la finalización de compra. Si de todos modos se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda que han iniciado sesión siguen viendo el método de pago, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio en la página Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose, y el cobro y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Quickpay no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que se hayan introducido API key y Private key. Sin ambas claves, el método se oculta.
El pago se realizó, pero el pedido sigue en Pending payment: el callback de Quickpay no llegó a tu tienda o fue rechazado. Comprueba que tu sitio sea accesible desde internet (sin protección con contraseña ni modo de mantenimiento) y que Private key sea la clave privada de la misma cuenta de Quickpay. Los callbacks rechazados se escriben siempre en WooCommerce > Status > Logs, origen wcp_quickpay_gateway. Activa Debug log para ver cada callback.
El registro muestra Callback rejected: invalid checksum.: la clave privada de los ajustes no pertenece a la cuenta que envió el callback. Cópiala de nuevo desde Settings > Integration en el panel de Quickpay.
El registro muestra Callback rejected: the private key is not configured.: introduce la clave privada. Los callbacks nunca se aceptan sin ella.
El registro muestra Callback: no order found for payment …: el callback pertenece a un pago de Quickpay que ningún pedido de esta tienda conoce, por ejemplo un pago creado fuera de WooCommerce o para un pedido eliminado.
El registro muestra Callback: order #… is locked by another request.: en ese momento se estaba aplicando otro callback del mismo pedido. El callback recibe una respuesta de error, así que no se considera gestionado. Si el pedido sigue sin cambios, revisa el pago en el panel de Quickpay.
Un pago de prueba no marcó el pedido como pagado: Test payments está desactivado. La nota del pedido indica que el pago de prueba no fue aceptado. Activa el ajuste mientras pruebas, y desactívalo cuando tu cuenta pase a producción.
El pedido está On hold tras el pago: lee la nota del pedido. Es posible que el pago solo esté autorizado y espere a Capture Quickpay payment, que el importe o la moneda pagados no coincidan con el pedido, o que el cobro haya fallado. Cobra, completa el envío del pedido o reembolsa el pago en el panel de Quickpay.
Test API key says Quickpay rejected the API key.: la clave es incorrecta o pertenece a un usuario sin acceso a la API. Copia la clave de API de un usuario de API desde el panel de Quickpay.
El cliente ve The Quickpay payment could not be started.: abre las notas del pedido o el registro. La nota muestra el error de Quickpay, por ejemplo una moneda que tu cuenta de Quickpay no acepta.
El reembolso falla: el pedido debe tener un pago de Quickpay cobrado. El mensaje The Quickpay payment of this order has not been captured — there is nothing to refund. significa que el pago solo está autorizado; cancélalo en el panel de Quickpay en su lugar.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros del plugin (archivos de registro, incluidos los rotados, y las entradas de registro de la base de datos) solo se eliminan si Delete data estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago e ID de transacción.
Quickpay es una marca comercial de su respectivo titular. Este plugin no está afiliado a Quickpay ni cuenta con su respaldo.