VibeFox Barion for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. Sin WooCommerce, el plugin muestra un aviso en el área de administración y el método de pago no se carga.
PHP: 8.0 o posterior.
Tienda de Barion: necesitas la POSKey (clave secreta) de tu tienda y la dirección de correo electrónico del monedero de Barion que recibe los pagos. Ambas están en el portal de Barion: secure.barion.com para producción y secure.test.barion.com para pruebas, en My stores y en tu tienda. Las credenciales de prueba y de producción son distintas.
Moneda: la moneda de la tienda debe ser HUF, EUR, USD o CZK. Para otras monedas, el método de pago se oculta en la finalización de compra.
Tienda accesible: Barion llama a tu tienda después de cada pago, así que el sitio debe ser accesible desde Internet, sin modo de mantenimiento, cortafuegos ni autenticación básica delante de /wc-api/.
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_barion_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Barion > 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 la POSKey de prueba y el correo electrónico del monedero de prueba, deja activado Test Mode y activa Enable/Disable. Haz un pedido de prueba.
6. Cuando todo funcione, introduce las credenciales de producción y desmarca Test Mode.
La URL de callback se envía a Barion automáticamente con cada pago. No hay que configurar nada en el portal de Barion.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Barion. Si la moneda de la tienda no es compatible, la página lo indica en rojo en la sección Barion shop credentials y enumera las monedas admitidas; en ese caso el método de pago se oculta en la finalización de compra.
General
Enable/Disable: Enable Barion Payment 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: Barion.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.
Credenciales de la tienda de Barion
Obtén tu POSKey y el correo electrónico del monedero en el portal de Barion: secure.barion.com (producción) o secure.test.barion.com (pruebas), My stores, tu tienda. Esta sección también muestra la URL de callback, por ejemplo https://your-site/wc-api/barion_payment_callback/. Se envía a Barion con cada pago; solo tiene que ser accesible desde Internet.
Test Mode: Enable Barion test/sandbox mode. El modo de prueba usa las credenciales de prueba de abajo y el sandbox de Barion (api.test.barion.com); no se cobra dinero real. Por defecto: activado. Desmárcalo para aceptar pagos reales.
Test POSKey: la clave secreta (POSKey) de tu tienda en el sistema de pruebas de Barion (secure.test.barion.com, My stores).
Test Payee Email: la dirección de correo electrónico de tu monedero de pruebas de Barion que recibe los pagos de prueba.
Live POSKey: la clave secreta (POSKey) de tu tienda en el sistema de producción de Barion (secure.barion.com, My stores).
Live Payee Email: la dirección de correo electrónico de tu monedero de Barion que recibe los pagos.
Pedidos
Order Status After Payment: el estado del pedido que se asigna tras un pago correcto y verificado.
Avanzado
Logging: Enable debug logging. Los registros se guardan en WooCommerce > Status > Logs, origen wcp_barion_gateway. Las claves secretas nunca se registran. Por defecto: desactivado.
Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted. Los pedidos y sus datos de pago de Barion siempre se conservan. Por defecto: desactivado.
Finalizar compra
El cliente elige el método de pago (por defecto, Barion) y realiza el pedido. El plugin inicia un pago de Barion por el total del pedido en la moneda del pedido y envía al cliente a la página de pago de Barion. En el pago se enumeran los artículos del pedido, el envío, las tasas y los impuestos; el correo electrónico de facturación del cliente se pasa como sugerencia, y el idioma de la página sigue el idioma de la tienda cuando Barion lo admite.
Tras pagar, el cliente vuelve a tu tienda. Barion también llama a la URL de callback. Ninguna de las dos solicitudes marca por sí sola el pedido como pagado: el plugin pide a Barion el estado del pago con tu POSKey, y el pedido solo se marca como pagado cuando Barion lo confirma y el importe y la moneda coinciden con el pedido. El enlace de retorno contiene la clave del pedido, y solo se comprueban los pagos iniciados para ese pedido.
Si el pago se realizó correctamente o todavía está en curso en Barion, el cliente llega a la página de pedido recibido. Si no, vuelve a la finalización de compra y ve Payment was not completed. Please try again. El cliente puede volver a intentarlo; cada intento queda registrado, así que un pago tardío de un intento anterior sigue completando el pedido.
Si el pago no se puede iniciar, el cliente ve The Barion payment could not be started. Please try again or choose another payment method. Los gestores de la tienda que hayan iniciado sesión también ven el motivo técnico. Los detalles van al registro.
El método de pago funciona en la finalización de compra clásica y en el bloque de Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin admite solo pagos inmediatos. No tiene pagos con reserva ni con captura diferida, ni WooCommerce Subscriptions o pagos recurrentes, ni tarjetas guardadas, ni Barion Pixel, ni datos adicionales de 3-D Secure; Barion gestiona el 3-D Secure en su página de pago.
Pedidos y reembolsos
Estados del pedido
Pending payment: el pago de Barion se inició y Barion todavía no lo ha confirmado. La nota del pedido muestra el PaymentId de Barion, el importe y, en modo de prueba, (test mode).
Processing or Completed: Barion confirmó el pago. El estado sigue a Order Status After Payment. La nota del pedido muestra el importe, el PaymentId y la transacción. El ID de la transacción es el ID de transacción de Barion.
On hold: Barion informó de un importe o una moneda distintos al total del pedido, por ejemplo porque el pedido se editó después de iniciar el pago. Revisa el pago en el portal de Barion y complétalo o reembólsalo manualmente.
Cancelled: el último intento de pago fue cancelado o caducó en Barion.
Failed: el último intento de pago falló.
Un pedido pagado o reembolsado nunca se modifica con un callback posterior. Si otro pago se realiza correctamente para un pedido ya pagado, una nota te pide que lo revises en el portal de Barion y que lo reembolses si es un duplicado.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Barion. Se admiten reembolsos totales y parciales. El motivo del reembolso se envía a Barion como comentario. Los reembolsos en HUF deben ser importes enteros. El reembolso se envía en el modo (prueba o producción) en el que se pagó el pedido, así que la POSKey de ese modo debe estar configurada. Si Barion no acepta o no confirma 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 la transacción y el estado de Barion.
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 > Barion. 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, Barion 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 y los reembolsos funcionan.
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
Barion no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el modo actual tenga una POSKey y un correo electrónico del beneficiario, y que la moneda de la tienda sea HUF, EUR, USD o CZK.
El pago se realizó, pero el pedido sigue en Pending payment: el pedido se completa cuando Barion llama a la URL de callback o cuando el cliente vuelve a tu tienda. Asegúrate de que el sitio sea accesible desde Internet (sin modo de mantenimiento, cortafuegos ni autenticación básica delante de /wc-api/). Comprueba que la POSKey del modo en el que se pagó el pedido sea correcta, porque el plugin pide a Barion el estado del pago con ella. Activa Logging para ver el callback.
El callback responde Busy, retry: el pedido estaba siendo procesado por el retorno del cliente en el mismo momento. Barion vuelve a llamar.
El callback responde API error: la tienda no pudo leer el estado del pago desde Barion. Comprueba la POSKey del modo en el que se pagó el pedido.
Un pedido está On hold con una nota de discrepancia: el importe o la moneda que informa Barion no coinciden con el total del pedido. Revisa el pago en el portal de Barion y complétalo o reembólsalo manualmente.
¿Por qué no puedo reembolsar 10.50 HUF? Barion procesa HUF sin decimales. Introduce un importe entero.
El reembolso indica que la POSKey del modo de este pedido no está configurada: el pedido se pagó en modo de prueba o de producción, y la POSKey de ese modo está vacía. Introdúcela 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 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. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela se eliminan solo si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos y sus datos de pago de Barion siempre se conservan. Los pedidos existentes conservan sus notas de pago e ID de transacción.
Barion es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Barion ni cuenta con su respaldo.