VibeFox PayPlug for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

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

PHP: 8.0 o posterior.

Moneda e importes: euro (EUR), de 0,99 a 20.000,00 por pago, los valores predeterminados de PayPlug. Con otra moneda o fuera de estos límites, el método de pago se oculta.

Cuenta de PayPlug: necesitas las claves secretas de tu cuenta de PayPlug: la clave de prueba (sk_test_...) y/o la clave de producción (sk_live_...). No se necesitan otras claves y no hay que configurar ninguna notificación en PayPlug. Tu sitio debe ser accesible desde internet para recibir notificaciones; si no, los pedidos se actualizan cuando el cliente vuelve desde PayPlug.

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_payplug_gateway a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > PayPlug > 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. Pega tus claves secretas del portal de PayPlug (consulta Configuración).

6. Activa Enable/Disable y guarda. Prueba un pago con Test Mode activado y, después, desactívalo para aceptar pagos reales.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > PayPlug. Encima de los campos, la página te avisa cuando el método de pago está activado pero la clave secreta del modo actual está vacía, y cuando la moneda de la tienda no es EUR. En ambos casos, el método de pago se oculta en la finalización de compra. En la lista de métodos de pago, PayPlug muestra una insignia de modo de prueba en modo de prueba y aparece como pendiente de configuración hasta que el modo actual tenga una clave secreta.

Finalización de compra

Enable/Disable: Enable PayPlug Gateway activa o desactiva el método de pago. Por defecto: off.

Title: el nombre del método de pago que ven los clientes en la finalización de compra. Por defecto: PayPlug.

Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely by card via PayPlug.

Claves de API

Encuentra tus claves secretas en el portal de PayPlug, en Developers > API keys. La sección también muestra la URL de notificación que el plugin envía con cada pago. Tiene este aspecto: https://your-site/wc-api/ppg_payplug_webhook/. No es necesario configurar ninguna notificación en PayPlug.

Test Mode: Enable test mode usa la clave secreta de prueba para los nuevos pagos. No se procesa ningún pago real. Los pagos realizados en el otro modo siguen usando la clave de su propio modo para las comprobaciones de estado y los reembolsos. Por defecto: on.

Test Secret Key: tu clave secreta de prueba de PayPlug. Empieza por sk_test_.

Live Secret Key: tu clave secreta de producción de PayPlug. Empieza por sk_live_.

No se guarda una clave con un prefijo incorrecto. La página muestra, por ejemplo, Test Secret Key debe empezar por "sk_test_". Se mantuvo el valor anterior.

Pedidos

Order Status After Payment: el estado del pedido que se asigna tras un pago correcto. El estado se asigna de inmediato, sin un segundo cambio de estado.

Avanzado

Logging: Enable debug logging registra las llamadas a la API y las notificaciones en WooCommerce > Status > Logs, con el origen wcp_payplug_gateway. Los errores siempre se registran. Las claves secretas, los datos de tarjetas y los datos de clientes nunca se registran. Por defecto: off.

Delete Data on Uninstall: Remove all plugin data when uninstalling. Si está marcada, los ajustes del plugin y sus registros se eliminan al borrar el plugin. Los ID de pago de PayPlug guardados en los pedidos se conservan. Por defecto: off.

Finalización de compra

El cliente elige el método de pago (por defecto, PayPlug) y realiza el pedido. En modo de prueba, la finalización de compra muestra Modo de prueba: no se realizará ningún pago real. El plugin crea un pago de PayPlug por el total del pedido en céntimos y envía al cliente a la página de pago de PayPlug. Los datos de facturación y de envío del pedido y el idioma de tu sitio se transmiten a PayPlug. Allí, el cliente paga con tarjeta.

Tras pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando PayPlug lo confirma: el plugin lee el pago desde la API de PayPlug cuando llega la notificación y cuando el cliente regresa. Un pago realizado lleva al cliente a la página de pedido recibido.

Si el cliente cancela en la página de PayPlug, la página de pago se cierra en PayPlug, de modo que no puede pagarse después por error. El cliente vuelve a la página Pay for order con un mensaje, por ejemplo Has cancelado el pago con PayPlug. Puedes intentarlo de nuevo o elegir otro método de pago., La sesión de pago de PayPlug ha caducado. Inténtalo de nuevo o elige otro método de pago. o El pago con PayPlug ha fallado. Inténtalo de nuevo o elige otro método de pago.

Cuando el cliente vuelve a pagar el mismo pedido, el plugin revisa primero el intento anterior. Si entretanto se pagó, el pedido se completa sin un nuevo pago. Si sigue abierto por el mismo importe, se reutiliza la misma página de pago. En caso contrario, la página anterior se cierra en PayPlug y se crea un nuevo pago.

Si PayPlug no puede iniciar el pago, el cliente ve un breve mensaje, por ejemplo PayPlug no ha podido aceptar tus datos de facturación (código postal). Revísalos e inténtalo de nuevo. o No se ha podido contactar con el proveedor de pagos. Inténtalo de nuevo en unos instantes. 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 el bloque de Finalizar compra y en la página Pay for order. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).

Los pagos se capturan de inmediato. El plugin no admite pagos a plazos de Oney, Bancontact, Apple Pay ni American Express, tarjetas guardadas de un solo clic, formulario de pago integrado, suscripciones ni captura diferida.

Pedidos y reembolsos

Order statuses

Pending payment: el cliente fue enviado a PayPlug y todavía no ha pagado, o PayPlug aún no ha confirmado el pago.

Processing or Completed: el pago se ha confirmado. El estado sigue a Order Status After Payment. La nota del pedido muestra el pago de PayPlug y su modo. El ID de transacción es el ID de pago de PayPlug (pay_...).

On hold: el importe o la moneda pagados no coinciden con el pedido (nota amount/currency mismatch); o se realizó un pago de prueba mientras la tienda está en modo producción, así que no se recibió dinero; o el pago llegó para un pedido que se había cancelado; o el pago está autorizado pero no capturado (captúralo en el portal de PayPlug; el pedido se marca como pagado cuando PayPlug lo informa como pagado). La nota del pedido explica qué revisar.

Failed: el último intento de pago de un pedido pendiente falló o fue cancelado. El fallo de un intento anterior no cambia el pedido. El cliente puede volver a pagar.

Si un segundo intento de un pedido que ya está pagado también se paga, el pedido no cambia. Una nota pide que reembolses el pago duplicado en el portal de PayPlug.

Reembolsos

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via PayPlug. Se admiten reembolsos totales y parciales. El reembolso se envía al pago que realmente pagó el pedido, con la clave secreta del modo (prueba o producción) en el que se realizó, así que esa clave debe estar configurada. Si PayPlug no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID de reembolso de PayPlug.

Los reembolsos realizados en el portal de PayPlug llegan mediante notificación y se añaden a las notas del pedido. No se crean automáticamente en WooCommerce. Si hace falta, regístralos manualmente.

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 > PayPlug. 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 su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, PayPlug 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 puedan configurar y probar el plugin antes de comprar una clave. Aparece un aviso 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 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

PayPlug no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el modo actual tiene una clave secreta (Test Secret Key en modo de prueba, Live Secret Key en modo de producción), que la moneda de la tienda es EUR y que el total del pedido está entre 0,99 y 20.000,00 EUR. Las cuentas con otros límites pueden cambiarlos con el filtro ppg_amount_limits (valores en céntimos).

El pago se realizó, pero el pedido sigue en Pendiente de pago: la notificación no llegó a tu tienda y el cliente no volvió. Comprueba que tu sitio es accesible desde internet en la URL de notificación que aparece en los ajustes, por ejemplo que ningún modo de mantenimiento, cortafuegos o protección con contraseña lo bloquea. Revisa WooCommerce > Status > Logs, origen wcp_payplug_gateway, por si hay notificaciones rechazadas.

La notificación responde Verification failed: el pago no pudo leerse de la API de PayPlug, por ejemplo porque PayPlug no respondió. El pedido no cambia y PayPlug vuelve a enviar la notificación.

La notificación responde Busy, retry: otra solicitud estaba actualizando el pedido en ese mismo momento, por ejemplo el retorno del cliente. PayPlug vuelve a enviar la notificación.

La notificación responde Unknown payment o Payment does not belong to the order: el pago no fue creado por esta tienda o no corresponde a este pedido, por ejemplo un pago de otra tienda en la misma cuenta de PayPlug. Se ignora.

El cliente ve Payment could not be initiated: el intento de pago anterior del pedido se está confirmando en este momento, o PayPlug rechazó la solicitud. Espera un momento e inténtalo de nuevo; las notas del pedido muestran el error de PayPlug.

El pedido está En espera tras el pago: lee la nota del pedido. El importe o la moneda pagados no coincidían con el pedido, se realizó un pago de prueba mientras la tienda estaba en producción, o el pago llegó después de que el pedido se cancelara. Procesa el pedido o reembolsa el pago.

El reembolso falla con un mensaje sobre el modo: el pago se realizó en modo de prueba o de producción, y la clave secreta de ese modo no está configurada. Introdúcela e inténtalo de nuevo.

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 la dirección del sitio cambió, 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 la licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros solo se eliminan si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago, los ID de transacción y los ID de pago de PayPlug.

PayPlug es una marca comercial de su respectivo propietario. Este plugin no está afiliado a PayPlug ni cuenta con su respaldo.