VibeFox GoPay for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.6 o posterior, instalado y activo. El plugin se niega a activarse sin él.
PHP: 8.0 o posterior.
Moneda: GoPay acepta CZK, EUR, PLN, USD, GBP, HUF, RON y BGN. Con otra moneda, el método de pago se oculta en la finalización de compra.
Cuenta de GoPay: necesitas el GoID, Client ID y Client Secret de tu cuenta de comerciante de GoPay. Están en los ajustes de integración de la cuenta. La cuenta sandbox (de prueba) tiene sus propias credenciales. No hace falta configurar nada en la cuenta de GoPay para las notificaciones, pero tu tienda debe estar accesible desde Internet.
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_gopay_gateway a /wp-content/plugins/ mediante FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > GoPay > 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 situado en la parte superior de la página y haz clic en Activate.
5. Introduce el GoID, Client ID y Client Secret de sandbox, deja activado Test Mode y activa Enable/Disable.
6. Realiza un pedido de prueba. Cuando todo funcione, introduce las credenciales de producción y desmarca Test Mode.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > GoPay. Debajo de la descripción de la pasarela, la página muestra Sandbox mode — test payments only o Production mode — real payments. Te avisa si falta el GoID, el Client ID o el Client Secret del modo actual, o si GoPay no acepta la moneda de la tienda. En ambos casos, GoPay no se ofrece en la finalización de compra. En la lista de métodos de pago, la pasarela aparece como pendiente de configuración hasta que el modo actual tenga sus credenciales. Al guardar, se borran los tokens de acceso de GoPay almacenados en caché, por lo que las nuevas credenciales se usan de inmediato.
Enable/Disable: Enable GoPay payment gateway activa o desactiva el método de pago. Predeterminado: desactivado.
Title: título del método de pago que se muestra durante la finalización de compra. Predeterminado: GoPay.
Description: descripción del método de pago que se muestra durante la finalización de compra. Predeterminado: Pay securely via GoPay - cards, wallets, bank transfers.
Credenciales de API
El GoID, Client ID y Client Secret se muestran en tu cuenta de comerciante de GoPay (ajustes de integración). La cuenta sandbox (de prueba) tiene sus propias credenciales. La documentación de la API está en doc.gopay.com.
Test Mode: Enable sandbox/test mode envía los pagos a gw.sandbox.gopay.com con las credenciales de sandbox. No se cobra dinero real. Desmárcalo para aceptar pagos reales con las credenciales de producción (gate.gopay.cz). Predeterminado: activado.
Sandbox GoID: el GoID de tu cuenta sandbox (de prueba) de GoPay.
Sandbox Client ID: el OAuth Client ID de la cuenta sandbox.
Sandbox Client Secret: el OAuth Client Secret de la cuenta sandbox.
Production GoID: tu ID de comerciante de GoPay (GoID).
Production Client ID: el OAuth Client ID de GoPay.
Production Client Secret: el OAuth Client Secret de GoPay.
Un GoID solo contiene dígitos, por ejemplo, 8123456789. Si introduces otro tipo de valor, la página muestra un error y conserva el valor anterior.
Pago
Payment Page Language: idioma de la página de pago de GoPay. Predeterminado: Automatic (site language, then billing country). El modo automático usa el idioma de tu sitio; si GoPay no lo ofrece, se usa el país de facturación y, en su defecto, el inglés. También puedes fijar uno de 19 idiomas: checo, inglés, eslovaco, alemán, polaco, húngaro, rumano, búlgaro, croata, esloveno, estonio, letón, lituano, francés, italiano, español, portugués, ucraniano o ruso.
Order Status After Payment: estado del pedido que se establece cuando se confirma el pago. Se establece de inmediato, con un solo cambio de estado y un correo electrónico al cliente.
Notificaciones de pago
La notificación informa a tu tienda de que se ha realizado un pago. La URL de notificación se envía a GoPay con cada pago, por lo que no hace falta configurar nada en la cuenta de GoPay. Los ajustes muestran la URL. Tiene un aspecto parecido a https://your-site/?gopay-api=gopay_payment_notification. Debe ser accesible desde Internet: sin protección con contraseña, modo de mantenimiento ni cortafuegos delante.
Las notificaciones de GoPay solo incluyen el ID del pago, sin firma. Cada notificación se verifica consultando el estado del pago en la API de GoPay, y el pago debe ser uno que el plugin haya creado para un pedido de tu tienda. Si no se puede consultar el estado en GoPay, tu tienda responde con un error y GoPay repite la notificación. Sin notificaciones, el pedido solo se confirma cuando el cliente vuelve a la tienda después de pagar.
Avanzado
Logging: Enable logging escribe los eventos de GoPay en WooCommerce > Status > Logs, con el origen wcp_gopay_gateway. Los errores siempre se registran. Nunca se registran credenciales, tokens, datos de tarjetas ni el correo electrónico, teléfono o dirección del cliente. Predeterminado: desactivado.
Delete Data on Uninstall: Delete plugin settings, cached access tokens and log files when uninstalled. Si está activado, al borrar el plugin se eliminan los ajustes de la pasarela, los tokens de acceso de GoPay almacenados en caché y los registros. Predeterminado: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto, GoPay) y realiza el pedido. El plugin crea un pago de GoPay por el total del pedido en la moneda del pedido, con los artículos, el envío y las tarifas, y envía al cliente a la página de pago de GoPay. Allí GoPay ofrece los métodos habilitados en tu cuenta, como tarjetas de pago, Apple Pay, Google Pay y transferencias bancarias. Se envían a GoPay el nombre de facturación, el correo electrónico, el teléfono y la dirección del cliente; los campos vacíos no se envían. En GoPay, el pago aparece como Order seguido del número de pedido.
Después de pagar, el cliente vuelve a tu tienda. El pedido solo se marca como pagado cuando GoPay lo confirma: mediante la notificación o una consulta a la API de GoPay cuando vuelve el cliente. Si una notificación y el retorno llegan a la vez, se procesan uno después del otro, así que el pedido nunca se completa dos veces. Cuando se confirma el pago, el cliente llega a la página de pedido recibido.
Si el pago no se completó, se canceló o caducó, el cliente llega a la página Pay for order con el mensaje The GoPay payment was not completed. You can try again or choose another payment method. o The GoPay payment was cancelled or has expired. You can try again or choose another payment method. Desde esa página, el cliente puede volver a pagar un pedido pendiente de pago. Si el pedido ya está pagado, no se crea un segundo pago de GoPay.
Si GoPay no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo, GoPay could not accept the payment details. Please check your billing details (e-mail, phone, address) or choose another payment method. o GoPay is temporarily unavailable. Please try again in a moment or choose another payment method. El motivo técnico se añade a las notas del pedido.
El método de pago funciona en la finalización de compra clásica, en los bloques Cart y Checkout y en la página Pay for order. En modo sandbox, el bloque Checkout muestra Sandbox mode: no real payment will be made. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El cliente elige el método de pago en la página de GoPay; no se puede elegir en WooCommerce. El plugin no ofrece suscripciones ni pagos periódicos, tarjetas guardadas, un formulario de pago integrado ni la captura o anulación de preautorizaciones desde WooCommerce.
Pedidos y reembolsos
Estados del pedido
Pending payment: se envió al cliente a GoPay y todavía no ha pagado, o GoPay aún no ha confirmado el pago.
Processing or Completed: se confirmó el pago. El estado sigue el valor de Order Status After Payment. La nota del pedido muestra el ID del pago de GoPay y el instrumento de pago. El ID de transacción es el ID del pago de GoPay.
On hold: GoPay confirmó el pago, pero el importe o la moneda difieren de los del pedido; el pago llegó después de que se cancelara el pedido; o el pago solo está preautorizado y aún no se han capturado los fondos. La nota del pedido explica el motivo. Hay que capturar en GoPay un pago preautorizado y después completar el pedido manualmente.
Failed: el último pago de GoPay de un pedido pendiente de pago se canceló o caducó.
Refunded: se reembolsó por completo el pago de GoPay del pedido, por ejemplo, desde la cuenta de GoPay.
Si también se paga otro intento de pago de un pedido que ya estaba pagado, el pedido no cambia. Se añade una nota para que reembolses el duplicado desde la cuenta de GoPay. También se añade una nota similar cuando se paga con GoPay un pedido que ya se había marcado como pagado sin GoPay, por ejemplo, manualmente. Una notificación posterior nunca vuelve a abrir un pedido pagado que hayas cancelado o reembolsado.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via GoPay. Se admiten reembolsos totales y parciales. GoPay solo acepta reembolsos parciales cuando han transcurrido 24 horas desde el pago. El reembolso se envía en el modo en que se realizó el pago (sandbox o producción), por lo que deben estar configuradas las credenciales de ese modo. Si GoPay rechaza el reembolso, WooCommerce muestra el mensaje de GoPay y no registra ningún reembolso. Los reembolsos realizados correctamente se añaden a las notas del pedido. También se anota como aceptado un reembolso que GoPay haya aceptado para procesarlo más tarde.
Los reembolsos realizados desde la cuenta de GoPay llegan mediante una notificación. Un reembolso total cambia el estado del pedido a «Reembolsado»; uno parcial añade una nota. No se registran automáticamente como reembolsos de WooCommerce.
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 > GoPay. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo, la fecha hasta la que está activa la licencia 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. Al quitar la clave de un sitio no se libera el cupo de dominio. Libera el cupo desde tu cuenta de vibefox.net.
Sin una clave activa, GoPay no se muestra a los clientes durante la finalización de compra. Si aun así se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Los administradores de la tienda que hayan 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 se siguen confirmando y los reembolsos funcionan.
Cuando caduca una licencia, el plugin sigue funcionando, pero para recibir actualizaciones y soporte hay que renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
GoPay no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el modo actual tenga su GoID, Client ID y Client Secret, y que la moneda sea CZK, EUR, PLN, USD, GBP, HUF, RON o BGN. En la página Pay for order se tiene en cuenta la moneda del pedido. La página de ajustes muestra un aviso si las credenciales o la moneda no son válidas.
El pago se realizó, pero el pedido sigue en Pending payment: GoPay no pudo acceder a la URL de notificación que se muestra en los ajustes y el cliente no volvió a la tienda. Quita la protección con contraseña, el modo de mantenimiento o las reglas del cortafuegos que bloqueen la URL. Comprueba que estén configuradas las credenciales del modo en que se realizó el pago, ya que cada notificación se verifica con ellas. Consulta WooCommerce > Status > Logs, origen wcp_gopay_gateway. GoPay repite las notificaciones que no reciben una respuesta correcta.
La notificación responde «Order not found»: esta tienda no creó el pago o se eliminó el pedido correspondiente.
La notificación responde «Payment state could not be verified»: no se pudo acceder a la API de GoPay o las credenciales de ese modo son incorrectas. GoPay repite la notificación.
El cliente ve un error al realizar el pedido: abre las notas del pedido o activa Logging. La nota muestra el error de GoPay. Lo más habitual es que las credenciales sean incorrectas o que pertenezcan al otro modo. Un mensaje sobre los datos de facturación significa que GoPay no aceptó el correo electrónico, el teléfono o la dirección.
Los pagos de prueba no confirman un pedido real: los modos sandbox y producción están separados. Cada pago se comprueba en el modo en que se creó. Cambia Test Mode al modo que quieres usar y utiliza sus credenciales.
El pedido está On hold después del pago: lee la nota del pedido. El importe o la moneda pagados eran distintos de los del pedido, el pago llegó después de que se cancelara el pedido o el pago solo está preautorizado.
Falla el reembolso: lee el mensaje de GoPay. El reembolso parcial solo es posible cuando han transcurrido 24 horas desde el pago. Un mensaje sobre el modo significa que el pago se realizó en sandbox o en producción y que no están configuradas las credenciales de ese modo.
El bloque de licencia muestra un error: sigue las indicaciones del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera un cupo desde tu cuenta de vibefox.net y haz clic en Check now. Si ha cambiado la dirección del sitio, haz clic en Check now para activar la clave para el dominio nuevo. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Para desarrolladores: el filtro gopay_p_payment_payload cambia la solicitud de pago y gopay_p_icon cambia el icono del método de pago.
Desinstalación
Al desactivar el plugin se conservan 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, los tokens de acceso almacenados en caché y los registros solo se eliminan si estaba activada la opción Delete Data on Uninstall. De lo contrario, se conservan para una reinstalación posterior. Los ID de pago de GoPay guardados en los pedidos siempre se conservan. Los pedidos existentes mantienen sus notas de pago y sus ID de transacción.
GoPay es una marca comercial de su respectivo titular. Este plugin no está afiliado a GoPay ni cuenta con su respaldo.