VibeFox Autopay for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo.
PHP: 8.0 o posterior.
Servicio de Autopay: necesitas el Service ID y la Shared key (clave hash) de tu servicio de Autopay. Aparecen en el portal de comerciante de Autopay: portal.autopay.eu para producción y testportal.autopay.eu para pruebas. Los servicios de prueba tienen su propio Service ID y Shared key; pide a Autopay que abra uno. La función hash del servicio debe ser SHA-256.
Moneda: la moneda de la tienda debe ser PLN, EUR, GBP, USD o CZK, y estar aceptada por tu servicio de Autopay.
Tienda accesible: Autopay debe poder enviar notificaciones a tu tienda, así que debe ser accesible desde Internet, sin modo de mantenimiento, sin autenticación básica y sin un cortafuegos que bloquee las solicitudes POST.
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_autopay_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Autopay > 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 Service ID y la Shared key (prueba y producción) y elige las monedas de tu servicio.
6. En el portal de Autopay configura la URL de ITN, la URL de retorno y la función hash SHA-256 de tu servicio (consulta Configuración).
7. Activa Enable/Disable. Haz un pedido de prueba en modo de prueba y, después, desmarca Test mode para los pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Autopay. Encima de los campos, la página te avisa cuando el Service ID o la Shared key del entorno seleccionado están vacíos, y cuando la moneda de la tienda no está seleccionada en Currencies. En ambos casos el método de pago se oculta en la finalización de compra. En la lista de métodos de pago, Autopay aparece como pendiente de configuración hasta que el entorno seleccionado tenga credenciales.
General
Enable/Disable: Enable Autopay 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: Autopay.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.
Servicio de Autopay
El Service ID y la Shared key aparecen en el portal de comerciante de Autopay (portal.autopay.eu o testportal.autopay.eu).
Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. Por defecto: activado. Desactívalo para aceptar pagos reales en pay.autopay.eu con las credenciales de producción.
Service ID (production): el identificador numérico del servicio de portal.autopay.eu.
Shared key (production): la clave hash del servicio de producción. Mantenla en secreto.
Service ID (test): el identificador numérico del servicio de testportal.autopay.eu.
Shared key (test): la clave hash del servicio de prueba.
Currencies: las monedas que acepta tu servicio de Autopay: PLN, EUR, GBP, USD, CZK. Autopay suele abrir un servicio distinto por moneda. El método de pago solo se ofrece cuando la moneda del pedido está seleccionada aquí. Por defecto: PLN.
Notificaciones de pago (ITN) y dirección de retorno
Introduce estas direcciones en el portal de Autopay para tu servicio, tanto para producción como para pruebas. Las direcciones exactas aparecen en esta sección de los ajustes.
Sin la URL de ITN, los pedidos nunca se marcan como pagados. Cada ITN se comprueba con el hash SHA-256 generado con la Shared key del servicio correspondiente. Las notificaciones sin un hash válido o con un Service ID desconocido se rechazan. Una notificación solo se aplica a un pedido si el pago de ese pedido se inició con el mismo servicio de Autopay. Las notificaciones de pagos iniciados antes de cambiar Test mode se siguen verificando con la clave correcta.
El plugin gestiona estos estados de pago en la ITN:
Avanzado
Logging: Log payment events escribe en WooCommerce > Status > Logs, origen wcp_autopay_payment. Las claves y los datos de los clientes nunca se registran. Por defecto: desactivado.
Finalizar compra
El cliente elige el método de pago (por defecto, Autopay) y realiza el pedido. La página siguiente muestra Thank you for your order. You are being redirected to Autopay to complete the payment. y envía al cliente a la página de pago de Autopay. Si el cliente vuelve con el botón de retroceso del navegador, la página muestra el botón Pay with Autopay en lugar de redirigir de nuevo.
El plugin envía el total del pedido en la moneda del pedido, el número de pedido como descripción (Order y el número) y el correo electrónico de facturación del cliente. En la página de Autopay, el cliente elige el método de pago y paga.
Tras pagar, el cliente vuelve a la página de pedido recibido. La dirección de retorno va firmada, pero nunca cambia el estado del pedido. El pedido solo se marca como pagado cuando Autopay lo confirma con una ITN firmada y el importe y la moneda coinciden con el pedido.
Si el pago falla, el pedido pasa a Failed y el cliente puede volver a pagar desde el pedido con el enlace Pay. Si el pago no se puede iniciar, el cliente ve un mensaje breve, por ejemplo Autopay payments are not configured. Please choose another payment method or contact the store. o que Autopay no puede aceptar pagos en esta moneda.
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).
El plugin no admite reembolsos desde WooCommerce, ni suscripciones o pagos recurrentes, ni tarjetas guardadas (1-Click), ni código BLIK ni formulario de tarjeta en la finalización de compra, ni elección de banco o canal de pago en la finalización de compra, y usa un Service ID por entorno.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a Autopay y Autopay todavía no ha confirmado el pago.
Processing or Completed: Autopay confirmó el pago. WooCommerce asigna Processing, o Completed para pedidos que solo contienen productos virtuales descargables. La nota del pedido muestra el importe, la transacción de Autopay y la fecha del pago. El ID de la transacción es el ID de transacción de Autopay (RemoteID).
On hold: Autopay informó de un importe o una moneda distintos al total del pedido. El pedido no se marcó como pagado. Revisa la transacción en el portal de Autopay y complétala o reembólsala manualmente.
Failed: el pago falló. El cliente puede volver a pagar desde el pedido.
Un pedido pagado nunca se modifica por una notificación de fallo posterior. Si Autopay informa de otro pago correcto para un pedido ya pagado, una nota advierte de que el cliente puede haber pagado dos veces. Una notificación de un pago iniciado con otro servicio de Autopay no se aplica, y una nota lo explica.
Reembolsos
No se admiten reembolsos desde WooCommerce. Haz el reembolso del pago en el portal de Autopay y, después, regístralo en WooCommerce con un reembolso manual.
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 > Autopay. 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 comprobar el estado de nuevo, 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 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, Autopay 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 hayan 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 aviso 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
Autopay no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el entorno seleccionado tenga Service ID y Shared key, y que la moneda de la tienda esté seleccionada en Currencies. La página de ajustes muestra un aviso cuando falta alguno de estos datos.
El pago se realizó, pero el pedido sigue en Pending payment: Autopay no envió la ITN, o la tienda la rechazó. Comprueba que la URL de ITN que aparece en los ajustes esté configurada para el servicio en el portal de Autopay (producción o pruebas), que la función hash sea SHA-256 y que la Shared key del plugin coincida con el servicio. Comprueba que la tienda sea accesible desde Internet. Activa Logging y revisa WooCommerce > Status > Logs, origen wcp_autopay_payment.
El registro muestra ITN rejected: invalid hash: la Shared key no coincide con el servicio, o la función hash del servicio no es SHA-256.
El registro indica que el service ID no está configurado: la notificación llegó desde un servicio cuyo Service ID no está introducido en el plugin.
El pedido se puso en espera con una nota de discrepancia: Autopay informó de un importe o una moneda distintos al total del pedido. Revisa la transacción en el portal de Autopay y complétala o reembólsala manualmente.
Una nota indica que la notificación NO se aplicó: el pago de este pedido no se inició con este servicio de Autopay, por ejemplo una notificación de prueba para un pedido real. Revisa la transacción en el portal de Autopay.
Tras pagar, el cliente llega a la página de inicio: la dirección de retorno no se pudo verificar, por ejemplo porque el Service ID no está introducido en el plugin. El estado del pedido no se ve afectado; sigue a la ITN.
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 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 eliminarlo, desactívalo y bórralo en la página Plugins. Se eliminan siempre la clave de licencia y el estado de licencia de este plugin, así como los ajustes de la pasarela. El plugin no tiene ninguna opción para conservar los ajustes. Los pedidos existentes conservan sus notas de pago e ID de transacción.
Autopay es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Autopay ni cuenta con su respaldo.