VibeFox MultiSafepay 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.
Moneda: la moneda de la tienda o del pedido 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 se oculta 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 tienes 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 sitio para enviar notificaciones. Si no, los pedidos se siguen actualizando cuando el cliente vuelve desde MultiSafepay.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un único 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_multisafepay_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > MultiSafepay > Manage, o haz clic en Settings bajo el 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. Pega la clave API de prueba y/o de producción de MultiSafepay Control (consulta Configuración).
6. Activa Enable/Disable y guarda. Prueba un pago con Test mode activado y luego desmárcalo para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > MultiSafepay. El título de la página muestra una insignia Test mode mientras el modo de prueba está activado. Encima de los campos, la página te 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) o cuando MultiSafepay no acepta la moneda de la tienda. En la lista de métodos de pago, MultiSafepay aparece como pendiente de configuración hasta que el modo actual tenga una clave API.
Finalización de compra
Enable/Disable: Enable MultiSafepay activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que ve el cliente en la finalización de compra. Por defecto: MultiSafepay.
Description: el texto que aparece bajo el método de pago en la finalización de compra. Por defecto: 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 cuenta de prueba (testmerchant.multisafepay.com) y 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. Por defecto: activado.
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.
Notificaciones
No hay nada que configurar. Esta sección muestra la URL de notificación, que se envía a MultiSafepay con cada pago. Tiene este aspecto: https://your-site/?wc-api=mspg_webhook. MultiSafepay debe poder acceder a tu sitio. Una notificación solo indica al plugin qué pago ha cambiado: el estado, el importe y la moneda siempre se leen de la API de MultiSafepay con tu clave API antes de cambiar un pedido. Las notificaciones de pagos que no pertenecen a un pedido de tu tienda se ignoran.
Pedidos
Order status after payment: el estado de un pedido pagado. El estado se establece de inmediato, con un solo cambio de estado y un correo electrónico al cliente.
Avanzado
Debug log: Log API calls and notifications escribe los detalles en WooCommerce > Status > Logs, origen wcp_multisafepay_gateway. Los errores siempre se registran. Las claves API y los datos de clientes no se registran. Por defecto: desactivado.
Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Desactivar el plugin nunca elimina nada. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto MultiSafepay) y realiza el pedido. El plugin crea un pago de MultiSafepay por el total del pedido en la moneda del pedido 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. Los datos de facturación del cliente y el idioma de la tienda se transmiten a MultiSafepay, y el pago aparece como Order #, el número de pedido y el nombre de tu sitio. En modo de prueba, la finalización de compra muestra Test mode: no real payment will be made.
El stock se reserva mientras el cliente paga, y el carrito se conserva hasta la página de pedido recibido. Tras pagar, el cliente vuelve a la página de pedido recibido de tu tienda. El pedido solo se marca como pagado cuando MultiSafepay lo confirma: mediante la notificación o mediante una comprobación con la API de MultiSafepay cuando el cliente llega a esa página.
Si el cliente cancela en la página de MultiSafepay durante la compra, el pedido se cancela de la forma estándar de WooCommerce, se libera el stock y los productos permanecen en el carrito. Si el cliente estaba pagando desde la página Pay for order, vuelve a esa página, que explica lo sucedido: 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.
Un cliente puede pagar de nuevo un pedido no pagado. Antes de crear un nuevo pago, el plugin comprueba el anterior en MultiSafepay. Si ya está pagado, se confirma el pedido. 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 ve un breve mensaje, 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., y puede elegir otro método de pago. El error de MultiSafepay se añade a las notas del pedido.
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 ofrece un único método de pago que lleva a la página de MultiSafepay. No tiene métodos de WooCommerce separados para cada método 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 WooCommerce. 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
Pending payment: se te envió a MultiSafepay y todavía no has pagado.
Processing o Completed: MultiSafepay confirmó el pago (completado o enviado). El estado sigue a Order status after payment. La nota del pedido muestra el ID de pago de MultiSafepay, el método de pago y el entorno. El ID de transacción es el ID de pedido de MultiSafepay del pago.
On hold before payment: el pago no está liquidado (MultiSafepay lo está revisando) o está reservado (autorizado). Captura un pago reservado en MultiSafepay Control para recibir el dinero. El pedido se completa automáticamente cuando MultiSafepay lo informa como pagado.
On hold after payment: MultiSafepay confirmó un importe o una moneda distintos al total del pedido, se completó un pago de prueba mientras la tienda está en modo de producción (no se recibió dinero real), o el pago se completó después de que el pedido se hubiera cancelado. La nota del pedido lo explica. Revisa la transacción en MultiSafepay Control y procesa o reembolsa el pedido manualmente.
On hold after a chargeback: MultiSafepay informó de un contracargo en un pedido pagado: el dinero se retiró de tu cuenta.
Failed: el último pago de un pedido no pagado fue rechazado, cancelado, caducado o anulado. El stock retenido se libera. El cliente puede volver a intentarlo.
Un pedido pagado, reembolsado o cancelado nunca se reabre con una notificación tardía. Si se completa un segundo pago de un pedido que ya está pagado, el pedido no vuelve a cambiar. Una nota te pide que reembolses el duplicado en MultiSafepay Control.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via MultiSafepay. Se admiten reembolsos totales y parciales para pedidos pagados a través de MultiSafepay. 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, WooCommerce muestra el error de MultiSafepay y no se registra ningún reembolso. Una solicitud correcta se añade a las notas del pedido con el ID del reembolso de MultiSafepay.
Los reembolsos realizados en MultiSafepay Control se añaden a las notas del pedido cuando MultiSafepay los informa. No se registran automáticamente como reembolsos de WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce sin usar Refund via MultiSafepay.
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 > MultiSafepay. 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 eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un único 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, 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. 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 y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
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 la moneda de la tienda o del pedido es aceptada por MultiSafepay. La página de ajustes muestra un aviso cuando falta la clave o la moneda no se acepta.
El pago se realizó, pero el pedido sigue en Pending payment: la notificación no llegó a tu tienda. Comprueba que el sitio es accesible desde internet y que la clave API del entorno del pago está configurada, porque el plugin lee el estado desde la API de MultiSafepay. Si no se puede acceder a la API, la notificación responde ERROR y MultiSafepay la reintenta. El pedido también se actualiza cuando el cliente vuelve a la página de pedido recibido y cuando intenta pagar de nuevo el mismo pedido.
El cliente ve un error al realizar el pedido: abre las notas del pedido o activa Debug log y revisa WooCommerce > Status > Logs, origen wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. suele significar una clave API incorrecta o ausente. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. significa que MultiSafepay ha rechazado el importe o la moneda.
El pedido está en On hold after payment: lee la nota del pedido. El pago puede estar sin liquidar o reservado, el importe o la moneda pagados pueden diferir del pedido, un pago de prueba puede haber llegado en modo de producción, el pago puede haberse completado después de cancelar el pedido o puede haber un contracargo. Revisa la transacción en MultiSafepay Control.
Los pagos de prueba no confirman un pedido real: un pago de prueba nunca paga un pedido mientras la tienda está en modo de producción; en su lugar, el pedido se pone en espera. Los pagos de prueba anteriores siguen comprobándose y reembolsándose con la clave de prueba tras cambiar a producción.
El reembolso falla con un mensaje sobre el entorno: el pago se realizó 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.
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 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, los datos de MultiSafepay guardados en los pedidos y los registros solo se eliminan si Delete data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
MultiSafepay es una marca comercial de su respectivo titular. Este plugin no está afiliado a MultiSafepay ni cuenta con su respaldo.