VibeFox Paysera for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Proyecto de Paysera: necesitas el ID del proyecto y la contraseña del proyecto (clave de firma) de tu proyecto de Paysera. Los métodos de pago que ve el cliente son los habilitados en este proyecto. No hay que configurar nada en Paysera para el callback: su URL se envía con cada solicitud de pago.
Sitio accesible: los pedidos se pagan mediante el callback de Paysera, así que tu sitio debe ser accesible desde internet, sin estar protegido por un inicio de sesión, un modo de mantenimiento o un cortafuegos.
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_paysera_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Paysera > 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 el Project ID y la Project password de tu cuenta de Paysera (consulta Configuración).
6. Opcional: activa Allow test payments en el proyecto de Paysera y Test payments en el plugin para probar el flujo sin cobrar dinero. Desactívalo antes de empezar a vender.
7. Activa Enable/Disable y guarda los cambios.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Paysera. Encima de los campos, la página muestra Paysera se oculta en la finalización de compra hasta que se introduzcan el ID del proyecto y la contraseña del proyecto. mientras falte alguno de los dos, y un aviso de que no se cobra a los clientes mientras los pagos de prueba o el sandbox estén activados. En la lista de métodos de pago, Paysera aparece como pendiente de configuración hasta que el proyecto esté configurado, y muestra una insignia de modo de prueba cuando los pagos de prueba o el sandbox están activados.
General
Enable/Disable: Enable Paysera Payment activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que se muestra en la finalización de compra. Por defecto: Paysera.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely via Paysera.
Proyecto de Paysera
Encontrarás el ID del proyecto y la contraseña del proyecto en tu cuenta de Paysera, en Projects and activities, tu proyecto, General project settings. La sección muestra la URL del callback, que tiene este aspecto: https://your-site/wc-api/wc_psr_payment/. Se envía automáticamente con cada pago; no hay que configurar nada en Paysera.
Project ID: el ID numérico de tu proyecto de Paysera.
Project password: la contraseña del proyecto (clave de firma). Firma las solicitudes de pago y verifica los callbacks de Paysera.
Pruebas
Test payments: Send payments in test mode (no money is charged). Paysera devuelve un pago de prueba correcto sin cobrar al cliente. Activa antes Allow test payments en la configuración del proyecto de Paysera. Mientras esta opción esté activada, los pagos de prueba marcan los pedidos como pagados; cuando esté desactivada, un pago de prueba nunca paga un pedido. Por defecto: desactivado.
Environment: adonde se envía al cliente. Mantén Production para un proyecto normal de Paysera, también para los pagos de prueba. Por defecto: Production.
Avanzado
Debug log: Log payment events. Los errores siempre se registran. Los registros están en WooCommerce > Status > Logs, origen wcp_paysera_payment. Nunca se escriben contraseñas ni datos de clientes. Por defecto: desactivado.
Delete data: Delete the plugin settings and logs when the plugin is deleted. Desactivar el plugin nunca borra nada. Los datos de los pedidos siempre se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Paysera) y realiza el pedido. Con los pagos de prueba activados, la finalización de compra muestra MODO DE PRUEBA: no se cobrará dinero. El plugin crea una solicitud de pago firmada con el total del pedido en la unidad mínima de la moneda del pedido, el nombre, el correo electrónico y la dirección de facturación del cliente, y un idioma elegido según el idioma de tu sitio (lituano, letón, estonio, ruso, alemán, polaco o, en otro caso, inglés). El cliente es enviado a la ventana de pago de Paysera y allí elige un banco, una tarjeta u otro método.
Tras pagar, el cliente vuelve a la página de pedido recibido. El pedido se marca como pagado solo cuando llega el callback firmado de Paysera; el regreso en sí nunca paga un pedido.
Si el cliente cancela en la ventana de Paysera, el pedido se cancela de la forma habitual de WooCommerce y el cliente puede volver a pedir. Si el pago no puede iniciarse, el cliente ve Los pagos con Paysera no están disponibles temporalmente. Elige otro método de pago. El motivo se escribe 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).
El plugin no ofrece reembolsos desde WooCommerce, ni elección de banco o de método de pago en la finalización de compra, ni suscripciones, ni tarjetas guardadas, ni servicios de entrega o mensajería de Paysera.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a Paysera y el callback todavía no ha llegado.
Processing: Paysera confirmó el pago (estado 1). Los pedidos con solo productos virtuales descargables pasan a Completado, el valor predeterminado de WooCommerce. La nota del pedido muestra la solicitud de Paysera y el método de pago. El ID de transacción es el ID de la solicitud de Paysera.
On hold: Paysera aceptó la orden de pago pero todavía no la ha ejecutado (estado 2), y el pedido se completa cuando Paysera confirma el pago; o el importe o la moneda pagados no coinciden con el pedido (nota amount/currency mismatch); o se recibió un pago de PRUEBA mientras los pagos de prueba estaban desactivados, así que no se cobró dinero. La nota del pedido lo explica.
Cancelled: el cliente canceló en la ventana de Paysera, o tú o el tiempo de espera de la reserva de stock cancelasteis el pedido. Un pago confirmado más tarde para un pedido cancelado no cambia su estado: una nota te pide restaurar el pedido (cambiarlo a Procesando) o reembolsar el pago en Paysera.
Otros estados de Paysera (pago no ejecutado, información adicional) solo añaden una nota. Si llega otro pago correcto para un pedido que ya está pagado, el pedido no cambia y una nota te pide reembolsar el duplicado en tu cuenta de Paysera.
Reembolsos
No se admiten reembolsos desde WooCommerce: el protocolo de la ventana de pago de Paysera no tiene API de reembolsos. Haz los reembolsos en tu cuenta de Paysera. Cuando Paysera informa de un reembolso, se añade al pedido una nota con el importe reembolsado, y el estado del pedido no cambia. Si hace falta, registra el reembolso manualmente en WooCommerce.
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 > Paysera. 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 dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, Paysera 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 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 de 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 renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Paysera no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que se hayan introducido Project ID y Project password. La página de ajustes muestra un aviso mientras falte alguno de los dos.
El pago se realizó, pero el pedido sigue en Pending payment: el pedido se paga con el callback de Paysera, no con el regreso del cliente. Comprueba que tu sitio sea accesible desde internet en la URL del callback que aparece en los ajustes (sin inicio de sesión, modo de mantenimiento o cortafuegos de por medio), y revisa WooCommerce > Status > Logs, origen wcp_paysera_payment.
El callback responde «Invalid signature»: la Project password no coincide con el proyecto, o el callback no procede de Paysera. Vuelve a copiar la contraseña del proyecto.
El callback responde «Project ID mismatch»: el Project ID de los ajustes es distinto del proyecto que realizó el pago.
El callback responde «Gateway not configured» o «Busy»: el ID o la contraseña del proyecto están vacíos, o otro callback del mismo pedido sigue en curso. Paysera vuelve a intentar el callback.
Paysera rechaza la ventana de pago o dice que el proyecto no existe: revisa Environment. Un proyecto normal de Paysera solo funciona con Production; Sandbox necesita un proyecto creado en el entorno sandbox de Paysera.
El pago de prueba no paga el pedido: un pago de PRUEBA solo paga un pedido mientras Test payments está activado. En caso contrario, el pedido pasa a espera con una nota que indica que no se cobró dinero. Activa también Allow test payments en el proyecto de Paysera.
No aparece ningún icono en la finalización de compra: el plugin no muestra icono por defecto. Los desarrolladores pueden definir uno con el filtro wc_psr_gateway_icon.
Un pedido está en On hold con una nota sobre discrepancia de importe o moneda: Paysera confirmó un pago cuyo importe o moneda no coincide con el total del pedido, por ejemplo porque el pedido se editó después de que el cliente empezara a pagar. Compara el pago en tu cuenta de Paysera y completa o reembolsa el pedido 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.
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 Delete data estaba activado. En caso contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Paysera es una marca comercial de su respectivo titular. Este plugin no está afiliado a Paysera ni cuenta con su respaldo.