VibeFox PayU for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él; si WooCommerce se desactiva más adelante, el plugin no realiza ninguna acción y muestra un aviso en el área de administración.
PHP: 8.0 o posterior.
Moneda de la tienda: una de PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. La moneda también debe estar habilitada para tu punto de venta en PayU. Para otras monedas, el método de pago se oculta en la finalización de compra.
Acceso de Internet a tu sitio: PayU envía notificaciones de pago a tu tienda, por lo que el sitio debe ser accesible desde Internet (no debe estar protegido por autenticación HTTP ni en página de mantenimiento). Sin notificaciones, los pedidos se siguen comprobando cuando el cliente regresa desde PayU.
Cuenta de PayU: necesitas cuatro claves de tu punto de venta (POS): POS ID, Second key (MD5), OAuth client_id y OAuth client_secret. Se encuentran en el panel de comerciante de PayU en Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Las claves de sandbox provienen de una cuenta independiente de sandbox de PayU.
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_payu_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > PayU > 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 las cuatro claves de Sandbox y las cuatro claves de Live (consulta Configuración). No es necesario configurar ninguna URL de notificación en PayU.
6. Activa Enable/Disable. Mantén Test Mode activado hasta haber realizado un pago de prueba y, a continuación, desmárcalo para aceptar pagos reales con las claves de Live.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > PayU. Encima de los campos, la página te avisa si el modo sandbox está activado, si falta alguna de las cuatro claves del modo actual o si PayU no admite la moneda de la tienda. En los dos últimos casos, PayU no se muestra en la finalización de compra.
Al guardar, los espacios y saltos de línea se eliminan de todas las claves, ya que al copiarlas desde el panel de PayU a menudo se añaden.
General
Enable/Disable: Enable PayU payment gateway activa o desactiva el método de pago. Por defecto: desactivado.
Title: el título del método de pago mostrado al cliente. Por defecto: PayU.
Description: la descripción del método de pago mostrada al cliente. Por defecto: Pay securely via PayU.
Credenciales de API
Encuentra las claves en el panel de comerciante de PayU: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Las claves de sandbox provienen de una cuenta independiente de sandbox de PayU. Las cuatro claves del modo deben estar completadas.
Test Mode: Enable sandbox (test) mode. Utiliza el sandbox de PayU y las claves de Sandbox indicadas abajo. No se cobra dinero real. En la finalización de compra clásica y en el bloque de Finalizar compra, el cliente ve Sandbox mode — no real money is charged. Desactívalo para aceptar pagos reales con las claves de Live. Por defecto: activado.
Live POS ID: el POS ID (merchantPosId) de tu punto de venta de producción.
Live Second Key (MD5): se utiliza para verificar la firma de las notificaciones de PayU.
Live OAuth Client ID: el OAuth client_id del punto de venta.
Live OAuth Client Secret: el OAuth client_secret del punto de venta.
Sandbox POS ID: el POS ID de tu punto de venta en el sandbox de PayU.
Sandbox Second Key (MD5): se utiliza para verificar la firma de las notificaciones del sandbox de PayU.
Sandbox OAuth Client ID: el OAuth client_id del punto de venta de sandbox.
Sandbox OAuth Client Secret: el OAuth client_secret del punto de venta de sandbox.
Cada pago recuerda su entorno. Las notificaciones, comprobaciones de estado y reembolsos de un pago siempre utilizan las claves de ese entorno, por lo que los pagos más antiguos siguen funcionando tras cambiar de modo. Una notificación firmada con la clave de sandbox nunca se acepta para un pago en vivo.
Notificaciones de pago
Esta sección muestra la URL de notificación, que se ve como https://your-site/wc-api/wc_pu_payment/. El plugin la envía a PayU con cada pago, por lo que no hay que configurar nada en el panel de PayU. Asegúrate de que sea accesible desde Internet (que no esté bloqueada por cortafuegos, modo de mantenimiento o autenticación HTTP).
Avanzado
Receive payments automatically: Automatically receive payments waiting for confirmation. Esto solo tiene relevancia si la recepción automática está desactivada para tu POS en el panel de PayU: en tal caso, los pagos quedan esperando confirmación (WAITING_FOR_CONFIRMATION). Cuando esta opción está activada, el plugin recibe dichos pagos de inmediato. Cuando está desactivada, estos pedidos se ponen en espera y tú recibes o cancelas el pago con las acciones del pedido Receive PayU payment y Cancel PayU payment. Por defecto: activado.
Logging: Enable logging guarda eventos técnicos (números de pedido, ID de pedido de PayU, estados, errores; sin claves ni datos personales) en WooCommerce > Status > Logs, origen wcp_payu_payment. Por defecto: desactivado.
Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Los pedidos y sus datos de pago nunca se eliminan. Desactivar el plugin lo conserva todo. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto PayU) y realiza el pedido. El plugin crea un pedido en PayU por el total del pedido en la moneda de este, con la descripción Order #, el número de pedido y el nombre de tu tienda, y con los artículos del pedido, el envío y las tarifas para mostrarlos en la página de PayU. El idioma de la página de PayU sigue el idioma de la tienda cuando PayU lo admite; de lo contrario, inglés. El cliente es redirigido a la página de pago de PayU, elige allí un método y paga.
Cada intento de pago recibe su propio pedido de PayU. Cuando el cliente paga de nuevo (tras un pago fallido o cancelado, o desde la página Pay for order), el pago de PayU pendiente anterior de ese pedido se cancela en PayU, por lo que un enlace de pago antiguo no puede pagarse dos veces.
El simple regreso a tu tienda nunca da por pagado un pedido. El pedido solo se marca como pagado una vez que PayU lo confirma: mediante una notificación firmada con la Second Key del entorno del pago, o mediante una comprobación de estado del pedido de PayU en el servidor cuando el cliente regresa (útil si una notificación se retrasa). El pedido de PayU debe ser uno creado para este pedido, y el importe y la moneda deben coincidir. El plugin gestiona estos estados de PayU:
En la página de pedido recibido, mientras el pedido sigue en Pendiente de pago, el cliente ve We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again: o, tras un pago fallido, The payment was not completed. You can try again:, cada uno con un botón Pay again. Para un pedido en espera, el mensaje es Your payment is being verified. We will send you an e-mail as soon as it is confirmed.
Si PayU no puede iniciar el pago, el cliente ve Payment error. Please try again or choose another payment method. El motivo técnico (código HTTP y estado de PayU) se registra en el registro y en una nota del pedido PayU payment could not be started:. Si faltan las claves del modo actual, el mensaje es Payment gateway is not configured properly. Please contact the administrator.
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 High-Performance Order Storage (HPOS) de WooCommerce.
El cliente elige el método de pago en la página de PayU, no en tu finalización de compra. El plugin no tiene formulario de tarjeta en tu tienda, ni tarjetas guardadas o pagos en un clic, ni suscripciones, ni widgets de crédito o cuotas de PayU. Utiliza un único punto de venta por entorno (no hay punto de venta por moneda).
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue redirigido a PayU y aún no ha pagado. La nota del pedido muestra el ID de pedido de PayU y el entorno (sandbox o producción).
Processing: el pago se confirmó. La nota del pedido muestra el ID de pedido de PayU, el importe y el entorno. El ID de transacción es el ID del pedido de PayU que fue pagado. Los pedidos que contienen únicamente productos virtuales descargables pasan a Completado, como hace WooCommerce por defecto.
On hold: el importe pagado o la moneda no coincidían con el pedido, se completó un pago para un pedido que había sido cancelado, o un pago espera tu confirmación (recepción automática desactivada o error al recibir). La nota del pedido indica cuál es el caso y qué hacer.
Failed: el pago más reciente de PayU fue cancelado o rechazado. El cliente puede intentar pagar de nuevo.
Cada notificación se procesa una sola vez, bajo un bloqueo por pedido: las notificaciones repetidas no añaden notas, no reducen existencias ni envían correos electrónicos dos veces. Si se completa otro pago para un pedido que ya está pagado o reembolsado, una nota te solicita reembolsarlo en el panel de PayU. Un pago pendiente de confirmación en un pedido que ya está pagado o cerrado se cancela automáticamente para no cobrar el dinero dos veces.
Pagos pendientes de confirmación
Para un pedido no pagado con un pago pendiente de confirmación, la pantalla del pedido ofrece dos acciones del pedido: Receive PayU payment (waiting for confirmation) y Cancel PayU payment (release the funds). Elige una y haz clic en el botón de actualización. La acción se añade a las notas del pedido con tu nombre de usuario, y el nuevo estado de PayU se aplica de inmediato.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via PayU (el botón muestra tu Title). Se admiten reembolsos totales y parciales. El reembolso se envía para el pedido de PayU que realmente se pagó, con las claves del entorno del pago, por lo que dichas claves deben estar configuradas. El motivo del reembolso se envía como la descripción del reembolso. Si PayU rechaza el reembolso, WooCommerce muestra el error de PayU y no se registra ningún reembolso.
Los reembolsos son asíncronos en PayU. El plugin añade de inmediato una nota con el ID de reembolso de PayU y el estado; el estado final llega más tarde como una notificación de PayU y se añade como nota. Si PayU cancela un reembolso, la nota indica que el dinero no se devolvió al cliente.
Los pedidos puestos en espera debido a una discrepancia de importe o moneda conservan el ID de pedido de PayU como su ID de transacción, de modo que el pago puede reembolsarse tanto desde WooCommerce como en el panel de PayU.
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 > PayU. 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 comprobar el estado de nuevo, 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 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, PayU 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 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 aviso 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 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
PayU no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que las cuatro claves del modo actual estén completadas: las claves de Sandbox en el modo sandbox, las claves de Live en el modo live. Comprueba que la moneda de la tienda (o la moneda del pedido en la página Pay for order) sea una de las monedas admitidas. La página de ajustes muestra un aviso para cada uno de estos problemas.
El pago se realizó, pero el pedido sigue en Pendiente de pago: PayU aún no ha entregado la notificación y la comprobación de estado en la página de retorno no detectó un pago completado. Comprueba que la URL de notificación mostrada en los ajustes sea accesible desde Internet. Activa Logging para ver qué llega.
La notificación responde Invalid signature: la notificación no fue firmada con la Second Key de ninguno de los dos entornos. Comprueba Live Second Key (MD5) y Sandbox Second Key (MD5). La respuesta Invalid signature for this payment significa que la notificación fue firmada con la clave del entorno opuesto al del pago.
La notificación responde Ignored: el pedido de PayU no pertenece a un pedido de esta tienda pagado con PayU, por ejemplo pertenece a otra tienda en el mismo POS. PayU deja de reintentar.
El pago no se crea: activa Logging y revisa WooCommerce > Status > Logs, origen wcp_payu_payment. El registro muestra el código HTTP y el estado de PayU. Could not authenticate with PayU (check the OAuth client ID / secret). significa que las claves OAuth del modo actual son erróneas.
El pedido está En espera: lee la nota del pedido. El motivo es una discrepancia de importe o moneda, un pago tras una cancelación o un pago pendiente de confirmación. En este último caso, utiliza las acciones del pedido Receive PayU payment o Cancel PayU payment.
Fallo en el reembolso: This order has no completed PayU payment. Cannot process refund. significa que el pedido no tiene un pedido de PayU pagado. Un mensaje indicando que faltan las claves de Sandbox o de Live significa que el pago se realizó en ese entorno y sus claves no están configuradas. Introdúcelas y vuelve a intentarlo.
Otras monedas: los desarrolladores pueden modificar la lista de monedas con el filtro wc_pu_supported_currencies y el icono de la finalización de compra con el filtro wc_pu_icon.
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 para 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 ajustes; solo se eliminan los tokens de acceso de PayU en caché. 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, junto con los tokens en caché. Los ajustes de la pasarela y el registro de este plugin se eliminan solo si Delete data on uninstall estaba activado. De lo contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago, ID de pedido de PayU e ID de transacción.
PayU es una marca comercial de su respectivo propietario. Este plugin no está afiliado a PayU ni cuenta con su respaldo.