VibeFox Barion for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo se niega a instalarse en versiones anteriores de PHP.
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 tu tienda. Las credenciales de prueba y de producción son distintas.
Moneda: la moneda del carrito debe ser HUF, EUR, USD o CZK. Para otras monedas, el método de pago no se muestra 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 cortafuegos ni autenticación básica delante.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
1. En el back office ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca más tarde VibeFox Barion Gateway en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página Configure, y haz clic en Activate (véase Clave de licencia).
4. Introduce la POSKey de prueba y el correo electrónico del monedero de prueba, deja Test Mode activado, activa Enable/Disable y haz clic en Save. Realiza un pedido de prueba.
5. Cuando todo funcione, introduce las credenciales de producción y desactiva 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.
Al instalarse, el módulo crea dos estados de pedido: Awaiting Barion payment y Barion payment on hold. PrestaShop ofrece un nuevo módulo de pago para todas las monedas, países y grupos de clientes. Puedes limitarlos en Payment > Preferences.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Barion Gateway > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Encima de los campos, la página te avisa cuando el modo actual no tiene POSKey o correo de beneficiario (entonces el método de pago se oculta en la finalización de compra) y cuando la moneda predeterminada de tu tienda no es compatible con Barion, con la lista de monedas admitidas. Mientras el modo de prueba está activado, muestra El modo de prueba está activado: los pagos van al entorno de pruebas de Barion (api.test.barion.com) y no se cobra dinero real.
Barion
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. También es el nombre del método de pago guardado en el pedido. Por defecto: Barion. Obligatorio.
Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.
Barion shop credentials
Consigue tu POSKey y el correo de tu monedero en el portal de Barion: secure.barion.com (producción) o secure.test.barion.com (pruebas), My stores, tu tienda. El modo de prueba usa solo las credenciales de prueba, y el modo de producción solo las de producción.
Test Mode: usa las credenciales de prueba indicadas abajo y el entorno de pruebas de Barion (api.test.barion.com). No se cobra dinero real. Por defecto: activado. Desactívalo para aceptar pagos reales. Mientras está activado, los clientes ven Modo de prueba: no se cobra ningún pago real. bajo el método de pago.
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 prueba 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.
Las POSKey guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Guardada: déjalo vacío para conservarla. Escribe un valor nuevo solo si quieres cambiarlo.
Clear saved POSKeys: marca una clave y haz clic en Save para eliminarla. Un campo vacío conserva el valor guardado.
Callback URL: la dirección que Barion llama después de cada pago, por ejemplo https://your-shop/module/wcp_barion_gateway/callback con URLs amigables, posiblemente con un código de idioma como /en/. Se envía a Barion con cada pago, así que no hay nada que configurar. Solo tiene que ser accesible desde internet.
Orders
Order Status After Payment: el estado del pedido que se asigna tras un pago correcto y verificado.
Los pagos que Barion todavía procesa esperan en Awaiting Barion payment. Los importes o monedas que no coinciden siempre van a Barion payment on hold.
Advanced
Logging: escribe las peticiones y los callbacks de Barion en logs/barion_p_debug.log.php, en la carpeta del módulo. El archivo no se puede abrir desde la web. Las claves secretas y los correos de los monederos no se registran. Por defecto: desactivado. Mientras está desactivado no se escribe nada, tampoco los errores.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Delete Data on Uninstall: cuando está activado, al desinstalar el módulo se eliminan sus ajustes y el registro. Los pedidos, sus datos de pago de Barion y los estados de pedido siempre se conservan. Por defecto: desactivado.
Finalizar compra
En el paso de pago, el cliente elige el método de pago (por defecto Barion) y ve la nota Serás redirigido a la página de pago segura de Barion. Tras confirmar, el módulo inicia un pago de Barion por el total del carrito en la moneda del carrito y envía al cliente a la página de pago de Barion. Los productos, el envío, el envoltorio de regalo y los impuestos aparecen en el pago; el pago figura como Cart con el número del carrito; el correo electrónico del cliente se pasa como sugerencia, y el idioma de la página sigue al idioma del carrito cuando Barion lo admite. Todavía no existe ningún pedido en este punto.
Tras pagar, el cliente vuelve a tu tienda, y Barion también llama a la URL de callback. Ninguna de las dos peticiones marca nada como pagado por sí sola: el módulo pide a Barion el estado del pago con la POSKey del modo en el que se inició. El pedido se marca como pagado solo después de que Barion lo confirme, y solo si el importe y la moneda coinciden con el carrito. El enlace de retorno contiene la clave segura del carrito, y solo se comprueban los pagos iniciados para ese carrito.
Si el pago se realizó correctamente, el pedido se crea y el cliente ve la página estándar de confirmación del pedido con Tu pago con Barion ha sido recibido. Si el pago sigue en curso en Barion, el pedido se crea en Awaiting Barion payment y la página muestra Tu pago está siendo confirmado por Barion. Recibirás un correo electrónico en cuanto se confirme. Si más tarde ese pago se cancela, caduca o falla en Barion, la página muestra Tu pago con Barion no se completó. Ponte en contacto con nosotros sobre este pedido. Si no se puede contactar con Barion cuando el cliente vuelve, aparece una página Confirmación del pago con el mismo texto de «siendo confirmado» y un botón Check again; el callback crea el pedido en cuanto Barion confirme el pago.
Si el pago no se completó (cancelado, caducado o fallido), no se crea ningún pedido, el carrito se conserva y el cliente vuelve a la finalización de compra con El pago no se completó. Inténtalo de nuevo. El cliente puede volver a intentarlo. Cada intento queda registrado, de modo que un pago tardío de un intento anterior sigue creando el pedido, y un intento anterior que caduca no cancela un pedido de un intento más reciente.
Si el pago no se puede iniciar, el cliente se queda en la finalización de compra con un mensaje breve: No se pudo iniciar el pago con Barion. Inténtalo de nuevo o elige otro método de pago., Barion no admite pagos en la moneda del carrito, o Barion no puede procesar un pedido con un total de cero. Los detalles se escriben en el registro si Logging está activado.
El callback funciona mientras la tienda está en modo de mantenimiento y no se bloquea con la restricción por país de tu tienda.
El módulo acepta solo pagos inmediatos. No admite pagos con reserva ni con captura diferida, suscripciones ni pagos recurrentes, tarjetas guardadas, Barion Pixel ni datos adicionales de 3-D Secure; Barion gestiona el 3-D Secure en su página de pago.
Pedidos y reembolsos
Order statuses
No order yet: el cliente fue enviado a Barion y no ha pagado, o Barion todavía no ha confirmado el pago. Solo existe el carrito.
Awaiting Barion payment: Barion informa de que el pago sigue en curso. Una nota muestra el PaymentId de Barion, el importe y, en modo de prueba, (test mode). El pedido pasa a «Pago aceptado» cuando Barion confirma el pago.
Payment accepted or Delivered: Barion confirmó el pago. El estado sigue a Order Status After Payment. El pago se registra con el ID de transacción de Barion, y una nota muestra el importe, el PaymentId y la transacción.
Barion payment on hold: Barion informó de un importe o una moneda distintos del total del pedido, por ejemplo porque el carrito se cambió después de iniciar el pago. La nota muestra ambos importes. Revisa el pago en el portal de Barion y luego tramita el pedido o reembolsa el pago en el portal de Barion.
Canceled: el último intento de pago de un pedido pendiente fue cancelado o caducó en Barion.
Payment error: el último intento de pago de un pedido pendiente falló.
Refunded: el pago se reembolsó por completo a través del módulo.
Si un pago del pedido sigue siendo correcto después de que el pedido se cancelara o fallara, el pedido pasa a pagado. Un pedido pagado o reembolsado nunca se modifica por un callback posterior. Si otro pago tiene éxito en un pedido pagado, una nota te pide que lo compruebes en el portal de Barion y lo reembolses si es un duplicado. Las notas son mensajes privados en la página del pedido.
Bloque de pago de Barion
La página del pedido muestra un bloque Barion payment con el PaymentId, la transacción de Barion, el estado del pago, el importe pagado y reembolsado, una insignia Test mode para los pagos de prueba y el historial de reembolsos.
Refunds
En el bloque Barion payment introduce el importe (se rellena el importe que aún no se ha reembolsado), opcionalmente un motivo, y haz clic en Refund via Barion. Confirma la pregunta ¿Reembolsar este importe a través de Barion? Esta acción no se puede deshacer. Se admiten reembolsos totales y parciales. Necesitas el derecho a editar pedidos. El motivo 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 hizo el pago, así que la POSKey de ese modo debe estar configurada. Si Barion no acepta o no confirma el reembolso, el bloque muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas, con la transacción y el estado de Barion. Un reembolso total pone el pedido en Refunded. Un reembolso parcial no cambia el estado.
Los reembolsos están disponibles cuando Barion ha confirmado el pago y el pedido está pagado por él. Un pago con diferencia de importe o de moneda no se puede reembolsar desde PrestaShop; reembólsalo en el portal de Barion. El módulo no crea notas de crédito, y los botones de reembolso estándar de PrestaShop en la página del pedido no devuelven dinero a través de Barion.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Barion Gateway es el primer bloque de Modules > Module Manager > VibeFox Barion Gateway > Configure, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-payment-barion y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on con una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda 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. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el método de pago también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez a la semana. No hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
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 POSKey y correo de beneficiario (la página de ajustes muestra un aviso si falta alguno) y que la moneda del carrito sea HUF, EUR, USD o CZK. En Payment > Preferences comprueba que el módulo esté permitido para la moneda del carrito, el país del cliente y el grupo del cliente.
El pago se realizó, pero no se creó ningún pedido: el pedido se crea 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 cortafuegos ni autenticación básica delante de la URL de callback). Comprueba que la POSKey del modo en el que se hizo el pago sea correcta, porque el módulo pide con ella el estado del pago a Barion. Activa Logging para ver el callback.
El callback responde Busy, retry: el pedido estaba siendo procesado por el retorno del cliente en ese mismo momento, o no se pudo crear el pedido (por ejemplo, porque el módulo está desactivado). Barion vuelve a llamar. Activa Logging para ver el motivo.
El callback responde API error: la tienda no pudo leer el estado del pago en Barion, o la POSKey del modo en el que se hizo el pago no está configurada. Comprueba esa POSKey.
El callback responde Order not found: el PaymentId no fue iniciado por esta tienda. Las llamadas de Barion de otras tiendas o de sistemas de prueba se ignoran.
El cliente ve «Error en la verificación del pago»: el enlace de retorno no coincide con el carrito, por ejemplo porque se abrió en otra sesión del navegador o se editó. El estado del pago sigue siendo confirmado por el callback.
El cliente ve un error al elegir Barion: activa Logging y revisa el campo Log de la página del módulo. Una POSKey o un correo de beneficiario incorrectos dan No se pudo iniciar el pago con Barion.
El pedido está en Barion payment on hold: lee la nota de diferencia en el pedido, revisa el pago en el portal de Barion y luego tramita el pedido o reembólsalo en el portal de Barion.
¿Por qué no puedo reembolsar 10,50 HUF?: Barion procesa el HUF sin decimales. Introduce un importe entero.
El reembolso indica que la POSKey de Barion para el modo de este pedido no está configurada: el pago se hizo en modo de prueba o de producción, y la POSKey de ese modo está vacía. Introdúcela e inténtalo de nuevo.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Barion Gateway y elige Uninstall. La clave de licencia y el estado de la licencia de este módulo siempre se eliminan. Si Delete Data on Uninstall está activado, se eliminan los ajustes del módulo y el registro. Si está desactivado, todos los ajustes se conservan para una reinstalación posterior. Los datos de pago de Barion de los pedidos y los estados de pedido Awaiting Barion payment y Barion payment on hold siempre se conservan, de modo que los pedidos pagados antes se pueden reembolsar tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Barion es una marca comercial de su respectivo titular. Este módulo no está afiliado ni respaldado por Barion.