VibeFox PayU LATAM for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no permite activarse sin él; si WooCommerce se desactiva después, el plugin no hace nada y muestra un aviso en el área de administración.
PHP: 8.0 o posterior.
Currency: el pedido debe estar en ARS, BRL, CLP, COP, MXN, PEN o USD, las monedas que procesa PayU Latam en Argentina, Brasil, Chile, Colombia, México, Panamá y Perú. Con otras monedas, el método de pago se oculta en la finalización de compra.
PayU Latam account: necesitas tres valores de tu comercio de PayU: el ID de comerciante, el ID de cuenta del país donde vendes y la clave API. Están en el módulo de PayU (el panel de comerciante de PayU), en Settings > Technical configuration (ID de comerciante, clave API) y Accounts (ID de cuenta). Para las pruebas, PayU publica credenciales públicas de sandbox y tarjetas de prueba en la página "Test your solution" de su documentación para desarrolladores. No se necesitan API Login ni otras credenciales API, porque el pago se realiza en la página alojada por PayU.
Internet access to your site: PayU envía el resultado del pago a tu tienda desde sus servidores, por lo que el sitio debe ser accesible desde internet (no un sitio local, ni protegido con contraseña o una página de mantenimiento).
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_latam_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > PayU LATAM > Manage, o haz clic en Settings bajo el nombre del plugin en la página de 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 credenciales de sandbox y las de producción (consulta Configuración). No hay que configurar ninguna URL de confirmación en PayU.
6. Activa Enable/Disable y guarda. Mantén Sandbox activado hasta que hayas realizado un pago de prueba; después desmárcalo para aceptar pagos reales con las credenciales de producción.
Configuración
Todos los ajustes están en una página: WooCommerce > Settings > Payments > PayU LATAM. Encima de los campos, la página te avisa mientras el modo sandbox está activado (Sandbox mode. Los pagos van al sandbox de PayU y no se cobra dinero real.), cuando falta el ID de comerciante, el ID de cuenta o la clave API del entorno actual, y cuando PayU LATAM no procesa la moneda de la tienda. En los dos últimos casos, PayU LATAM no aparece en la finalización de compra. En la lista de métodos de pago, PayU LATAM figura como pendiente de configuración hasta que se rellenan las tres credenciales del entorno actual. Se ignoran los espacios al principio o al final de una credencial.
General
Enable/Disable: Enable PayU LATAM activa o desactiva el método de pago. Por defecto: off.
Title: el título del método de pago que ve el cliente durante la finalización de compra. Por defecto: PayU LATAM.
Description: la descripción del método de pago que ve el cliente durante la finalización de compra. Por defecto: Pay with a card, cash or bank transfer on the secure PayU page. You will be redirected to PayU to complete your payment.
Entorno
Sandbox: Enable the PayU sandbox (test mode). Los pagos van al sandbox de PayU con las credenciales de sandbox de abajo y no se cobra dinero real. Al desactivarlo, se usan las credenciales de producción y la página de pago de producción de PayU. Por defecto: on.
Credenciales de producción
Encuéntralas en el módulo de PayU: Settings > Technical configuration (ID de comerciante, clave API) y Accounts (ID de cuenta del país donde vendes). La sección enlaza al panel de comerciante de PayU.
Merchant ID: el identificador numérico de tu comercio de PayU.
Account ID: el identificador de la cuenta de PayU. Hay una cuenta por país.
API Key: la clave secreta usada para firmar los pagos y verificar las notificaciones de PayU.
Credenciales de sandbox
PayU publica credenciales públicas de prueba y tarjetas de prueba para su sandbox. La sección enlaza a la página "Test your solution" de la documentación de PayU.
Sandbox merchant ID: el ID de comerciante para el sandbox de PayU.
Sandbox account ID: el ID de cuenta para el sandbox de PayU.
Sandbox API key: la clave API para el sandbox de PayU.
Cada intento de pago recuerda su entorno. La confirmación de un pago de sandbox se verifica con la clave API y el ID de comerciante de sandbox, y la de un pago de producción con los de producción, para que los pagos pendientes sigan funcionando después del cambio. Al actualizar desde la versión 1.0, que tenía un solo conjunto de credenciales, los valores anteriores se copian a los campos de sandbox si este estaba activado. Revisa los ajustes después de actualizar.
URL de confirmación
Esta sección muestra la URL a la que PayU comunica el resultado de cada pago. Tiene el formato https://your-site/wc-api/payu_lp/. El plugin la envía a PayU con cada pago, por lo que no hay nada que configurar en PayU. La página debe ser accesible desde internet. PayU firma la confirmación con tu clave API. Se rechazan las confirmaciones sin firma válida, con otro ID de comerciante o con una referencia de pago que esta tienda no emitió para el pedido. El plugin gestiona estos estados de transacción de PayU:
Los demás estados solo se añaden como nota del pedido. Sin la confirmación, un pedido nunca se marca como pagado: permanece Pendiente de pago.
Avanzado
Debug log: Log payment requests and PayU notifications escribe los detalles en WooCommerce > Status > Logs, fuente wcp_payu_latam_payment, sin claves ni datos personales. Los errores y las notificaciones rechazadas siempre se registran. Por defecto: off.
Delete data: Delete the settings and logs when the plugin is deleted. Desactivar el plugin nunca elimina nada. Se conservan los datos de PayU guardados en los pedidos. Por defecto: off.
Finalización de compra
El cliente elige el método de pago (por defecto PayU LATAM) y realiza el pedido. En el bloque de Finalizar compra, en modo sandbox, el cliente ve Sandbox mode: no real payment is made. El pedido permanece Pendiente de pago y el cliente accede a una página de pago de tu tienda con el texto Thank you for your order. You are being redirected to PayU LATAM to complete the payment… La página envía automáticamente un formulario firmado a la página de PayU WebCheckout. Si esto no ocurre, el cliente hace clic en Pay with PayU LATAM, o en Cancel order para cancelar el pedido.
El formulario contiene el total y la moneda del pedido, el impuesto y la base imponible del pedido (ambos 0 en pedidos sin impuestos, para que PayU no añada un IVA por defecto), la descripción Order # con el número de pedido y el nombre de tu tienda, y el correo electrónico, nombre, teléfono y dirección de facturación del cliente. La página de PayU se abre en español, portugués o inglés según el idioma de la tienda. En la página de PayU, el cliente paga con cualquier método habilitado en tu cuenta de PayU.
Cada visita a la página de pago inicia un nuevo intento de pago con su propia referencia (el número de pedido y una marca de tiempo). Se recuerdan los últimos 30 intentos del pedido: si el cliente paga en una pestaña anterior de PayU, el pago se acepta igualmente.
El pedido solo se marca como pagado después de que PayU lo confirme mediante la confirmación firmada. El regreso del cliente desde PayU nunca marca un pedido como pagado. Cuando el cliente vuelve:
Si faltan las credenciales del entorno actual, el cliente ve PayU LATAM is not available right now. Please choose another payment method. Si la moneda del pedido no es compatible, el mensaje es PayU LATAM does not accept payments in seguido de la moneda. Un pedido ya pagado no se vuelve a pagar: la página de pago muestra This order has already been paid.
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 formulario de pago en tu tienda, reembolsos desde WooCommerce, tarjetas guardadas, suscripciones ni ajustes de cuotas (PayU muestra las cuotas en su página). No consulta la API de PayU para obtener el estado del pago: solo la confirmación firmada actualiza el pedido.
Pedidos
Estados del pedido
Pending payment: el cliente ha sido enviado a PayU y aún no ha pagado, o PayU aún no ha enviado la confirmación.
Processing: PayU ha confirmado el pago y el importe y la moneda coinciden. La nota del pedido muestra la transacción de PayU, el importe, el método de pago y [sandbox] para los pagos de sandbox. El ID de transacción del pedido es el ID de transacción de PayU. Los pedidos que solo contienen productos virtuales descargables pasan a Completado, como hace WooCommerce por defecto.
On hold: PayU comunica el pago como pendiente (pago en efectivo o bancario), el importe pagado o la moneda no coincide con el total del pedido, o se aprobó un pago para un pedido cancelado. La nota del pedido indica el motivo: comprueba el pago en el módulo de PayU y después procesa el pedido, restáuralo o reembolsa el pago.
Failed: el último intento de pago fue rechazado, caducó o terminó con un error. La nota muestra el mensaje de PayU. El cliente puede volver a pagar. Un rechazo de un intento anterior, o de un pedido que ya tiene un pago aprobado, solo se añade como nota.
Cada notificación se procesa una vez, con un bloqueo por pedido: las notificaciones repetidas de PayU no añaden notas, reducen existencias ni envían correos electrónicos dos veces. Si otra solicitud tarda demasiado en actualizar el pedido, se responde a la confirmación con un error y PayU la vuelve a enviar más tarde. Un pedido pagado, completado o reembolsado nunca se reabre. Si llega otro pago aprobado para un pedido ya pagado, una nota lo indica: si el cliente pagó dos veces, reembolsa el duplicado en el módulo de PayU.
Reembolsos
Los reembolsos no se hacen desde WooCommerce. Reembolsa la transacción en el módulo de PayU y, si es necesario, registra el reembolso manualmente en 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 > PayU LATAM. 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. Quitar la clave de un sitio no libera su espacio de dominio. Libera el espacio en tu cuenta de vibefox.net.
Sin una clave activa, PayU LATAM no se muestra a los clientes en 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 gestores de tienda con sesión iniciada siguen viendo el método de pago, marcado con (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 de plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose.
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 LATAM no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que estén rellenados el ID de comerciante, el ID de cuenta y la clave API del entorno actual: las credenciales de sandbox cuando Sandbox está activado, y las de producción cuando está desactivado. Comprueba que la moneda de la tienda (o la del pedido en la página de pago del pedido) sea ARS, BRL, CLP, COP, MXN, PEN o USD. La página de ajustes muestra un aviso para cada uno de estos problemas.
El pago se ha realizado, pero el pedido permanece Pending payment: la confirmación de PayU no llegó a tu tienda o fue rechazada. Comprueba que la URL de confirmación de los ajustes sea accesible desde internet (sin sitio local, modo de mantenimiento, cortafuegos ni protección con contraseña). Revisa WooCommerce > Status > Logs, fuente wcp_payu_latam_payment, para ver las confirmaciones rechazadas. PayU vuelve a enviar la confirmación tras cualquier respuesta de error.
La confirmación responde Invalid signature: la confirmación no se firmó con la clave API del entorno del pago. Comprueba API Key para pagos de producción y Sandbox API key para pagos de sandbox.
La confirmación responde Merchant mismatch: el ID de comerciante de la confirmación difiere de Merchant ID o Sandbox merchant ID del entorno del pago. Introduce el ID de comerciante de la cuenta de PayU que procesa los pagos.
La confirmación responde Gateway not configured: falta la clave API o el ID de comerciante del entorno del pago; por ejemplo, se eliminaron las credenciales de sandbox mientras había un pago de sandbox pendiente. Vuelve a introducirlos; PayU reintenta la confirmación.
La confirmación responde Busy, retry later: otra solicitud estaba actualizando el pedido al mismo tiempo. No se cambió nada y PayU vuelve a enviar la confirmación.
La confirmación responde Unknown reference: la referencia de pago no pertenece a un pedido de PayU LATAM de esta tienda; por ejemplo, se cambió el pedido a otro método de pago o se eliminó.
El pedido está On hold: lee la nota del pedido. El pago sigue pendiente en PayU (pago en efectivo o bancario), el importe pagado o la moneda difería del pedido, o el pago llegó después de cancelar el pedido. Comprueba la transacción en el módulo de PayU.
Otras monedas o campos del formulario: los desarrolladores pueden cambiar la lista de monedas con el filtro payu_lp_supported_currencies, el icono de la finalización de compra con el filtro payu_lp_icon y los campos del formulario de WebCheckout con el filtro payu_lp_payment_fields.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera un espacio 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 quitarlo, desactívalo y elimínalo 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 solo se eliminan si Delete data estaba activado. De lo contrario, se conservan para una futura reinstalación. Los pedidos existentes conservan sus notas de pago, referencias 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.