VibeFox MultiSafepay 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.

Moneda: la moneda del carrito debe ser una que acepte MultiSafepay, por ejemplo EUR, USD, GBP, PLN, CHF, SEK, DKK o NOK. Para otras monedas, el método de pago no se muestra en la finalización de compra.

Cuenta de MultiSafepay: necesitas la clave API de tu sitio web en MultiSafepay Control. Las cuentas de prueba y de producción tienen claves distintas. No hay que configurar nada más en MultiSafepay: la dirección de notificación se envía con cada pago.

Sitio público: MultiSafepay debe poder acceder a tu tienda para enviar las notificaciones. Si no, los pedidos se crean igualmente cuando el cliente vuelve desde MultiSafepay.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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 MultiSafepay Gateway en la lista de módulos y haz clic en Configure.

3. Introduce tu clave de licencia de VibeFox en el campo License key del bloque de licencia de la parte superior de la página Configure y haz clic en Activate (véase Clave de licencia).

4. Pega la clave API de prueba y/o de producción de MultiSafepay Control (véase Configuración).

5. Activa Enable/Disable y haz clic en Save. Prueba un pago con Test mode activado y, después, desactívalo para aceptar pagos reales.

Al instalarse, el módulo crea el estado de pedido MultiSafepay payment on hold. PrestaShop ofrece un nuevo método 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 MultiSafepay Gateway > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Encima de los campos, la página muestra Test mode: new payments use the MultiSafepay test environment (no real payments). mientras el modo de prueba está activado, y avisa cuando el modo actual no tiene clave API (en ese caso el método de pago no se muestra en la finalización de compra) y cuando MultiSafepay no acepta la moneda predeterminada de tu tienda. La página no se guarda sin un Title.

Finalización de compra

Enable/Disable: Enable MultiSafepay activa o desactiva el método de pago. Predeterminado: desactivado.

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 que se guarda en el pedido. Predeterminado: MultiSafepay. Obligatorio.

Description: el texto que se muestra debajo del método de pago en la finalización de compra. Predeterminado: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

Claves API

Encuentra la clave API en MultiSafepay Control > Manage settings > Website settings. La sección enlaza con la cuenta de prueba (testmerchant.multisafepay.com) y con la cuenta de producción (merchant.multisafepay.com). Tienen claves distintas. El modo de prueba usa solo la clave de prueba, y el modo de producción solo la clave de producción.

Test mode: Use the MultiSafepay test environment (no real payments). Cambia tanto la dirección de la API como la clave API. Los pagos ya realizados siguen usando el entorno en el que se hicieron para las comprobaciones de estado y los reembolsos. Predeterminado: activado. Mientras está activado, los clientes ven Test mode: no real payment will be made. debajo del método de pago.

Test API key: la clave API de tu cuenta de prueba de MultiSafepay.

Live API key: la clave API de tu cuenta de producción de MultiSafepay.

Las claves guardadas nunca se vuelven 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 keys: marca una clave y haz clic en Save para eliminarla. Un campo vacío mantiene el valor guardado.

Notificaciones

No hay nada que configurar. El campo Notification URL muestra la dirección que se envía a MultiSafepay con cada pago. Con URL amigables tiene este aspecto: https://your-shop/module/wcp_multisafepay_gateway/webhook, posiblemente con un código de idioma como /en/. Una notificación solo indica al módulo qué pago ha cambiado: el estado, el importe y la moneda se leen siempre de la API de MultiSafepay con tu clave API antes de crear o modificar un pedido. Se ignoran las notificaciones de pagos que no se iniciaron en tu tienda. La notificación funciona con la tienda en modo de mantenimiento y no la bloquea la restricción por país de tu tienda.

Pedidos

Order status after payment: el estado de un pedido pagado. El estado se establece de una vez, con un solo cambio de estado y un solo correo electrónico al cliente.

Avanzado

Debug log: Log API calls and notifications registra en logs/mspg_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 registran. Las claves API y los datos de los clientes nunca se registran. Predeterminado: desactivado.

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

Delete data on uninstall: si está activado, al desinstalar el módulo se eliminan los ajustes y el registro. Los datos de pago de MultiSafepay de los pedidos y el estado del pedido siempre se conservan, así que siguen siendo posibles los reembolsos de pedidos antiguos. Desactivar el módulo nunca elimina nada. Predeterminado: desactivado.

Finalización de compra

En el paso de pago, el cliente elige el método de pago (de forma predeterminada MultiSafepay, con el logotipo de MultiSafepay) y confirma. El módulo crea un pago de MultiSafepay por el total del carrito en la moneda del carrito y envía al cliente a la página de pago de MultiSafepay. Allí el cliente elige cualquier método de pago activado en tu cuenta de MultiSafepay y paga. La dirección de facturación, el correo electrónico, el teléfono y el idioma del cliente se pasan a MultiSafepay, y el pago aparece como Order #, el número del carrito y el nombre de tu tienda. En este momento todavía no existe ningún pedido.

Tras pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando MultiSafepay lo confirma: mediante la notificación o mediante una comprobación con la API de MultiSafepay cuando el cliente regresa. Entonces se crea el pedido y el cliente ve la página estándar de confirmación de pedido con Your payment with MultiSafepay has been received. En un pedido en espera, la página muestra We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. Si el pago falla después, la página muestra Your MultiSafepay payment was not completed. Please contact us about this order. Si MultiSafepay aún no ha confirmado el pago cuando el cliente vuelve (por ejemplo, si se espera una transferencia bancaria), una página Payment confirmation muestra el mismo texto de confirmación y un botón Check again; la notificación crea el pedido en cuanto MultiSafepay informa del pago.

Si el cliente cancela en la página de MultiSafepay, o si el pago es rechazado o caduca, vuelve a la finalización de compra con el carrito conservado y con uno de estos mensajes: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. o The payment session has expired. Please try again.

Antes de crear un nuevo pago para el mismo carrito, el módulo comprueba el anterior en MultiSafepay. Si ya está pagado o en proceso, se crea el pedido en lugar de un nuevo pago. Si sigue abierto con el mismo importe, se reutiliza la misma página de pago. Si el importe ha cambiado, el pago anterior se cancela en MultiSafepay para que ya no pueda pagarse.

Si MultiSafepay no puede iniciar el pago, el cliente se queda en la finalización de compra con un mensaje breve, por ejemplo Could not connect to MultiSafepay. Please try again in a moment. o MultiSafepay cannot accept this order amount or currency. Please choose another payment method. El motivo técnico se escribe en el registro.

El módulo ofrece un único método de pago que lleva a la página de MultiSafepay. No tiene métodos de pago separados de PrestaShop para cada método de pago de MultiSafepay, ni campos de tarjeta integrados, ni botones exprés de Apple Pay o Google Pay, ni suscripciones, pagos recurrentes o tarjetas guardadas, y no permite capturar ni anular desde PrestaShop. No se envían datos del carrito, así que MultiSafepay no ofrece para estos pedidos los métodos de pago aplazado que los requieren (por ejemplo, Klarna, in3 o Riverty).

Pedidos y reembolsos

Estados del pedido

Aún sin pedido: el cliente fue enviado a MultiSafepay y no ha pagado, o MultiSafepay todavía no ha confirmado el pago. Solo existe el carrito.

Payment accepted o Delivered: MultiSafepay confirmó el pago (completado o enviado). El estado sigue a Order status after payment. El pago se registra con el ID de pedido de MultiSafepay como ID de transacción, y una nota muestra el pago, el método de pago y el entorno.

MultiSafepay payment on hold before payment: el pago no está liquidado (lo está revisando MultiSafepay) o está reservado (autorizado). Captura un pago reservado en MultiSafepay Control para recibir el dinero. El pedido pasa automáticamente al estado de pagado cuando MultiSafepay informa de que el pago está completado.

MultiSafepay payment on hold after payment: MultiSafepay confirmó un importe o una moneda distintos del total del carrito (por ejemplo, el carrito se cambió después de iniciar el pago), se completó un pago de prueba mientras el módulo está en modo de producción (no se recibió dinero real y no se registra ningún pago), o el pago se completó después de que el pedido se hubiera cancelado. La nota lo explica. Revisa la transacción en MultiSafepay Control y gestiona el envío del pedido o reembólsalo.

MultiSafepay payment on hold after a chargeback: MultiSafepay informó de un contracargo en un pedido pagado: el dinero se retiró de tu cuenta.

Payment error: un pago no liquidado o reservado fue rechazado, cancelado, caducado o anulado más tarde.

Refunded: el pago fue reembolsado por completo a través del módulo.

Un pedido pagado o reembolsado nunca se reabre con una notificación tardía. Si se completa un segundo pago para un carrito que ya está pagado, el pedido no cambia. Una nota te pide que reembolses el duplicado en MultiSafepay Control.

Bloque de pago de MultiSafepay

La página del pedido muestra un bloque MultiSafepay payment con el ID de pedido de MultiSafepay, el método de pago, el estado, el importe pagado y reembolsado, una insignia Test mode para los pagos de prueba, el historial de reembolsos y las MultiSafepay notes del pedido.

Reembolsos

En el bloque MultiSafepay payment, introduce el importe (se rellena el importe que aún no se ha reembolsado), opcionalmente un motivo, y haz clic en Refund via MultiSafepay. Confirma la pregunta Refund this amount through MultiSafepay? This cannot be undone. Se admiten reembolsos totales y parciales. Necesitas el permiso para editar pedidos; no hace falta acceso a las páginas de Módulos. Los reembolsos se hacen en el importe y la moneda que cobró MultiSafepay, así que tras una discrepancia de importe puedes reembolsar hasta lo que el cliente realmente pagó, y no el total del pedido. El reembolso se envía al entorno en el que se hizo el pago (prueba o producción), así que la clave API de ese entorno debe estar configurada. Si MultiSafepay no acepta el reembolso, el bloque muestra MultiSafepay refund failed: con el error de MultiSafepay, y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas, con el ID de reembolso de MultiSafepay. Un reembolso total pone el pedido en Refunded. Un reembolso parcial no cambia el estado. Los reembolsos están disponibles una vez que MultiSafepay ha informado del pago.

El módulo no crea facturas rectificativas. Los botones estándar de reembolso de PrestaShop de la página del pedido no devuelven dinero a través de MultiSafepay.

Los reembolsos realizados en MultiSafepay Control se añaden a las notas cuando MultiSafepay los informa. El estado del pedido y las facturas rectificativas no cambian automáticamente. Actualízalos manualmente si es necesario.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox MultiSafepay Gateway es el primer bloque de la página Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure, por encima de los ajustes. Introduce la clave en el campo 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-multisafepay y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure para el 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 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. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, MultiSafepay no se muestra a los clientes en la finalización de compra. Si se inicia un pago de todos modos, 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 requieren 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 luego una vez a la semana. No es necesario ningún cron job. Al desinstalar o restablecer el módulo, siempre se elimina la clave de licencia y el estado de la licencia.

Solución de problemas

MultiSafepay no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el modo actual tiene una clave API (Test API key en modo de prueba, Live API key en modo de producción) y que MultiSafepay acepta la moneda del carrito. La página de ajustes muestra una advertencia cuando falta la clave o cuando no se acepta la moneda de la tienda. En Payment > Preferences, comprueba que el módulo está permitido para la moneda del carrito, el país del cliente y su grupo.

El pago se realizó, pero no se creó ningún pedido: la notificación no llegó a tu tienda. Comprueba que la tienda es accesible desde internet y que la clave API del entorno del pago está configurada, porque el módulo lee el estado de la API de MultiSafepay. Si no se puede acceder a la API o falta la clave, la notificación responde ERROR y MultiSafepay la reintenta. El pedido también se crea cuando el cliente vuelve a la tienda y cuando intenta pagar de nuevo el mismo carrito.

La notificación responde Invalid request: la solicitud no tenía un ID de transacción válido. Las notificaciones de MultiSafepay siempre lo incluyen.

El cliente ve un error al elegir MultiSafepay: activa Debug log y revisa el campo Log de la página del módulo. This payment method is temporarily unavailable. Please choose another payment method. suele indicar una clave API incorrecta o ausente. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. significa que MultiSafepay rechazó el importe o la moneda.

El pedido está en MultiSafepay payment on hold: lee las notas del bloque MultiSafepay payment. El pago puede no estar liquidado o estar reservado, el importe o la moneda pagados pueden diferir del carrito, puede haber llegado un pago de prueba en modo de producción, el pago puede haber llegado después de cancelar el pedido, o puede haber habido un contracargo. Comprueba la transacción en MultiSafepay Control.

Los pagos de prueba no confirman un pedido real: un pago de prueba nunca paga un pedido mientras el módulo está en modo de producción; el pedido se pone en espera. Los pagos de prueba anteriores se siguen comprobando y reembolsando con la clave de prueba tras cambiar a producción.

El reembolso falla con un mensaje sobre el entorno: el pago se hizo en el entorno de prueba o de producción, y la clave API de ese entorno no está configurada. Introdúcela y vuelve a intentarlo.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox MultiSafepay Gateway y elige Uninstall. La clave de licencia y el estado de licencia de este módulo se eliminan siempre. Si Delete data on uninstall está activado, se eliminan los ajustes y el registro. Si está desactivado, todos los ajustes se conservan para una reinstalación posterior. Los datos de pago de MultiSafepay de los pedidos y el estado de pedido MultiSafepay payment on hold siempre se conservan, así que los pedidos pagados antes pueden seguir reembolsándose tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.

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