VibeFox eWAY for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo.
PHP: 8.0 o posterior.
Moneda de la tienda: AUD, NZD, SGD, HKD o MYR. Para otras monedas, el método de pago se oculta en la finalización de compra. El pedido se cobra en su propia moneda.
Cuenta de eWAY: necesitas una cuenta de comerciante de eWAY con acceso a la API Rapid y su clave y contraseña de la API Rapid, que obtienes en MyeWAY, en Settings, API Key. Para las pruebas necesitas una cuenta de sandbox de eWAY con su propia clave y contraseña. Las claves de sandbox y de producción son distintas. No hay que configurar nada en eWAY: la URL de retorno se envía con cada pago.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_eway_payment_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > eWAY > Manage, o haz clic en Settings debajo del 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 tu clave y contraseña de la API de sandbox, deja activado Sandbox Mode, activa Enable/Disable y haz un pedido de prueba con la tarjeta de prueba de eWAY 4444333322221111.
6. Introduce tu clave y contraseña de la API de producción, desmarca Sandbox Mode y guarda los cambios.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > eWAY. Encima de los campos, una insignia indica el modo: SANDBOX (los pagos van al sandbox de eWAY y no se cobra dinero real) o LIVE (los pagos reales se cobran con la clave de API de producción). La página avisa cuando faltan la clave o la contraseña de la API del modo actual (en ese caso la pasarela no se muestra en la finalización de compra) y cuando la moneda de la tienda no es compatible. En la lista de métodos de pago, eWAY aparece marcado como pendiente de configuración hasta que el modo actual tenga credenciales, y muestra una insignia de modo de prueba en el modo sandbox.
General
Enable/Disable: Enable eWAY Payment Gateway activa o desactiva el método de pago. Predeterminado: desactivado.
Title: el nombre del método de pago que ven los clientes en la finalización de compra. Predeterminado: Credit Card (eWAY).
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Predeterminado: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.
Credenciales de API
La clave y la contraseña de la API Rapid están en MyeWAY, en Settings, API Key. eWAY tiene guías para las claves de producción y de sandbox, enlazadas en esta sección. Sandbox y producción usan claves distintas.
Sandbox Mode: Enable sandbox (test) mode envía los pagos al sandbox de eWAY con la clave de sandbox. No se cobra dinero real. Predeterminado: activado. Desmárcalo para cobrar pagos reales con la clave de producción.
Live API Key: la clave de la API Rapid de tu cuenta de producción de eWAY.
Live API Password: la contraseña de la API Rapid de tu cuenta de producción de eWAY.
Sandbox API Key: la clave de la API Rapid de tu cuenta de sandbox (partner/developer) de eWAY.
Sandbox API Password: la contraseña de la API Rapid de tu cuenta de sandbox de eWAY.
Pedidos
Order Status on Success: el estado del pedido una vez que eWAY confirma el pago.
Avanzado
Debug log: Enable logging escribe las llamadas a la API y los resultados de pago en WooCommerce > Status > Logs, origen wcp_eway_payment_gateway. Los datos de tarjeta y las claves no se registran. Los errores siempre se registran. Predeterminado: desactivado.
Uninstall: Delete all plugin data on uninstall. Si esta opción está marcada, los ajustes de la pasarela y sus registros se eliminan al borrar el plugin. Las referencias de pago guardadas en los pedidos se conservan. Predeterminado: desactivado.
Finalización de compra
El cliente elige el método de pago (de forma predeterminada Credit Card (eWAY)) y realiza el pedido. El plugin pide a eWAY una página de pago por el importe total del pedido en la moneda del pedido, con el ID del pedido como referencia de factura y los datos de facturación del cliente, y envía al cliente a la Responsive Shared Page de eWAY. Allí el cliente paga con tarjeta. El pago se cobra de inmediato.
Después de pagar, el cliente vuelve a tu tienda. El plugin no se fía del navegador: pide a eWAY, de servidor a servidor, el resultado de la página de pago que creó este pedido. El pedido se marca como pagado solo cuando eWAY lo confirma y el importe y la moneda aprobados coinciden con el pedido. Entonces el cliente llega a la página de pedido recibido. Si en ese momento no se pudo consultar a eWAY, el pedido sigue en «Pendiente de pago» y la página muestra We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. El pago se vuelve a comprobar al abrir la página de pedido recibido y antes de que WooCommerce cancele automáticamente el pedido no pagado.
Si el pago es rechazado, el cliente vuelve a la finalización de compra (o a la página Pay for order) con el motivo, por ejemplo Your payment was declined: Insufficient funds. Please try again or use a different payment method. Si el cliente pulsa el botón Cancel en la página de eWAY, el plugin primero comprueba con eWAY que no se haya cobrado nada. Un pedido realizado en la finalización de compra se cancela entonces, y un pedido pagado desde la página Pay for order sigue sin pagar. El cliente ve You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. Si el pago no se completó, el mensaje es The payment was not completed. Please try again.
Un cliente puede volver a pagar un pedido no pagado. Se registra cada página de pago del pedido, así que también se reconoce el pago de una página anterior. Si eWAY no puede crear la página de pago, el cliente ve un mensaje breve, por ejemplo Payment error: Unable to connect to eWAY. Please try again.
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).
eWAY no envía notificaciones de servidor a servidor para la Shared Page: el resultado se obtiene cuando el cliente vuelve y en las comprobaciones descritas arriba. El plugin no tiene campos de tarjeta en tu sitio, ni tarjetas guardadas ni suscripciones, ni autorización y captura por separado, y no evalúa las puntuaciones de fraude de Beagle (las transacciones bloqueadas por las reglas antifraude de eWAY las rechaza el propio eWAY).
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a eWAY y aún no ha pagado, o el resultado todavía no se pudo obtener de eWAY (la nota del pedido lo indica).
Processing or Completed: el pago fue aprobado. El estado sigue a Order Status on Success. La nota del pedido muestra el ID de transacción de eWAY, el código de autorización y la respuesta. El ID de transacción del pedido es el ID de transacción de eWAY.
On hold after payment: eWAY aprobó un importe o una moneda distintos de los del pedido (por ejemplo Approved for partial amount, o el pedido se editó después de que el cliente abriera la página de pago), o el pago se aprobó después de que el pedido se hubiera cancelado. La nota lo explica. En la página de pedido recibido el cliente ve Your payment was received and is being reviewed by the store. We will contact you if anything is needed. Completa el pedido o reembolsa el pago.
Failed: eWAY rechazó el pago. La nota muestra el código de eWAY y su significado.
Cancelled: el cliente canceló en la página de eWAY después de realizar el pedido en la finalización de compra, o el pedido fue cancelado por ti o por el tiempo de espera de retención de existencias de WooCommerce, después de que eWAY confirmara que no se había pagado.
Si se aprueba un segundo pago para un pedido que ya está pagado, el pedido no cambia. Una nota te pide reembolsar el duplicado en MyeWAY.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit Card (eWAY) (el botón usa el título del método de pago). Se admiten reembolsos totales y parciales. El reembolso se envía en el entorno en el que se hizo el pago (sandbox o producción), así que deben estar configuradas la clave y la contraseña de la API de ese entorno. Si eWAY rechaza el reembolso, WooCommerce muestra el código de eWAY y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID de transacción del reembolso de eWAY.
Los reembolsos hechos en MyeWAY no se sincronizan con WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce sin usar el botón de reembolso de eWAY.
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 > eWAY. 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 solo dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, eWAY 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 con sesión iniciada 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 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 se siguen confirmando y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
eWAY does not appear at checkout: comprueba que la licencia esté activa, que Enable/Disable esté activado, que la clave y la contraseña de la API del modo actual estén configuradas (los campos de sandbox en el modo sandbox y los de producción en el modo de producción) y que la moneda de la tienda sea AUD, NZD, SGD, HKD o MYR. En la página Pay for order se comprueba la moneda del pedido.
The payment went through, but the order stays Pending payment: el cliente no volvió desde eWAY, o no se pudo consultar a eWAY en ese momento. eWAY no envía notificaciones para la Shared Page. El pago se vuelve a comprobar al abrir la página de pedido recibido y antes de que WooCommerce cancele el pedido no pagado. Revisa la transacción en MyeWAY y mira WooCommerce > Status > Logs, origen wcp_eway_payment_gateway.
El cliente ve el mensaje This payment method is temporarily unavailable: falta la clave o la contraseña de la API del modo actual, o eWAY las ha rechazado. Comprueba las credenciales del modo actual.
El cliente ve el mensaje eWAY could not start the payment: eWAY devolvió códigos de error, que se muestran en el mensaje. A menudo los datos de facturación no son válidos.
El cliente ve el mensaje We could not match this payment to an order: el enlace de retorno no pertenece a ningún pedido de esta tienda. Si el cliente fue cobrado, busca el pago en MyeWAY.
El cliente ve el mensaje We could not confirm your payment with eWAY: no se pudo comprobar el resultado del pago. El pedido se actualiza cuando se obtiene el resultado; el cliente no debe volver a pagar.
Order is On hold after payment: lee la nota del pedido. El importe o la moneda aprobados eran distintos de los del pedido, o el pago llegó después de que el pedido se cancelara. Completa el pedido o reembolsa el pago.
El reembolso falla con un mensaje sobre el modo sandbox o producción: el pedido se pagó en ese entorno, y su clave y contraseña de la API no están configuradas. Introdúcelas e inténtalo de nuevo.
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 conectar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Para desarrolladores, el archivo readme incluye el filtro eway_p_supported_currencies, por si tu cuenta de eWAY tiene habilitadas más monedas.
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 licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros solo se eliminan si la opción Uninstall (Delete all plugin data on uninstall) estaba activada. Si no, se conservan para una futura reinstalación. Las referencias de pago guardadas en los pedidos siempre se conservan. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
eWAY es una marca comercial de su respectivo titular. Este plugin no está afiliado a eWAY ni cuenta con su aprobación.