VibeFox PayU India for WooCommerce — Ayuda

Requisitos

WordPress: 5.8 o posterior.

WooCommerce: 6.0 o posterior, instalado y activo. El plugin se niega a activarse sin él; si WooCommerce se desactiva más adelante, el plugin no hace nada y muestra un aviso en el área de administración.

PHP: 8.0 o posterior.

Store currency: rupia india (INR). PayU India cobra únicamente en rupias. Para otras monedas, el método de pago se oculta en la finalización de compra.

Phone number: PayU requiere un número de teléfono para cada pago. Haz que el campo de teléfono sea obligatorio, o al menos visible, en tu finalización de compra.

PayU India account: necesitas la Merchant Key y el Merchant Salt (v1) de PayU Dashboard > Payment Gateway > Key Salt Details. Cambia el panel al modo Test Mode para ver el par de prueba. Usa Salt v1, no Salt v2.

Internet access to your site: necesario para el webhook opcional. Sin él, los pedidos se confirman cuando el cliente regresa desde PayU.

VibeFox license key: comprada 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_india_payment a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > PayU India > 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 la Test Merchant Key y el Salt, y la Live Merchant Key y el Salt (consulta Configuración).

6. Recomendado: en PayU Dashboard > Webhooks, añade la URL del webhook que se muestra en la página de configuración para pagos correctos y fallidos.

7. Elige el Mode y activa Enable/Disable. Prueba un pago en modo Test y luego cambia a Live.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > PayU India. Encima de los campos, la página te avisa cuando falta la clave o el salt del modo actual, muestra Test mode is active: payments go to test.payu.in and no real money is charged. en modo Test, y te avisa cuando la moneda de la tienda no es INR (la pasarela se oculta entonces en la finalización de compra).

Al guardar, se eliminan los espacios y saltos de línea de las claves y salts, ya que un salt con un espacio pegado haría fallar la comprobación de cada respuesta de PayU.

General

Enable/Disable: Enable PayU India Payment Gateway activa o desactiva el método de pago. Por defecto: desactivado.

Title: el título del método de pago que el cliente ve durante la finalización de compra. Por defecto: PayU India.

Description: la descripción del método de pago que el cliente ve durante la finalización de compra. Por defecto: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU.

API credentials

Copia la Merchant Key y el Merchant Salt (v1) de PayU Dashboard > Payment Gateway > Key Salt Details. Cambia el panel a Test Mode para el par de prueba.

Mode: qué entorno de PayU utilizan los nuevos pagos.

Test (Sandbox): utiliza la clave y el salt de Test y test.payu.in. No se cobra dinero real. En la finalización de compra, a la descripción le sigue TEST MODE: no real money is charged. (por defecto).

Live (Production): utiliza la clave y el salt de Live y secure.payu.in.

Los reembolsos siempre se envían al modo en que se realizó el pago.

Live Merchant Key: tu Merchant Key de PayU en vivo.

Live Merchant Salt (v1): tu Merchant Salt (v1) de PayU en vivo. Firma las solicitudes y verifica las respuestas de PayU. Mantenlo en secreto.

Test Merchant Key: tu Merchant Key de prueba de PayU, utilizada solo en modo Test.

Test Merchant Salt (v1): tu Merchant Salt (v1) de prueba de PayU, utilizado solo en modo Test.

Return and webhook URLs

Return URL: tiene el formato https://your-site/wc-api/payu_p_callback/. Se envía a PayU automáticamente con cada pago; no hay que configurar nada.

Webhook URL: tiene el formato https://your-site/wc-api/payu_p_webhook/. Opcional, pero recomendado: confirma los pagos incluso si el cliente cierra el navegador antes de regresar. Añádela en PayU Dashboard > Webhooks para pagos correctos y fallidos. Copia la URL exactamente como la muestra la página de configuración.

Advanced

Verify Payment: Double-check every successful payment with the PayU verify_payment API. Recomendado. Si la comprobación no se puede completar, el pedido se pone en espera en lugar de marcarse como pagado. Por defecto: activado.

Enable Logging: Log gateway events for troubleshooting. Se escribe en WooCommerce > Status > Logs, origen wcp_payu_india_payment. Los errores y advertencias siempre se registran; esta opción añade los demás eventos. Las claves, salts y datos personales de los clientes nunca se registran. Por defecto: desactivado.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted (orders are never deleted). Por defecto: desactivado.

Finalizar compra

El cliente elige el método de pago (por defecto PayU India) y realiza el pedido. Si el pedido no tiene teléfono de facturación (ni teléfono de envío), el cliente ve PayU India requires a phone number. Please enter your phone number and try again. En caso contrario, el cliente pasa a una página breve Thank you for your order. You will be redirected to PayU to complete your payment., que envía una solicitud de pago firmada a la finalización de compra alojada de PayU. Allí el cliente paga con tarjeta, NetBanking, UPI o billetera.

Cada página de pago recibe su propio ID de transacción de PayU, almacenado en el pedido con su importe y modo. Un pago realizado en una página de pago abierta anterior del mismo pedido se sigue aceptando. Un pedido pagado, en espera o cancelado nunca recibe un nuevo formulario de pago, por lo que el botón Atrás del navegador no puede iniciar un segundo pago.

PayU envía el resultado de vuelta con el cliente y, si está configurado, mediante webhook. Un resultado solo se acepta con un hash válido de PayU generado con la clave y el salt del modo en que se inició el pago, y solo para un ID de transacción emitido para ese pedido. Con Verify Payment activado, un resultado correcto también se comprueba con la API verify_payment de PayU. El importe pagado debe ser igual al total del pedido hasta el último paisa, en INR. El pedido solo se marca como pagado después de que PayU lo confirme de esta forma. El plugin gestiona estos resultados de PayU:

success: el pago se realizó. El pedido se marca como pagado cuando se superan todas las comprobaciones.

pending: un pago por UPI o NetBanking sigue en curso. El pedido se pone en espera; el resultado final llega con el webhook.

failure: el pago fue rechazado o cancelado por el cliente. Un pedido no pagado que espera este pago se marca como Fallido. Los pedidos pagados nunca se modifican.

Tras un pago correcto o pendiente, el cliente ve la página de pedido recibido. Tras un pago fallido, el cliente regresa a la finalización de compra con un mensaje: Payment was not completed. Please try again or choose a different payment method., Payment was cancelled. You may try again. o, cuando no se pudo comprobar el resultado, We could not confirm the payment result. If your account was charged, please contact us before paying again. Los mensajes funcionan en la finalización de compra clásica y en el bloque de Finalizar compra.

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).

El plugin cobra únicamente en INR y no tiene procesamiento multimoneda (MCP). No tiene tarjetas guardadas ni tokenización, ni WooCommerce Subscriptions, ni formulario de tarjeta en el sitio (sin interrupciones), ni gestión de EMI u ofertas, ni compra en un clic de PayU.

Pedidos y reembolsos

Estados del pedido

Pending payment: el cliente fue enviado a PayU y todavía no ha pagado.

Processing: el pago fue confirmado. La nota del pedido muestra el ID de transacción de PayU (mihpayid), el modo de pago y el código del banco. El ID de transacción del pedido es el mihpayid de PayU. Los pedidos que solo tienen productos virtuales descargables pasan a Completado, como hace WooCommerce por defecto.

On hold: el pago todavía está pendiente en PayU (UPI o NetBanking), el importe pagado o la moneda difieren del pedido, la API verify_payment no estuvo accesible o todavía no confirmó el pago, o llegó un pago para un pedido que había sido cancelado. La nota del pedido indica el motivo. Revisa la transacción en el Panel de control de PayU y complétala o reembolsala. Si la verificación falló, el pedido se confirma automáticamente en la siguiente entrega del resultado.

Failed: el pago fue rechazado o cancelado. El cliente puede volver a pagar.

Si PayU notifica otro pago correcto para un pedido que ya está pagado, una nota te pide reembolsar el duplicado en el Panel de control de PayU.

Reembolsos

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via PayU India (el botón muestra tu Title). Se admiten reembolsos totales y parciales; el importe debe ser mayor que cero. El reembolso se envía a través de la API de reembolsos de PayU con la clave y el salt del modo en que se realizó el pago, por lo que esas credenciales deben estar configuradas. Si PayU rechaza el reembolso, WooCommerce muestra el mensaje de PayU y no se registra ningún reembolso.

PayU pone en cola los reembolsos y los completa de forma asíncrona; el cliente normalmente recibe el dinero en 5–7 días laborables. La nota del pedido muestra el importe, el ID de solicitud de PayU y el motivo. El plugin no comprueba el estado del reembolso posteriormente.

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 India. 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 India 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 India does not appear at checkout: comprueba que la licencia esté activa, que Enable/Disable esté activado y que la clave y el salt del Mode seleccionado estén completos. Comprueba que la moneda de la tienda (o la moneda del pedido en la página Pay for order) sea INR. La página de configuración muestra una advertencia para cada uno de estos problemas.

The payment went through, but the order stays Pending payment: el cliente no regresó a la tienda y no llegó ningún webhook. Añade la URL del webhook de la configuración en PayU Dashboard > Webhooks para pagos correctos y fallidos, y asegúrate de que sea accesible desde internet.

Webhook answers invalid_signature: el hash de PayU no coincidió. Comprueba que la clave y el salt del modo del pago sean correctos y que se use Salt v1, no Salt v2. El pedido no se modifica.

Webhook answers not_configured: falta la clave o el salt del modo en el que se inició el pago. Introdúcelos; PayU reintentará el webhook.

Webhook answers verify_unavailable: la API verify_payment aún no pudo confirmar el pago. El pedido está en espera y la siguiente entrega lo verificará de nuevo.

The customer sees PayU India requires a phone number: haz que el campo de teléfono sea obligatorio o visible en la finalización de compra. Se utiliza el teléfono de facturación, o el de envío cuando solo este está completo.

The order is On hold: lee la nota del pedido. El motivo es un pago pendiente de UPI o NetBanking, una discrepancia de importe o moneda, una verificación fallida o pendiente, o un pago de un pedido cancelado.

Refund fails: PayU transaction ID not found for this order. significa que el pedido no tiene ningún pago de PayU. Un mensaje de que la Merchant Key o el Salt del modo de pago no están configurados significa que primero debes introducir las credenciales de ese modo.

Too little in the log: los errores y advertencias siempre se registran; activa Enable Logging para ver también cada solicitud y resultado de PayU.

Developer hooks: el filtro payu_p_request_fields modifica los campos de la solicitud de pago antes de que se firmen; el filtro payu_p_icon cambia el icono de la finalización de compra.

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 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 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 de este plugin (archivos de registro y filas del registro de la base de datos de WooCommerce) 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, los ID de transacción de PayU y los ID de solicitud de reembolso.

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