VibeFox PayPal 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.
HTTPS: tu sitio debe usar HTTPS para los pagos en producción.
Cuenta de PayPal: una cuenta Business de PayPal con una aplicación REST API en el Panel para desarrolladores de PayPal. Necesitas el Client ID y el Secret de la aplicación. Las aplicaciones de sandbox y de producción tienen credenciales distintas. No hace falta ningún webhook: el plugin confirma cada pago en tu servidor mientras el cliente está en la finalización de compra.
Moneda: una de las monedas que admite PayPal: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD o USD.
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_paypal_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. En el Panel para desarrolladores de PayPal, crea una aplicación REST API (sandbox y/o producción) y copia su Client ID y su Secret.
4. Abre la configuración: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage, o haz clic en Settings debajo del nombre del plugin en la página Plugins.
5. 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.
6. Introduce las credenciales del modo que vayas a usar, elige Capture o Authorize, activa Enable/Disable y guarda los cambios.
7. Haz una prueba con una cuenta de comprador de sandbox de PayPal y, después, desmarca Sandbox mode e introduce las credenciales de producción.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > PayPal (Smart Buttons). Encima de los campos, la página te avisa cuando el método de pago está activado pero el Client ID o el Secret del modo seleccionado están vacíos, y cuando PayPal no admite la moneda de la tienda. En ambos casos, el método de pago se oculta en la finalización de compra. En la lista de métodos de pago, PayPal muestra la insignia Test mode en modo sandbox y aparece como pendiente de configuración hasta que se rellenen las credenciales del modo seleccionado.
General
Enable/Disable: Enable PayPal 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: PayPal.
Description: el texto que aparece debajo del método de pago en la finalización de compra. Por defecto: Pay with your PayPal account or a card via PayPal.
Credenciales de API
Crea una aplicación REST API en el Panel para desarrolladores de PayPal y copia su Client ID y su Secret. La sección tiene enlaces a las aplicaciones de sandbox y a las de producción. Solo se muestran los campos del modo seleccionado.
Sandbox mode: Enable sandbox (test) mode. Los pagos se envían al sandbox de PayPal con las credenciales de sandbox; no se mueve dinero real. Por defecto: on. Desmárcalo para aceptar pagos reales.
Sandbox Client ID: el Client ID de tu aplicación REST API de sandbox.
Sandbox Secret: el Secret de tu aplicación REST API de sandbox.
Live Client ID: el Client ID de tu aplicación REST API de producción.
Live Secret: el Secret de tu aplicación REST API de producción.
Pago
Payment action: qué ocurre cuando el cliente aprueba el pago. Por defecto: Capture.
Avanzado
Debug log: Log API requests (errors are always logged). Los registros se guardan en WooCommerce > Status > Logs, con el origen wcp_paypal_gateway. Las credenciales y los datos del comprador nunca se registran. Por defecto: off.
Delete data on uninstall: Delete the gateway settings when the plugin is deleted. Los datos de pago de los pedidos (los ID de PayPal de los pedidos) siempre se conservan. Por defecto: off.
Finalización de compra
Cuando el cliente elige PayPal (por defecto, PayPal), el botón de PayPal sustituye a Place order. En modo sandbox, la finalización de compra muestra Modo sandbox: paga con una cuenta de comprador de sandbox de PayPal; no se cobra dinero real. Al pulsar el botón, tu servidor crea un pedido de PayPal por el total del carrito (o por el total del pedido en la página Pay for order). El importe siempre se calcula en el servidor, nunca en el navegador.
El cliente aprueba el pago en la ventana de PayPal con una cuenta de PayPal u otra fuente de financiación que ofrezca PayPal. La finalización de compra muestra entonces El pago con PayPal se ha aprobado. Completando tu pedido… y envía el pedido. Tu servidor lee el pedido de PayPal y comprueba que está aprobado, que se creó en esta finalización de compra, que no lo usa otro pedido y que su importe y su moneda coinciden con los del pedido. Solo entonces se captura (o se autoriza) el pago y el cliente llega a la página de pedido recibido.
Si el total del carrito cambió después de la aprobación, no se captura nada. El cliente ve El total del pedido cambió después de que aprobaras el pago en PayPal. Vuelve a pulsar el botón de PayPal para aprobar el nuevo total. Si falta un campo de la finalización de compra, la aprobación se conserva: tras corregirlo, el cliente pulsa Place order para completar el pago. Si PayPal rechaza el pago, se le pide que pulse el botón de PayPal y elija otra forma de pago. Si el cliente cierra la ventana de PayPal, la finalización de compra muestra Has cancelado el pago con PayPal.
Si PayPal no responde durante la captura, el cliente ve Todavía no hemos podido confirmar tu pago con PayPal. Inténtalo de nuevo en unos instantes: no se te cobrará dos veces. Un reintento usa la misma aprobación y, si PayPal había completado el intento anterior, se usa ese pago y la nueva aprobación no se captura.
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. El script de PayPal se carga en su propio espacio de nombres, así que no entra en conflicto con otro plugin de PayPal de la página. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin no tiene webhooks de PayPal, mensajes de Pay Later, campos de tarjeta, ajustes de Venmo, Apple Pay, Google Pay ni Fastlane, ni métodos de pago guardados o suscripciones, ni botones en las páginas de producto o de carrito. Se usa la dirección de envío introducida en la finalización de compra de WooCommerce, no una dirección de PayPal.
Pedidos y reembolsos
Order statuses
Pending payment: el pedido se ha creado, pero el pago todavía no está capturado, por ejemplo tras una respuesta desconocida de PayPal.
Processing: la captura se ha completado. Los pedidos que solo contienen productos virtuales descargables pasan a Completado, el valor predeterminado de WooCommerce. La nota del pedido muestra el importe, el pedido de PayPal y la captura. El ID de la transacción es el ID de captura de PayPal y, en la pantalla del pedido, enlaza con el pago en tu cuenta de PayPal (sandbox o producción).
On hold: el pago se ha autorizado y espera a ser capturado (acción de pago Authorize); o la captura está PENDING en PayPal, por ejemplo en revisión de pago; o el importe o la moneda pagados no coinciden con el pedido; o el pago no se pudo leer en la respuesta de PayPal. La nota del pedido lo explica.
Failed: PayPal ha rechazado la captura o la autorización.
Cancelled: la autorización se ha anulado con Void PayPal authorization.
Order actions
Abre el pedido, elige una acción en Order actions y haz clic en la flecha.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via PayPal (el botón muestra el título de tu método de pago). Se admiten reembolsos totales y parciales. El reembolso se envía al entorno de PayPal en el que se hizo el pago (sandbox o producción), así que hay que tener configuradas las credenciales de ese entorno. El motivo se transmite a PayPal como nota para el comprador. Si PayPal 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 y el estado del reembolso de PayPal; un reembolso PENDING lo completa PayPal más tarde.
Un pago que solo está autorizado no se puede reembolsar: usa Void PayPal authorization en su lugar. Los reembolsos, disputas y devoluciones realizados en tu cuenta de PayPal no se sincronizan con 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 > PayPal (Smart Buttons). 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, PayPal no se muestra a los clientes en la finalización de compra. Si se inicia un pago 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 reembolsos y las acciones sobre los pedidos siguen funcionando.
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
PayPal no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el Client ID y el Secret del modo seleccionado están rellenos, que PayPal admite la moneda de la tienda y que el total del carrito es superior a cero. La página de configuración muestra un aviso cuando el problema son las credenciales o la moneda. Una extensión del navegador que bloquee www.paypal.com también oculta el botón.
El pago se ha realizado, pero el pedido sigue en Pendiente de pago: el plugin no tiene webhook, así que el pago solo se confirma durante la finalización de compra. Esto ocurre cuando PayPal no respondió durante la captura. Lee la nota del pedido, comprueba el pago en tu cuenta de PayPal y completa el pedido manualmente, o deja que el cliente lo intente de nuevo: un reintento nunca cobra dos veces.
PayPal no está disponible en este momento: las credenciales son incorrectas o pertenecen al otro modo. Copia de nuevo el Client ID y el Secret de la aplicación correcta.
Tu aprobación de PayPal no se ha podido asociar a esta finalización de compra: el pedido de PayPal no se creó en esta sesión de finalización de compra, por ejemplo porque la sesión caducó. El cliente vuelve a pulsar el botón de PayPal.
El pedido está En espera tras el pago: lee la nota del pedido. El pago se autorizó (captúralo con Capture PayPal payment), la captura está PENDING en PayPal (usa Check PayPal payment status más tarde), o el importe o la moneda pagados no coincidían con el pedido.
La captura de una autorización falla: la autorización puede tener más de 29 días o ya estar anulada. La nota del pedido muestra el error de PayPal.
El reembolso falla: el pedido no tiene una captura de PayPal (solo una autorización), o faltan las credenciales del entorno en el que se realizó el pago. Los desarrolladores pueden cambiar la lista de monedas con el filtro wc_plg_supported_currencies.
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 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 tokens de acceso de PayPal en caché solo se eliminan si Delete data on uninstall estaba activado. En caso contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago, los ID de transacción y los ID de PayPal.
PayPal es una marca comercial de su respectivo propietario. Este plugin no está afiliado a PayPal ni cuenta con su respaldo.