VibeFox Paysera for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.

Proyecto de Paysera: necesitas el ID de proyecto y la contraseña del proyecto (sign key) 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.

Tienda accesible: los pedidos los crea el callback de Paysera, así que tu tienda debe ser accesible desde internet, no detrás de un inicio de sesión, de autenticación básica o de un cortafuegos. El callback funciona aunque la tienda esté en modo de mantenimiento.

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 carga, haz clic en Configure, o busca más tarde VibeFox Paysera Payment en la lista de módulos y haz clic en Configure.

3. Pega 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 (ver Clave de licencia).

4. Introduce el Project ID y la Project password de tu cuenta de Paysera (ver Configuración).

5. Opcional: activa Allow test payments en el proyecto de Paysera y Test payments en el módulo para probar el flujo sin cobrar dinero. Desactívalo antes de empezar a vender.

6. Activa Enable/Disable y haz clic en Save.

Al instalarse, el módulo crea dos estados de pedido: Awaiting Paysera payment y Paysera payment on hold. PrestaShop añade 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 Paysera Payment > Configure. Cada sección tiene su propio botón Save, que guarda la página completa. Encima de los campos, la página muestra Paysera is hidden at checkout until the project ID and the project password are entered. mientras falte uno de ellos, y Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders. mientras estén activos los pagos de prueba o el sandbox.

Paysera

Enable/Disable: Enable Paysera Payment activa o desactiva el método de pago. Por defecto: off.

Title: el nombre del método de pago que ve el cliente en la finalización de compra. También es el nombre del método de pago guardado en el pedido. Por defecto: Paysera. Obligatorio.

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

Encuentra el ID de proyecto y la contraseña de proyecto en tu cuenta de Paysera, en Projects and activities, tu proyecto, General project settings.

Callback URL: la dirección que usa Paysera para confirmar cada pago. Con URLs amigables tiene este aspecto: https://your-shop/module/wcp_paysera_payment/callback, posiblemente con un código de idioma. Se envía automáticamente con cada pago, así que no hay que configurar nada en Paysera, pero debe ser accesible desde internet. Los pedidos solo los crean estos callbacks firmados.

Project ID: el ID numérico de tu proyecto de Paysera. Solo se aceptan dígitos: cualquier otro valor muestra el error Project ID must be a number: the numeric ID of your Paysera project. y no se guarda nada.

Project password: la contraseña del proyecto (sign key). Firma las solicitudes de pago y verifica los callbacks de Paysera. La contraseña guardada nunca se vuelve a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarla.

Clear saved password: marca Project password y haz clic en Save para eliminar la contraseña guardada. Un campo vacío conserva el valor guardado.

Pruebas

Test payments: envía los pagos en modo de prueba, así que no se cobra dinero. 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é activa, los pagos de prueba marcan los pedidos como pagados; cuando está desactivada, un pago de prueba pone el pedido en espera. Por defecto: off. Mientras esté activa, los clientes ven TEST MODE — no money will be charged. debajo del método de pago.

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: escribe los eventos de pago en logs/wc_psr_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores y las advertencias siempre se escriben; los demás pasos, solo mientras esta opción esté activa. Las contraseñas y los datos de clientes nunca se escriben. Por defecto: off.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Delete data: si está activa, al desinstalar el módulo se eliminan sus ajustes y el registro. Los datos de pedidos (pedidos, registros de pago de Paysera, estados de pedido) siempre se conservan. Por defecto: off.

Finalización de compra

En el paso de pago, el cliente elige el método de pago (por defecto Paysera) y confirma el pedido. El módulo crea una solicitud de pago firmada con el total del carrito en la unidad mínima de la moneda del carrito, el nombre, el correo electrónico y la dirección de facturación del cliente, y el idioma de la página de la tienda (lituano, letón, estonio, ruso, alemán, polaco; en otro caso, inglés). El cliente es enviado a la ventana de pago de Paysera, donde elige un banco, una tarjeta u otro método. En este momento todavía no existe ningún pedido.

Paysera confirma el pago con un callback servidor a servidor. El pedido se marca como pagado solo cuando Paysera lo confirma con un callback firmado; el regreso del cliente a la tienda nunca crea ni paga un pedido. Cuando el cliente vuelve después del callback, se muestra la página estándar de confirmación del pedido. Si el banco ha aceptado la orden de pago pero aún no la ha ejecutado, el pedido se crea en Awaiting Paysera payment y la página muestra Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Para un pedido en espera, la página muestra Your payment is being reviewed. We will contact you if anything else is needed.

Si el cliente vuelve antes del callback, una página Payment confirmation explica que el pedido se creará en cuanto Paysera confirme el pago y ofrece Check again y Back to checkout.

Si el cliente cancela en la ventana de Paysera, vuelve a la finalización de compra con The Paysera payment was cancelled. You can try again or choose another payment method. Si Paysera informa de que el pago no se ejecutó, el mensaje es The payment was not completed. You can try again or choose another payment method. El carrito se conserva en ambos casos. Si el carrito ya tiene un pedido, un nuevo intento va directamente a la confirmación del pedido en lugar de a un segundo pago.

Si el pago no se puede iniciar, el cliente permanece en la finalización de compra con Paysera payments are temporarily unavailable. Please choose another payment method. o, si el total del pedido no es válido, con This order cannot be paid via Paysera. El motivo se escribe en el registro.

El callback funciona mientras la tienda está en modo de mantenimiento y no se ve afectado por la restricción de países de tu tienda.

El módulo no admite reembolsos desde el back office, ni elección de banco o 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 de pedido

No order yet: el cliente fue enviado a Paysera y el callback todavía no ha llegado, o el cliente canceló. Solo existe el carrito.

Payment accepted: Paysera confirmó el pago con el importe y la moneda correspondientes. El pago se registra con el ID de solicitud de Paysera como ID de transacción, y una nota muestra la solicitud y el método de pago, marcada como (TEST — no money charged) en los pagos de prueba.

Awaiting Paysera payment: Paysera aceptó la orden de pago, pero el banco todavía no la ha ejecutado. El pedido pasa a Payment accepted cuando Paysera confirma el pago.

Paysera payment on hold: el pago necesita una revisión manual. El importe o la moneda pagados no coinciden con el carrito o con el total del pedido; llegó un pago TEST mientras Test payments estaba desactivado (no se cobró dinero); o el pago se confirmó después de que el cliente lo hubiera cancelado. El pago no se registra. La nota lo explica, y el bloque de Paysera te pide que compruebes el pago en tu cuenta de Paysera y que después pongas el pedido en Payment accepted o lo canceles y reembolses el pago en Paysera.

Cancelled: un pago confirmado después para un pedido cancelado no cambia su estado. Una nota pide restaurar el pedido (ponerlo en Payment accepted) o reembolsar el pago en Paysera. Un pago TEST posterior o una diferencia de importe en un pedido cancelado también añade solo una nota.

Si llega otro pago correcto para un pedido que ya está pagado, el pedido no cambia y una nota pide reembolsar el duplicado en tu cuenta de Paysera. Otros estados de Paysera (pago no ejecutado, información adicional) solo añaden una nota.

Bloque de pago de Paysera

La página del pedido muestra un bloque Paysera payment con el ID del pedido en Paysera (el número de carrito y el intento), el ID de solicitud de Paysera, el entorno y una marca TEST payment, el estado del pago, los importes solicitado y pagado, el método de pago y las notas del módulo.

Reembolsos

Los reembolsos desde el back office no son compatibles: 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. Registra el reembolso en PrestaShop manualmente si lo necesitas.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Paysera Payment es el primer bloque de Modules > Module Manager > VibeFox Paysera Payment > Configure, 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 de ellos están la línea Product: presta-payment-paysera 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 seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar un hueco 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 hueco de dominio. Libera el hueco en tu cuenta de vibefox.net.

Sin una clave activa, Paysera 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 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 siguen confirmándose mediante el callback.

Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. 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 por 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

Paysera no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que se han introducido Project ID y Project password. La página de ajustes muestra una advertencia mientras falte alguno de ellos. 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 lo crea el callback de Paysera, no el regreso del cliente. Comprueba que tu tienda es accesible desde internet en la Callback URL que aparece en los ajustes (no detrás de un inicio de sesión, de autenticación básica o de un cortafuegos), y mira el campo Log de la página del módulo.

El callback responde Invalid signature: la Project password no coincide con el proyecto, o el callback no viene de Paysera. Vuelve a copiar la contraseña del proyecto. Si cambiaste el proyecto o la contraseña, los pagos iniciados antes del cambio ya no se pueden verificar.

El callback responde Project ID mismatch: el Project ID de los ajustes es distinto del proyecto que hizo el pago.

El callback responde Order not found: el carrito del callback no tiene un pago de Paysera en esta tienda, por ejemplo porque el pago se inició en otra tienda con el mismo proyecto.

El callback responde Gateway not configured, Busy o Temporary error: el ID o la contraseña del proyecto están vacíos, otro callback del mismo carrito todavía se está procesando, o no se pudo crear el pedido (por ejemplo, porque el módulo está desactivado). Paysera reintenta el callback. Activa Debug log para ver el motivo.

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 TEST solo paga un pedido mientras Test payments está activado. En caso contrario, el pedido se pone en espera con una nota que indica que no se cobró dinero. Activa también Allow test payments en el proyecto de Paysera.

Un pedido está en Paysera payment on hold con una nota sobre una diferencia de importe o de moneda: Paysera confirmó un pago cuyo importe o moneda no coincide con el total del carrito, por ejemplo porque el carrito se modificó en otra pestaña después de que el cliente empezara a pagar. Compara el pago en tu cuenta de Paysera y acepta el pedido o reembolsa el pago manualmente. Un pago correcto posterior para el mismo pedido lo marca como pagado.

El cliente ve Paysera payments are temporarily unavailable: mira el campo Log. Puede que el ID o la contraseña del proyecto estén vacíos, o que una de las direcciones de la tienda enviadas a Paysera tenga más de 255 caracteres.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox Paysera Payment y elige Uninstall. La clave de licencia y el estado de la licencia de este módulo siempre se eliminan. Si Delete data 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 registros de pago de Paysera y los estados de pedido Awaiting Paysera payment y Paysera payment on hold siempre se conservan. Los pedidos existentes conservan sus notas de pago e ID de transacción.

Paysera es una marca comercial de su respectivo propietario. Este módulo no está afiliado a Paysera ni cuenta con su respaldo.