VibeFox PayFast for WooCommerce — Ayuda
Requisitos
WordPress: 6.2 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Moneda: rand sudafricano (ZAR), configurado en WooCommerce > Settings > General. PayFast liquida solo en rand. El importe mínimo del pedido es R5.00.
Cuenta de PayFast: el Merchant ID y la Merchant Key de tu cuenta de PayFast, en Settings > Developer Settings del panel de PayFast. Se recomienda encarecidamente una passphrase; si está configurada en PayFast, la misma passphrase debe introducirse en el plugin. Para las pruebas necesitas las credenciales del sandbox de PayFast.
Sitio accesible: la URL de notificación de pago debe ser accesible desde Internet, sin modo de mantenimiento, autenticación básica ni bloqueo de cortafuegos.
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_payfast_pay a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Configura la moneda de la tienda como rand sudafricano en WooCommerce > Settings > General.
4. Abre los ajustes: WooCommerce > Settings > Payments > PayFast > 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 el Merchant ID, la Merchant Key y la passphrase. Para las pruebas, deja Test mode activado e introduce tus credenciales de sandbox.
7. Activa Enable/Disable y guarda. Haz un pago de prueba y después desactiva el modo de prueba para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > PayFast. Encima de los campos, la página avisa cuando las credenciales del modo actual están vacías (PayFast se oculta entonces en la finalización de compra), cuando la moneda de la tienda no es ZAR, cuando el modo real usa el Merchant ID público de sandbox 10000100 y cuando no hay passphrase configurada, y muestra Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. mientras el modo de prueba está activado. En la lista de métodos de pago, PayFast aparece como pendiente de configuración hasta que se introducen el Merchant ID y la Merchant Key del modo actual.
General
Enable/Disable: Enable PayFast activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que ve el cliente en la finalización de compra. Por defecto: PayFast.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely by card, Instant EFT and other methods on the PayFast payment page.
Cuenta de PayFast (real)
Encuentra tu Merchant ID y tu Merchant Key en el panel de PayFast, en Settings > Developer Settings. Si configuraste una passphrase allí, introduce exactamente la misma passphrase aquí.
Merchant ID: tu Merchant ID real de PayFast.
Merchant Key: tu Merchant Key real de PayFast. Se envía a PayFast con cada formulario de pago.
Passphrase: la passphrase de sal de PayFast, en Settings > Developer Settings. Muy recomendable: firma los pagos y las notificaciones.
Sandbox (modo de prueba)
En modo de prueba, los pagos van al sandbox de PayFast y no se cobra dinero real. Las credenciales del sandbox se muestran después de iniciar sesión en el sandbox de PayFast (el comerciante de prueba público es 10000100 / 46f0cd694581a).
Test mode: Use the PayFast sandbox and the sandbox credentials below. En la finalización de compra el cliente ve TEST MODE: payments go to the PayFast sandbox, no real money is charged. Por defecto: activado.
Sandbox Merchant ID: el Merchant ID de tu cuenta de sandbox.
Sandbox Merchant Key: la Merchant Key de tu cuenta de sandbox.
Sandbox Passphrase: solo si hay una passphrase configurada en tu cuenta de sandbox.
Al actualizar desde la versión 1.0 en modo de prueba, tus credenciales existentes se copian a los campos del sandbox. Revisa las credenciales reales antes de desactivar el modo de prueba.
Notificaciones de pago (ITN)
PayFast confirma cada pago con una notificación de servidor a servidor a la URL que muestra esta sección. Tiene este aspecto: https://your-site/wc-api/payfast_pay/. La dirección se envía con cada pago, así que no hay que configurar nada en PayFast, pero debe ser accesible desde Internet.
Source check: Accept live notifications only from PayFast servers. Las direcciones proceden de los registros DNS de PayFast. Desactívalo solo si tu sitio está detrás de un proxy o CDN que oculta la dirección del visitante. La firma y la confirmación de servidor siempre se comprueban. Las notificaciones de sandbox no se comprueban por dirección. Por defecto: activado.
Avanzado
Debug log: Log payment steps escribe los pasos en WooCommerce > Status > Logs, origen wcp_payfast_pay. Los errores siempre se registran. No se escriben passphrases ni datos de clientes. Por defecto: desactivado.
Uninstall: Delete the gateway settings and logs when the plugin is deleted. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto PayFast) y realiza el pedido. El cliente va a la página Pay for order del pedido, que muestra Thank you for your order. You are being redirected to PayFast to complete the payment. y envía automáticamente el formulario de pago firmado a PayFast. Si el navegador no continúa por sí solo, el cliente hace clic en Pay with PayFast; Cancel order cancela el pedido. El formulario incluye el total del pedido en ZAR, Order # con el número del pedido, el nombre y el correo electrónico del cliente, y la clave del pedido. Se vuelve a construir cada vez que se abre la página, así que el cliente puede reabrirla al volver de PayFast.
En la página de PayFast, el cliente paga con tarjeta, Instant EFT u otro método de tu cuenta de PayFast. Después PayFast envía la notificación de pago (ITN) a tu tienda. El pedido solo se marca como pagado cuando la notificación supera todas las comprobaciones:
El regreso del cliente a la página de pedido recibido no cambia el pedido. Mientras no llegue la notificación, la página dice PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Si el pedido está en espera, dice Your payment is being reviewed. We will contact you if anything else is needed.
Si el cliente cancela en la página de PayFast, el pedido se cancela de la forma estándar de WooCommerce. Si el cliente se va sin pagar, el pedido sigue sin pagar y puede pagarse de nuevo desde la página Pay for order.
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. Se oculta cuando faltan las credenciales del modo actual, cuando la moneda de la tienda o del pedido no es ZAR, o cuando el total es inferior a R5.00. Es compatible con el almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.
El plugin solo acepta pagos únicos en ZAR. No admite reembolsos desde WooCommerce, ni suscripciones, ni tarjetas guardadas (tokenizadas), ni pedidos anticipados, ni pagos divididos.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a PayFast y la notificación de pago aún no ha llegado.
Processing: PayFast confirmó el pago. Es el estado estándar de WooCommerce después del pago; los pedidos que solo contienen productos virtuales descargables pasan a Completado. La nota del pedido muestra el ID de pago de PayFast, que también es el ID de transacción del pedido. Un pago en sandbox recibe la nota de que no se cobró dinero real. La comisión de PayFast y el importe neto se guardan en el pedido.
On hold: PayFast informó del pago como pendiente; o el importe pagado difiere del total del pedido, o el pedido no está en ZAR; o llegó un pago para un pedido que ya estaba cancelado. La nota del pedido lo explica. Revisa el pedido y tu panel de PayFast, y después envíalo o reembolsa el pago en PayFast.
Failed: PayFast informó del pago como fallido mientras el pedido estaba sin pagar. El cliente puede volver a pagar.
Cancelled: el cliente canceló en la página de PayFast, o tú cancelaste el pedido, o lo canceló el tiempo de reserva de existencias de WooCommerce.
Una notificación repetida del mismo pago no cambia nada. Si llega otro pago completado para un pedido que ya está pagado, una nota te pide reembolsar el duplicado en PayFast. Un pago para un pedido reembolsado solo añade una nota. Un pago en sandbox recibido mientras la pasarela está en modo real añade una nota y no marca el pedido como pagado.
Reembolsos
Los reembolsos desde WooCommerce no son compatibles. Reembolsa el pago en tu panel de PayFast y después crea un reembolso manual 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 > PayFast. 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, PayFast 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), así que puedes configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio 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.
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
PayFast no aparece en la finalización de compra: revisa que la licencia esté activa, que Enable/Disable esté activado, que el Merchant ID y la Merchant Key del modo actual estén completados, que la moneda de la tienda sea ZAR y que el total del pedido sea de al menos R5.00. La página de ajustes muestra un aviso cuando falta algo.
El pago se realizó, pero el pedido sigue en Pendiente de pago: PayFast no pudo entregar la notificación de pago, o fue rechazada. Activa el Debug log y revisa WooCommerce > Status > Logs, origen wcp_payfast_pay. Motivos habituales: el sitio no es accesible desde Internet (modo de mantenimiento, autenticación básica, cortafuegos), una passphrase distinta en PayFast y en el plugin, o, en modo real detrás de un proxy o CDN, la comprobación de origen. En ese caso, desactiva Source check.
La notificación responde Invalid signature: la passphrase del plugin no es la configurada en PayFast para este modo.
La notificación responde Invalid source: la notificación no procedía de una dirección de PayFast, o un proxy o CDN oculta la dirección real. Desactiva Source check si tu sitio está detrás de un proxy o CDN.
La notificación responde Merchant mismatch o Order mismatch: el pago se hizo a otra cuenta de PayFast o no pertenece a este pedido. No se cambia nada.
La notificación responde Confirmation unavailable o Busy: no se pudo contactar con PayFast para la confirmación de servidor, o otra notificación del mismo pedido se estaba procesando en ese momento. PayFast reintenta la notificación.
La notificación responde Not configured: faltan las credenciales del modo en el que se pagó el pedido.
El cliente ve PayFast accepts payments from R5.00: el total del pedido está por debajo del mínimo de PayFast.
El pedido está en On hold: PayFast confirmó un pago que no coincide con el pedido (importe distinto o moneda que no es ZAR), o el pago llegó para un pedido que ya estaba cancelado. Revisa las notas del pedido y tu panel de PayFast.
Un pago en sandbox no pagó el pedido: la pasarela está en modo real. Los pagos en sandbox nunca pagan un pedido en modo real; una nota en el pedido lo indica.
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 mantiene todos los datos. 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. Los ajustes de la pasarela, las demás opciones del plugin, las direcciones de PayFast en caché y sus registros solo se eliminan si Delete the gateway settings and logs when the plugin is deleted estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago e IDs de transacción.
PayFast es una marca comercial de su respectivo titular. Este plugin no está afiliado ni respaldado por PayFast.