VibeFox Mollie 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 de la tienda: una de las monedas compatibles con Mollie: AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR. Para otras monedas, el método de pago se oculta en la finalización de compra. Qué métodos de pago ofrece Mollie depende de la moneda y de tu cuenta.
Acceso a internet a tu sitio: Mollie envía webhooks a tu tienda, así que el sitio debe ser accesible desde internet. Sin webhooks, los pedidos se siguen actualizando cuando el cliente vuelve de Mollie.
Cuenta de Mollie: necesitas las claves de API de Mollie Dashboard > Developers > API keys. Las claves de prueba empiezan por test_, las reales por live_. Los métodos de pago se activan en tu cuenta de Mollie.
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_mollie_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > Mollie > 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 tus claves de API de prueba y real (véase Configuración). No hace falta configurar ningún webhook en Mollie.
6. Activa Enable/Disable. Deja Test Mode activado hasta que hayas hecho un pago de prueba y después desmárcalo.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Mollie. Encima de los campos, la página avisa cuando Mollie está activado pero la clave de API del modo actual está vacía, y cuando Mollie no admite la moneda de la tienda. En ambos casos el método de pago se oculta en la finalización de compra. En la lista de métodos de pago, Mollie aparece como que requiere configuración hasta que el modo actual tenga una clave de API, y muestra Test mode mientras el modo de prueba está activado.
Al guardar, una clave de API que no empiece por test_ o live_ seguido de al menos 30 letras y cifras no se guarda: aparece un error y se conserva el valor anterior.
Finalización de compra
Enable/Disable: Enable Mollie Gateway activa o desactiva el método de pago. Por defecto: desactivado.
Title: el título del método de pago que se muestra al cliente durante la finalización de compra. Por defecto: Mollie.
Description: la descripción del método de pago que se muestra al cliente durante la finalización de compra. Por defecto: Pay securely via Mollie.
Claves de API
Encuentra tus claves de API en Mollie Dashboard > Developers > API keys. No hace falta configurar ningún webhook: el plugin envía su URL de webhook con cada pago. La URL se muestra en esta sección y tiene este aspecto: https://your-site/?wc-api=molg_mollie_webhook. Debe ser accesible desde internet; si no, los pedidos solo se actualizan cuando el cliente vuelve de Mollie.
Test Mode: Enable test mode usa la clave de API de prueba para los pagos nuevos. No se procesa ningún pago real. En la página de pago de prueba de Mollie puedes elegir el resultado (pagado, fallido, cancelado, caducado). Los clientes ven Test mode: no real payment will be made. en la finalización de compra. Los pagos realizados en el otro modo siguen usando la clave de su propio modo para comprobar el estado y para los reembolsos. Por defecto: activado.
Test API Key: tu clave de API de prueba de Mollie (empieza por test_).
Live API Key: tu clave de API real de Mollie (empieza por live_).
Pedidos
Order Status After Payment: el estado del pedido que se asigna tras un pago correcto. El estado se asigna en un solo paso, sin un segundo cambio de estado.
Avanzado
Logging: Enable debug logging escribe las llamadas a la API y los webhooks en WooCommerce > Status > Logs, origen wcp_mollie_gateway. Los errores siempre se registran. Las claves de API y los datos de los clientes nunca se registran. Por defecto: desactivado.
Delete Data on Uninstall: Remove the plugin settings and logs when uninstalling. Si está marcado, los ajustes del plugin y sus archivos de registro se eliminan al borrar el plugin. Los ID de pago de Mollie guardados en los pedidos se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Mollie) y realiza el pedido. El plugin crea un pago de Mollie por el total del pedido en la moneda del pedido (JPY e ISK sin decimales), con la descripción Order # y el número de pedido, y envía al cliente a la página de pago alojada de Mollie. Allí el cliente elige uno de los métodos de pago activados en tu cuenta de Mollie y paga.
Los webhooks de Mollie no llevan firma, solo el ID del pago. Por eso el plugin nunca confía en un webhook por sí mismo: obtiene el pago de la API de Mollie con tu propia clave de API, comprueba que el pago pertenece al pedido y compara el importe y la moneda pagados con los del pedido. El pedido se marca como pagado solo después de que Mollie lo confirme de este modo. El plugin gestiona estos estados de pago de Mollie:
Cuando el cliente vuelve, el plugin comprueba el último pago con la API de Mollie del mismo modo. Un pago realizado lleva a la página de pedido recibido. Si el pago se canceló, falló, caducó o no ha terminado, el cliente va a la página Pay for order con un mensaje, por ejemplo You cancelled the Mollie payment. You can try again or choose another payment method. o The Mollie payment has expired. Please try again or choose another payment method.
Cuando el cliente vuelve a pagar, se reutiliza el pago de Mollie que sigue abierto por el mismo importe, en lugar de crear un segundo pago pagable. Si el total del pedido ha cambiado, el pago abierto anterior se cancela en Mollie cuando Mollie lo permite. Si el pago anterior se realizó entretanto, el pedido se marca como pagado sin un nuevo pago.
Si Mollie no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo The payment provider could not be reached. Please try again in a moment., This payment method is temporarily unavailable. Please choose another payment method. (clave de API incorrecta) o Mollie cannot accept a payment of this amount or currency. Please choose another payment method. El motivo técnico 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 cliente elige el método de Mollie en la página de Mollie, no en tu finalización de compra. El plugin no tiene suscripciones ni pagos recurrentes, ni tarjetas guardadas ni mandatos, ni Mollie Components (campos de tarjeta en tu sitio), ni botones express de Apple Pay o PayPal, ni Orders API, así que Mollie no ofrece para estos pagos los métodos que necesitan líneas de pedido (por ejemplo, algunas variantes de Klarna, Billie o in3). Los pagos autorizados se capturan o anulan en el Mollie Dashboard, no desde WooCommerce.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a Mollie y aún no ha pagado.
Processing or Completed: el pago está confirmado. El estado sigue a Order Status After Payment. La nota del pedido muestra el pago de Mollie, el método y el modo. El ID de la transacción es el ID de pago de Mollie (tr_...) que pagó el pedido.
On hold: una transferencia bancaria espera el dinero, un pago autorizado espera la captura, o Mollie ha informado de un contracargo. También se asigna En espera cuando el importe o la moneda pagados no coinciden con el pedido, cuando se pagó un pago de prueba con la tienda en modo real (no se recibió dinero), o cuando el pago llegó después de cancelar el pedido. La nota del pedido lo explica. Comprueba el pago en el Mollie Dashboard y después procesa el pedido o reembolsa el pago.
Failed: el último intento de pago falló, caducó o se canceló. Un pedido pagado nunca se modifica. El cliente puede volver a pagar.
Si se paga una segunda vez un pago del mismo pedido, el pedido no vuelve a cambiar. Una nota te pide reembolsar el pago duplicado en tu Mollie Dashboard.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Mollie (el botón muestra tu Title). Se admiten reembolsos totales y parciales. El reembolso se envía para el pago que realmente pagó el pedido, con la clave de API del modo en el que se hizo, así que esa clave debe estar configurada. El botón solo está disponible para pedidos con un pago de Mollie realizado. Si Mollie rechaza el reembolso, WooCommerce muestra el mensaje de error de Mollie y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID de reembolso de Mollie.
Los reembolsos y contracargos creados en el Mollie Dashboard no se convierten en reembolsos de WooCommerce. Un contracargo añade una nota.
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 > Mollie. 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 dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, Mollie no se muestra a los clientes en la finalización de compra. Si se inicia un pago igualmente, 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 requieren renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Mollie no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que el modo actual tiene una clave de API: Test API Key en modo de prueba, Live API Key en modo real. Comprueba que la moneda de la tienda (o la moneda del pedido en la página Pay for order) es compatible con Mollie. La página de ajustes muestra un aviso para cada uno de estos problemas.
El pago se realizó, pero el pedido sigue en Pending payment: el webhook no puede llegar a tu sitio. La URL del webhook que aparece en los ajustes debe ser accesible desde internet (sin modo de mantenimiento, autenticación básica ni cortafuegos que lo impidan). El pedido también se actualiza cuando el cliente vuelve a la tienda después de pagar.
Webhook answers Unknown payment.: Mollie no conoce el ID de pago con tu clave de API de prueba o real, por ejemplo un pago de otra cuenta de Mollie.
Webhook answers Payment ID mismatch.: el pago no pertenece al pedido según sus datos. El pedido no se modifica.
Webhook answers Failed to fetch payment.: no se pudo acceder a la API de Mollie. Mollie vuelve a intentar el webhook más tarde.
No se guarda una clave de API: la clave debe empezar por test_ o live_ seguido de al menos 30 letras y cifras. Cópiala de nuevo desde el Mollie Dashboard.
El pago no se crea: la nota del pedido y el registro muestran el código HTTP y el mensaje de Mollie. 401 significa clave de API incorrecta; 422 indica un campo de la solicitud, por ejemplo un importe o una moneda que Mollie no acepta. Activa Logging y mira en WooCommerce > Status > Logs, origen wcp_mollie_gateway.
El pedido está On hold: lee la nota del pedido. El motivo es una diferencia de importe o moneda, un pago de prueba en modo real, un pago después de la cancelación, una transferencia bancaria, una autorización sin captura o un contracargo.
El reembolso falla con un mensaje sobre el modo: el pago se realizó en modo de prueba o real, y la clave de API de ese modo no está configurada. Introdúcela y vuelve a intentarlo.
Otras monedas: los desarrolladores pueden cambiar la lista de monedas con el filtro molg_supported_currencies.
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 y los archivos de registro se eliminan solo si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago, los ID de pago de Mollie y los ID de transacción.
Mollie es una marca comercial de su respectivo titular. Este plugin no está afiliado a Mollie ni cuenta con su aprobación.