VibeFox Montonio for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. Sin WooCommerce, el plugin no se activa.
PHP: 8.0 o posterior.
Moneda: la moneda de la tienda o del pedido debe ser EUR o PLN. Para cualquier otra moneda, el método de pago se oculta en la finalización de compra.
Cuenta de Montonio: necesitas la clave de acceso y la clave secreta de tu tienda, obtenidas en el Montonio Partner System. Las claves de sandbox y de producción son distintas, así que necesitas un par para cada entorno que uses. No hay que configurar nada más en Montonio: la dirección de notificación se envía con cada pago.
Sitio público: tu sitio debe ser accesible desde internet para recibir las notificaciones de Montonio. Si no lo es, los pedidos se confirman igualmente cuando el cliente vuelve a la tienda.
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_montonio_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > Montonio > Manage, o haz clic en Settings debajo del nombre del plugin en la página 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. En el Montonio Partner System, abre Stores > your store > API keys y copia la clave de acceso y la clave secreta de sandbox. Pégalas en los ajustes y deja activado Sandbox mode.
6. Activa Enable/Disable y prueba un pago en sandbox. Después, introduce las claves live y desmarca Sandbox mode.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Montonio. Encima de los campos, la página te avisa cuando faltan las claves del entorno actual (en ese caso el método de pago se oculta en la finalización de compra) y cuando la moneda de la tienda no es EUR ni PLN, y muestra Sandbox mode is on: payments are simulated and no real money is charged. mientras el sandbox esté activado. En la lista de métodos de pago, Montonio aparece como pendiente de configuración hasta que se rellenen ambas claves del entorno actual.
General
Enable/Disable: Enable Montonio bank payments 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: Bank payment (Montonio).
Description: el texto que aparece debajo del método de pago en la finalización de compra. Por defecto: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.
Claves de API
Obtén las claves en el Montonio Partner System, en Stores > your store > API keys. Las claves de sandbox y de producción son distintas. El sandbox usa solo las claves de sandbox, y el modo live usa solo las claves live. Esta sección de los ajustes también muestra la URL de notificación. Tiene este aspecto: https://your-site/wc-api/wc_mnt_payment/. No tienes que introducirla en ningún sitio: el plugin la envía a Montonio con cada pago.
Sandbox mode: Use the Montonio sandbox (test payments, no real money). Cambia tanto la dirección de la API de Montonio como el par de claves. Por defecto: activado. Desactívalo solo después de introducir las claves live.
Sandbox access key: la clave de acceso (UUID) de tu tienda en el sandbox de Montonio.
Sandbox secret key: la clave secreta de tu tienda en el sandbox de Montonio.
Live access key: la clave de acceso (UUID) de tu tienda en el entorno live de Montonio.
Live secret key: la clave secreta de tu tienda en el entorno live de Montonio.
Avanzado
Debug log: Log payment events escribe todos los eventos de pago en WooCommerce > Status > Logs, origen wcp_montonio_payment. Los errores siempre se registran, aunque esta opción esté desactivada. Las claves, los tokens y los datos del cliente nunca se registran. Por defecto: desactivado.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Desactivar el plugin nunca borra nada. Los datos de los pedidos (UUID de Montonio, notas) se conservan siempre. Por defecto: desactivado.
Notificaciones de pago
Montonio informa a tu tienda de cada pago con un token firmado. El token llega de dos formas: mediante una notificación de servidor a servidor a la URL de notificación y con el cliente cuando vuelve a la tienda. Se comprueban ambas: la firma con tu clave secreta, la fecha de caducidad, tu clave de acceso y que el pago sea uno que tu tienda creó para ese pedido en el mismo entorno. Los tokens que no superan la comprobación se rechazan. Cada estado se aplica una sola vez, así que las notificaciones repetidas no añaden notas, correos ni cambios de stock.
Finalización de compra
El cliente elige el método de pago (por defecto, Bank payment (Montonio)) y realiza el pedido. El plugin crea un pago de Montonio por el total del pedido en la moneda del pedido y envía al cliente a la página de pago de Montonio. Allí el cliente elige un banco y paga. Los bancos del país de facturación del cliente aparecen primero (Polonia para los pedidos en PLN). El pago aparece como Order y el número de pedido. La página de Montonio se abre en el idioma de la tienda cuando es alemán, inglés, estonio, finlandés, lituano, letón, polaco o ruso; en otro caso, se abre en inglés. En modo sandbox, la finalización de compra muestra SANDBOX MODE — test payment, no real money is charged. debajo de la descripción.
El pedido solo se marca como pagado cuando Montonio lo confirma con el estado PAID y el importe y la moneda exactos del pedido. Después de pagar, el cliente vuelve a la página de pedido recibido de tu tienda. Mientras Montonio no haya confirmado el pago, esa página muestra Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Si el pago fue cancelado o rechazado, el cliente vuelve a la página Pay for order y ve uno de estos mensajes: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. o Montonio could not complete the payment. Please try again or choose another payment method.
Un cliente puede pagar de nuevo un pedido sin pagar desde la página Pay for order. Antes de crear un nuevo pago, el plugin pregunta a Montonio por el anterior. Si ya está pagado, el pedido se confirma y no se crea un segundo pago.
Si Montonio no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., y puede elegir otro método de pago. El error de Montonio se añade a las notas del pedido y al 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 solo admite pagos bancarios (iniciación de pagos). No admite pagos con tarjeta, BLIK, Apple Pay ni Google Pay, Pay Later ni financiación, envío de Montonio, suscripciones, métodos de pago guardados ni selección de banco en tu propio sitio.
Pedidos y reembolsos
Estados del pedido
Pendiente de pago: el cliente fue enviado a Montonio y aún no ha pagado. Se añade una nota cuando Montonio informa de que el pago está pendiente.
Procesando o Completado: Montonio confirmó el pago (PAID). El pedido sigue el estado estándar de WooCommerce para pedidos pagados. La nota del pedido muestra el banco, el UUID del pago de Montonio, el importe y el entorno. El ID de transacción es el UUID del pago de Montonio.
En espera: el banco aún no ha confirmado el pago (AUTHORIZED); el pedido pasa a pagado cuando Montonio informa de PAID. Un pedido también se pone en espera cuando Montonio informó un importe o una moneda distintos del total del pedido, cuando llegó un pago de sandbox mientras la tienda está en modo live, o cuando el pago llegó después de cancelar el pedido. La nota del pedido lo explica. Comprueba el pago en el Montonio Partner System y prepara el pedido o reembolsa el pago.
Fallido: el cliente no completó el pago o el banco lo rechazó. Solo el último pago de un pedido no pagado puede hacer que el pedido falle. El cliente puede intentarlo de nuevo desde la página Pay for order.
Los pedidos pagados, cancelados o reembolsados nunca se vuelven a abrir por notificaciones posteriores. Si llega un segundo pago para un pedido que ya está pagado, el pedido no cambia. Una nota te pide que reembolses el segundo pago en el Montonio Partner System.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Bank payment (Montonio) (el botón usa el nombre del método de pago). Se admiten reembolsos totales y parciales de pedidos pagados con Montonio. El reembolso se envía al entorno en el que se hizo el pago (sandbox o live), por lo que las claves de ese entorno deben estar configuradas. Si Montonio no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso enviado se añade a las notas del pedido con su estado y el ID de reembolso de Montonio.
Montonio confirma o rechaza cada reembolso más tarde mediante una notificación. La confirmación se añade a las notas del pedido. Si Montonio rechaza el reembolso, la nota indica que el dinero no fue devuelto al cliente; compruébalo en el Montonio Partner System y corrige el reembolso en WooCommerce.
Los reembolsos realizados en el Montonio Partner System se añaden a las notas del pedido cuando Montonio los informa. No se registran automáticamente como reembolsos de WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox obtenida en vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Montonio. 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, Montonio 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 siguen confirmándose y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Montonio no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que están configuradas ambas claves del entorno actual (Sandbox access key y Sandbox secret key en modo sandbox, Live access key y Live secret key en modo live) y que la moneda de la tienda o del pedido es EUR o PLN. La página de ajustes muestra un aviso cuando faltan claves o la moneda no es compatible.
El pago se realizó, pero el pedido sigue en Pendiente de pago: la notificación no llegó a tu tienda. Comprueba que el sitio es accesible desde internet y que las claves de los ajustes pertenecen al entorno del pago. El pedido también se confirma cuando el cliente vuelve a la tienda después de pagar, y cuando intenta pagar de nuevo el mismo pedido.
La notificación responde Invalid token: la firma, la caducidad o la clave de acceso del token no coinciden. Comprueba que la clave de acceso y la clave secreta están copiadas correctamente, que pertenecen al entorno correcto y que el reloj del servidor está bien configurado.
La notificación responde Payment does not belong to this order o Wrong environment: el pago no lo creó esta tienda para ese pedido, o se creó en el otro entorno (sandbox o live). Esto ocurre cuando dos tiendas usan la misma cuenta de Montonio y los mismos números de pedido.
La notificación responde Gateway not configured: no hay claves de Montonio configuradas. Introduce las claves; Montonio reintentará la notificación.
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_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. normalmente indica claves erróneas o que faltan. Montonio could not start the payment. Please check your order details or choose another payment method. significa que Montonio rechazó los datos del pago; la nota contiene el motivo.
El pedido está en espera después del pago: lee la nota del pedido. El banco aún no ha confirmado el pago, el importe o la moneda pagados no coinciden con el pedido, llegó un pago de sandbox en modo live, o el pago llegó después de cancelar el pedido. Comprueba el pago en el Montonio Partner System.
Los pagos de sandbox no confirman un pedido live: un pago de sandbox nunca completa un pedido mientras la tienda está en modo live; en su lugar, el pedido se pone en espera. Cambia Sandbox mode al entorno que quieras usar y utiliza las claves de ese entorno.
El reembolso falla con un mensaje sobre el entorno: el pago se hizo en el entorno sandbox o live, y las claves de ese entorno no están configuradas. Introdúcelas e inténtalo de nuevo.
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; si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Montonio es una marca registrada de su respectivo propietario. Este plugin no está afiliado a Montonio ni cuenta con su respaldo.