VibeFox EveryPay for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo.

PHP: 8.0 o posterior.

Cuenta de EveryPay: necesitas el nombre de usuario de la API, la clave secreta de la API y el nombre de la cuenta de procesamiento de tu tienda online. Están en el Merchant Portal de EveryPay, en la configuración de tu tienda: el portal de demostración (mwt-demo.every-pay.com) para el modo de prueba, y el portal de producción (portal.every-pay.eu) para los pagos reales. Los entornos de prueba y de producción tienen credenciales independientes. También debes configurar la URL de callback de tu tienda en ambos portales (véase Configuración).

Moneda de la tienda: la cuenta de procesamiento define la moneda de cobro; por ejemplo, EUR3D1 cobra en EUR. El método de pago solo se ofrece para los pedidos en esa moneda.

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_everypay_payment a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > EveryPay > 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 el nombre de usuario de la API de prueba, la clave secreta de la API de prueba y el nombre de la cuenta de procesamiento del Merchant Portal de demostración. Deja activado Test Mode.

6. Copia la URL de callback que aparece en la página de configuración en Callback notification URL de tu tienda online en el Merchant Portal.

7. Activa Enable/Disable y haz un pedido de prueba. Cuando todo funcione, introduce las credenciales de producción, configura también la URL de callback en el portal de producción y desmarca Test Mode.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > EveryPay. Encima de los campos, la página muestra Test mode is on: payments go to the EveryPay demo environment, no real money is charged. mientras el modo de prueba está activado. Avisa cuando la pasarela está activada pero falta el nombre de usuario de la API, la clave secreta de la API o la cuenta de procesamiento del modo actual (en ese caso el método de pago no se muestra en la finalización de compra), y cuando la cuenta de procesamiento cobra en una moneda distinta a la de la tienda. En la lista de métodos de pago, EveryPay aparece como pendiente de configuración hasta que se configure el modo actual. Los espacios y saltos de línea pegados junto con las credenciales se eliminan al guardar.

General

Enable/Disable: Enable EveryPay payment gateway activa o desactiva el método de pago. Por defecto: desactivado.

Title: el nombre del método de pago que ven los clientes en la finalización de compra. Por defecto: EveryPay.

Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely by card or bank link on the EveryPay payment page.

Cuenta de EveryPay

El nombre de usuario de la API, la clave secreta de la API y el nombre de la cuenta de procesamiento aparecen en el Merchant Portal de EveryPay (configuración de la tienda online): el portal de demostración para el modo de prueba y el portal de producción para los pagos reales.

Test Mode: Enable test mode envía los pagos al entorno de demostración de EveryPay con las credenciales de prueba. No se cobra dinero real. Por defecto: activado.

Test API Username: el nombre de usuario de la API del entorno de demostración.

Test API Secret: la clave secreta de la API del entorno de demostración.

Live API Username: el nombre de usuario de la API del entorno de producción.

Live API Secret: la clave secreta de la API del entorno de producción.

Processing Account Name: la cuenta de procesamiento de EveryPay, por ejemplo EUR3D1. La cuenta define la moneda de cobro: la pasarela solo se ofrece para los pedidos en esa moneda. Se usa el mismo nombre de cuenta en ambos modos.

Notificaciones de pago (callback)

El callback indica a tu tienda que un pago se ha finalizado, de modo que los pedidos se actualizan aunque el cliente cierre el navegador. Copia la URL que aparece en esta sección en Callback notification URL de tu tienda online en el Merchant Portal de EveryPay, tanto en el de demostración como en el de producción. La URL tiene este aspecto: https://your-site/wc-api/wc_evp_payment/. La solicitud de pago no incluye ninguna URL de callback, por lo que hay que configurarla en el portal.

El callback solo contiene referencias de pago. Cuando llega, el plugin consulta a la API de EveryPay el estado del pago en el entorno en el que se creó y comprueba que la respuesta pertenece a este pedido. Los callbacks de un pago que el pedido no creó se rechazan. Sin el callback, un pedido se confirma cuando el cliente vuelve a la tienda después de pagar, o cuando ejecutas Check EveryPay payment status en el pedido.

Avanzado

Debug log: Log payment events escribe los eventos de pago en WooCommerce > Status > Logs, origen wcp_everypay_payment. Los errores siempre se registran. Las claves secretas de la API y los datos de la tarjeta nunca se registran. 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, EveryPay) y realiza el pedido. En modo de prueba, la finalización de compra muestra TEST MODE: EveryPay demo environment, no real money is charged. El plugin crea un pago único de EveryPay por el total del pedido, con el correo electrónico y los datos de facturación del cliente, y envía al cliente a la página de pago de EveryPay. El idioma de la página sigue el idioma del sitio (inglés, estonio, ruso, letón, lituano, finés o alemán; en otro caso, inglés). Allí el cliente paga con uno de los métodos activados en tu cuenta de EveryPay.

Tras pagar, el cliente vuelve a tu tienda. El pedido solo se marca como pagado después de que EveryPay lo confirme: el plugin consulta a la API de EveryPay el estado del pago al volver a la tienda y en el callback. Un pedido pagado, un pedido en revisión o un pago que todavía se está procesando lleva a la página de pedido recibido.

Si el pago falla, el cliente vuelve a la finalización de compra (o a la página Pay for order) con el mensaje Your EveryPay payment was not successful. Please try again or choose another payment method. Si el cliente sale de la página de pago sin pagar, el mensaje es The EveryPay payment was not completed. You can try again or choose another payment method. Cada nuevo intento crea un nuevo pago de EveryPay; los intentos anteriores se tienen en cuenta, así que un pago hecho con un enlace anterior se sigue reconociendo.

Si EveryPay no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. Los detalles están en el registro.

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). Los textos que ve el cliente están traducidos al estonio.

El plugin solo admite pagos únicos. No ofrece reembolsos ni capturas desde WooCommerce, ni tarjetas guardadas o pagos con un clic, ni suscripciones o pagos recurrentes, ni campos de tarjeta integrados, y no admite varias monedas.

Pedidos

Estados del pedido

Pending payment: el cliente fue enviado a EveryPay y aún no ha pagado, o el pago todavía se está procesando.

Processing: EveryPay informó de que el pago está liquidado o autorizado (los pedidos que contienen solo productos virtuales descargables pasan a Completado, el valor por defecto de WooCommerce). La nota del pedido muestra el importe, la moneda y la referencia del pago. El ID de transacción del pedido es la referencia de pago de EveryPay. En un pago autorizado, la nota indica que los fondos están reservados: si tu cuenta no captura automáticamente, captura el pago en el Merchant Portal de EveryPay. Cuando después se liquide, una nota lo indica.

On hold after payment: el pago necesita revisión manual. El importe o la moneda pagados no coinciden con el pedido, el pedido se había cancelado antes de que llegara el pago, o el pedido usa ahora otro método de pago. La nota lo explica e indica que el pedido no se marcó como pagado. Revisa el pago en el Merchant Portal y complétalo o reembólsalo manualmente. Los callbacks posteriores de este pago no completan el pedido automáticamente.

Failed: el último intento de pago de un pedido no pagado falló, se abandonó o se anuló. La nota muestra el motivo indicado por EveryPay. El cliente puede volver a intentarlo.

Si se completa un segundo pago de un pedido que ya está pagado, el pedido no cambia. Una nota te pide que reembolses el pago duplicado en el Merchant Portal de EveryPay.

Check EveryPay payment status

En la pantalla del pedido, elige la acción del pedido Check EveryPay payment status. El plugin comprueba con la API cada pago de EveryPay del pedido, aplica el resultado tal como se ha descrito arriba y añade una nota con el estado de cada pago. Úsala para los pedidos cuyo callback nunca llegó.

Reembolsos

No se admiten reembolsos desde WooCommerce. Reembolsa en el Merchant Portal de EveryPay y después cambia el estado del pedido en WooCommerce. Cuando EveryPay informa de que un pago está reembolsado o contracargado, el plugin solo añade una nota al pedido; el estado del pedido no cambia.

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 > EveryPay. 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 eliminarla 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. 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, EveryPay 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 han 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 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 y la comprobación del estado funciona.

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

EveryPay no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el nombre de usuario de la API, la clave secreta de la API y el Processing Account Name del modo actual están configurados, y que la moneda de la tienda (en la página Pay for order, la moneda del pedido) es la moneda de la cuenta de procesamiento. La página de configuración muestra un aviso en estos casos.

El pago se ha realizado, pero el pedido sigue en Pending payment: el callback no funciona. Comprueba que la URL de callback de la configuración está puesta como Callback notification URL en el Merchant Portal del modo que utilizas (demostración o producción). También puedes abrir el pedido y ejecutar Check EveryPay payment status. Activa Debug log y mira en WooCommerce > Status > Logs, origen wcp_everypay_payment.

El callback responde Unknown payment reference o Payment does not belong to this order: el pago no lo creó este pedido, o la respuesta de EveryPay no coincide con él. El pedido no cambia.

El callback responde Not configured: faltan las credenciales del entorno en el que se creó el pago, por ejemplo, un pago de prueba después de que se eliminaran las credenciales de prueba. Introdúcelas de nuevo; EveryPay vuelve a intentar el callback.

El callback responde Payment status unavailable o Busy, please retry: no se pudo contactar con la API de EveryPay, o el pedido se estaba actualizando con otra solicitud en ese mismo momento. EveryPay vuelve a intentar el callback.

El cliente ve EveryPay is temporarily unavailable: EveryPay rechazó las credenciales o no se pudo contactar con EveryPay. Comprueba el nombre de usuario de la API y la clave secreta de la API del modo actual.

El cliente ve This payment method does not support the order currency: la moneda del pedido no coincide con la moneda de la cuenta de procesamiento.

El pedido está On hold after payment: lee la nota del pedido. El importe o la moneda no coincidían, o el pedido se había cancelado antes de que llegara el pago. Revisa el pago en el Merchant Portal y complétalo o reembólsalo manualmente.

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.

Para desarrolladores, la documentación del plugin enumera los filtros wc_evp_icon, wc_evp_locale, wc_evp_currency_decimals y wc_evp_oneoff_request.

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. La configuración de la pasarela y los registros solo se eliminan si Uninstall (Delete the gateway settings and logs when the plugin is deleted) estaba activado. Si no, se conservan para una reinstalación posterior. Las referencias de pago de EveryPay guardadas en los pedidos siempre se conservan. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.

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