ES
EUR
Volver

VibeFox Windcave for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 8.0 o posterior, instalado y activo. El plugin no se activa sin él.

PHP: 8.0 o posterior.

Cuenta de Windcave: necesitas una cuenta de comerciante de Windcave con credenciales de la API REST: un nombre de usuario de la API y una clave de API. Windcave las emite por separado para el entorno de pruebas UAT (uat.windcave.com) y para producción (sec.windcave.com). Pídelas al soporte de Windcave o a tu gestor de cuenta. Las claves PxPay no funcionan con este plugin. Los métodos de pago que quieras ofrecer (tarjetas, monederos digitales y otros) deben estar habilitados en tu cuenta de Windcave.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_windcave_payment_gateway a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Payments > Windcave > Manage, o haz clic en Settings debajo del 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. Introduce tu nombre de usuario y tu clave de la API REST: las credenciales UAT para el modo de prueba y las de producción para los pagos reales (consulta Configuración).

6. Elige el tipo de transacción y los métodos de pago, activa Enable/Disable y guarda. Haz un pago de prueba con Test mode activado y luego desactiva Test mode para cobrar pagos reales.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Windcave. Mientras el modo de prueba está activado, la página muestra Test mode is on: payments go to the Windcave UAT environment and no real money is taken. En la lista de métodos de pago, Windcave aparece marcado como pendiente de configuración hasta que el modo actual tenga un nombre de usuario y una clave de API. La versión del plugin aparece al final de la página.

General

Enable/Disable: Enable Windcave payments 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: Credit/Debit Card (Windcave).

Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

Introduce las credenciales de la API REST emitidas por Windcave (nombre de usuario y clave de API, no las claves PxPay). Las credenciales de producción y de UAT se pueden guardar una junto a la otra. El modo de prueba usa solo las credenciales UAT, y el modo real solo las de producción.

Test mode: Use the Windcave UAT test environment (uat.windcave.com). No se cobra dinero real. Los pagos nuevos usan las credenciales UAT. Los reembolsos y las capturas siempre se envían al entorno en el que se pagó el pedido. Por defecto: desactivado.

Production API username: el nombre de usuario de la API REST para sec.windcave.com.

Production API key: la clave de la API REST para sec.windcave.com.

UAT API username: el nombre de usuario de la API REST para uat.windcave.com (modo de prueba).

UAT API key: la clave de la API REST para uat.windcave.com (modo de prueba).

Pago

Transaction type: cómo se cobra el pago. Por defecto: Purchase.

Purchase (capture immediately): el dinero se cobra cuando el cliente paga.
Auth (authorise now, capture later): el dinero solo queda reservado. El pedido pasa a En espera, y cobras el dinero con Capture Windcave payment en las acciones del pedido, o lo liberas reembolsando el importe completo. Las autorizaciones no capturadas caducan al cabo de unos días.

Payment methods: los métodos que se muestran en la página de pago de Windcave: Cards, Account2Account (transferencia bancaria de Nueva Zelanda), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Deben estar habilitados en tu cuenta de Windcave. Deja el campo vacío para mostrar todos los métodos habilitados en la cuenta. Por defecto: Cards.

Avanzado

Debug log: Log API requests and payment events. El registro está en WooCommerce > Status > Logs, origen wcp_windcave_payment_gateway. Los errores y las advertencias siempre se registran; esta opción añade las solicitudes a la API y los eventos de pago. Las claves de API, los datos de la tarjeta y los datos personales de los clientes se enmascaran. Por defecto: desactivado.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Los datos de pago guardados en los pedidos (los ID de transacción de Windcave necesarios para los reembolsos) siempre se conservan. Por defecto: desactivado.

URL de notificación

No necesitas configurar una URL de notificación en Windcave. El plugin envía sus direcciones de retorno y su dirección de notificación con cada sesión de pago. Windcave envía la notificación (Fail-Proof Result Notification) a https://your-site/wc-api/windcave_p_notification/. Ni el retorno del cliente ni la notificación van firmados por Windcave, así que el plugin nunca se fía de ellos por sí solos: siempre lee el resultado de la sesión desde la API REST de Windcave, con tus credenciales del entorno en el que se creó la sesión.

Finalización de compra

El cliente elige el método de pago (por defecto Credit/Debit Card (Windcave)) y realiza el pedido. El plugin crea una sesión de pago de Windcave por el total del pedido en la moneda del pedido y envía al cliente a la Windcave Hosted Payment Page. El número de pedido se envía como referencia del comerciante, junto con el idioma de la tienda y el nombre, el correo electrónico, el teléfono y las direcciones de facturación y envío del cliente. En modo de prueba, el bloque de Finalizar compra muestra Test mode: payments go to the Windcave UAT environment, no real money is taken. debajo del método de pago.

Tras pagar, el cliente vuelve a la página de pedido recibido de tu tienda. El pedido se marca como pagado solo cuando Windcave lo confirma: el plugin pide a la API REST de Windcave el resultado de la sesión, tanto cuando el cliente regresa como cuando llega la notificación de Windcave. Un bloqueo por pedido garantiza que el pago se aplique una sola vez. Si el resultado todavía no se conoce, la página de pedido recibido lo vuelve a comprobar una vez y muestra We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again.

Si el cliente vuelve sin haber completado el pago, la página de finalización de compra (o la página Pay for order, si el intento empezó allí) muestra uno de estos mensajes:

Declined: tu pago fue rechazado. Inténtalo de nuevo o elige otro método de pago.
Cancelled or expired: el pago no se completó en la página de Windcave. Tu pedido está guardado: puedes intentarlo de nuevo o elegir otro método de pago.
Not confirmed yet: todavía no hemos podido confirmar tu pago. Si lo completaste, no vuelvas a pagar: recibirás un correo de confirmación en cuanto Windcave lo confirme.
Return could not be processed: no pudimos procesar tu regreso desde la página de pago. Si se te ha cobrado, ponte en contacto con nosotros antes de volver a pagar.

El carrito no se vacía ni se reduce el stock antes de que el cliente pague. Un cliente puede volver a pagar un pedido no pagado, por ejemplo desde la página Pay for order. Un nuevo intento comprueba primero la sesión anterior: si ya está pagada, no se crea un segundo pago; si el cliente nunca usó la página de pago y el pedido no cambió, se le devuelve a la misma página. Si el pago anterior se está confirmando en ese momento, el cliente ve Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again.

Si Windcave no puede iniciar el pago, el cliente ve un mensaje breve: que Windcave no pudo iniciar el pago con los datos de este pedido, o que el servicio de pago no está disponible temporalmente. El motivo se añade a las notas del pedido. Si el modo actual no tiene credenciales, el cliente ve This payment method is not available at the moment. Please choose another payment method or contact us.

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 no tiene suscripciones ni pagos recurrentes, tarjetas guardadas ni formulario de tarjeta integrado en tu sitio (el cliente siempre paga en la página de Windcave), no admite la API PxPay 2.0 y no añade recargos. Si Windcave añade un recargo, el pedido se compara con la transacción principal.

Pedidos y reembolsos

Estados del pedido

Pending payment: el cliente fue enviado a Windcave y todavía no ha pagado, o Windcave aún no ha confirmado el pago. Si el cliente cancela o la sesión caduca, el pedido sigue como Pendiente de pago y se añade una nota.

Processing or Completed: se confirmó un pago de tipo Purchase. WooCommerce establece En curso, o Completado para los pedidos que no requieren envío, como de costumbre. La nota del pedido muestra el importe, el ID de transacción de Windcave, el código de autorización, el tipo de tarjeta con el número enmascarado y el entorno (UAT o producción). El ID de transacción del pedido es el ID de transacción de Windcave.

On hold (authorised): se aprobó un pago Auth, pero todavía no se ha capturado. La nota del pedido explica cómo capturarlo o liberarlo.

On hold (does not match): Windcave informó de un importe, moneda, referencia del comerciante o tipo de transacción distinto al del pedido (por ejemplo, el pedido se editó después de iniciar el pago). La nota enumera las diferencias. Revisa el pago en Windcave Payline antes de enviar el pedido y reembólsalo si es necesario.

Failed: el pago fue rechazado. La nota muestra el texto y el código de respuesta de Windcave. El cliente puede volver a intentarlo.

Si llega un pago aprobado para un pedido cancelado, o un segundo pago aprobado para un pedido que ya está pagado, el pedido no cambia. Una nota con el ID de transacción te pide que lo reembolses en Windcave Payline (o que restaures el pedido cancelado manualmente).

Captura (modo Auth)

Abre el pedido, elige Capture Windcave payment en las acciones del pedido y haz clic en el botón de actualizar. La acción aparece solo en un pedido En espera con una autorización que todavía no se ha capturado ni liberado. Se captura el importe total del pedido, la captura se añade a las notas del pedido y el pedido pasa a ser un pedido pagado (normalmente En curso). Si Windcave no acepta la captura, la pantalla del pedido muestra Windcave capture failed: con el motivo, y el motivo se añade a las notas del pedido.

Reembolsos

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Windcave. Se admiten reembolsos totales y parciales. El reembolso se envía al entorno (UAT o producción) y a la cuenta en la que se realizó el pago, por lo que deben estar guardadas las credenciales de ese entorno. Un reembolso correcto se añade a las notas del pedido con el ID de transacción de Windcave.

En un pago Auth que no se ha capturado, solo es posible un reembolso total: libera (anula) la autorización. Un importe parcial genera un error que te pide reembolsar el importe completo o capturar primero el pago.

Si Windcave rechaza el reembolso, WooCommerce muestra Windcave declined the refund: con el motivo, y el reembolso no se registra. Si Windcave todavía está procesando el reembolso, WooCommerce muestra Windcave has not confirmed the refund yet. See the order notes. y el reembolso no se registra. Revisa la transacción en Windcave Payline: si se aprobó, registra el reembolso manualmente; si no, inténtalo de nuevo. Un intento repetido del mismo reembolso no se envía dos veces a Windcave. Los reembolsos hechos en Windcave Payline no se comunican a la tienda.

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 > Windcave. 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 quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un dominio. Quitar la clave de un sitio no libera la plaza del dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Windcave no se muestra a los clientes en la finalización de compra. Si un pago se inicia de todos modos, 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 los reembolsos y las capturas funcionan.

Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Windcave does not appear at checkout: comprueba que la licencia está activa, que Enable/Disable está activado y que el modo actual tiene ambas credenciales: UAT API username y UAT API key en modo de prueba, o Production API username y Production API key en modo real.

The payment went through, but the order stays Pending payment: el plugin todavía no pudo obtener el resultado de Windcave. Abre las notas del pedido: una nota indica cuándo no se pudo verificar la sesión y por qué. Comprueba que las credenciales del entorno del pago están guardadas y son correctas. La comprobación se repite cuando Windcave vuelve a enviar la notificación (el plugin responde con un error hasta que el resultado se pueda verificar, para que Windcave lo reintente) y cuando el cliente abre la página de pedido recibido. Tu servidor debe aceptar las solicitudes de Windcave a https://your-site/wc-api/windcave_p_notification/.

Authentication failed in the order notes or the log: el nombre de usuario o la clave de la API REST son incorrectos, o pertenecen al otro entorno. Las credenciales UAT solo funcionan en modo de prueba, y las de producción solo en modo real. Las claves PxPay no funcionan.

The customer sees that Windcave could not start the payment with the details of this order: Windcave rechazó la solicitud de sesión, por ejemplo por la moneda o por un método de pago que no está habilitado en tu cuenta. El motivo exacto está en las notas del pedido y en el registro.

Order is On hold after payment: lee la nota del pedido. O bien el pago es un Auth que espera la captura, o bien el importe pagado, la moneda o la referencia del comerciante no coincidían con el pedido. Captura, procesa o reembolsa el pago.

Test payments and live payments: UAT y producción están separados. Cada sesión se comprueba en el entorno en el que se creó, y los reembolsos y las capturas se envían al entorno del pago, aunque cambies Test mode más tarde. Los pedidos creados con la versión 1.0 del plugin usan el entorno del antiguo ajuste API URL.

Refund fails with a message about the environment: el pago se realizó en UAT o en producción, y no hay credenciales guardadas para ese entorno. Introdúcelas y vuelve a intentarlo.

Capture Windcave payment is missing in the order actions: la acción solo se muestra en pedidos En espera pagados con Auth que todavía no se han capturado ni liberado.

Where to find details: los errores y las advertencias siempre se escriben en WooCommerce > Status > Logs, origen wcp_windcave_payment_gateway. Activa Debug log para registrar también las solicitudes a la API y los eventos de pago.

The license block shows an 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 la dirección del sitio cambió, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede acceder al 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, las opciones del plugin y los registros (archivos de registro, incluidos los rotados, y las entradas de registro de la base de datos) solo se eliminan si Clean uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y los ID de transacción de Windcave.

Windcave es una marca comercial de su respectivo titular. Este plugin no está afiliado a Windcave ni cuenta con su aprobación.