ES
EUR
Volver

VibeFox Mollie for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo no permite la instalación en versiones anteriores de PHP.

Moneda de la tienda: la moneda del carrito debe ser 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, la opción de pago se oculta en la finalización de compra. Los métodos de pago que ofrece Mollie dependen de la moneda y de tu cuenta.

Acceso a internet a tu tienda: Mollie envía webhooks a tu tienda, así que el sitio debe ser accesible desde internet. Sin webhooks, los pedidos se crean igualmente cuando el cliente vuelve desde 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_. No se necesitan otras claves ni secretos. 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 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 subida, haz clic en Configure, o busca más adelante VibeFox Mollie 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. Introduce tus claves de API de prueba y real (véase Configuración). No es necesario configurar ningún webhook en Mollie.

5. Activa Enable/Disable y haz clic en Save. Deja Test Mode activado hasta que hayas realizado un pago de prueba, y después desactívalo.

Al instalarse, el módulo crea dos estados de pedido, Awaiting Mollie payment y Mollie payment on hold. PrestaShop ofrece 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 Mollie Gateway > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Encima de los campos, la página te avisa cuando Mollie está activado pero la clave de API del modo actual está vacía, y cuando Mollie no admite la moneda predeterminada de la tienda. En ambos casos, la opción de pago se oculta en la finalización de compra.

Al guardar, una clave de API que no empieza por test_ o live_ seguido de al menos 30 letras y números no se guarda: se muestra un error y se conserva la clave guardada anteriormente.

Finalización de compra

Enable/Disable: Enable Mollie Gateway activa o desactiva la opción de pago. Por defecto: off.

Title: el título del método de pago que se muestra al cliente en la finalización de compra. También es el nombre del método de pago guardado en el pedido. Por defecto: Mollie. Obligatorio.

Description: la descripción del método de pago que se muestra al cliente en la finalización de compra. Por defecto: Pay securely via Mollie.

Claves de API

Encontrarás tus claves de API en Mollie Dashboard, en Developers > API keys; la sección enlaza a esa página. Las claves de prueba y las reales son independientes.

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 del pago. Los clientes ven Test mode: no real payment will be made. debajo de la opción de pago. Los pagos realizados en el otro modo siguen usando la clave de su propio modo para las comprobaciones de estado y los reembolsos. Por defecto: on.

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_).

Las claves guardadas nunca vuelven a mostrarse. 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 conserva el valor guardado.

Webhook: muestra la URL del webhook. No hace falta configurar nada: el módulo envía esta URL a Mollie con cada pago. Con URLs amigables tiene este aspecto: https://your-shop/module/wcp_mollie_gateway/webhook, posiblemente con un código de idioma. Debe ser accesible desde internet; si no, los pedidos solo se crean cuando el cliente vuelve desde Mollie.

Pedidos

Order Status After Payment: el estado del pedido que se establece tras un pago correcto. El estado se establece en un solo paso.

Processing: el pedido pasa a Payment accepted (por defecto).
Completed: el pedido pasa a Delivered.

Las transferencias bancarias esperan en Awaiting Mollie payment. Los pagos autorizados y las diferencias de importe o moneda pasan a Mollie payment on hold.

Avanzado

Logging: registra las llamadas a la API y los webhooks en logs/molg_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, incluso con esta opción desactivada. Las claves de API y los datos de los clientes nunca se registran. Por defecto: off.

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, los ajustes del módulo y su registro se eliminan al desinstalar el módulo. Los ID de pago de Mollie guardados con los pedidos, los registros de reembolsos y los estados de pedido del módulo siempre se conservan. Por defecto: off.

Finalización de compra

En el paso de pago el cliente elige la opción de pago (por defecto Mollie) y confirma. El módulo crea un pago de Mollie por el total del carrito en la moneda del carrito (JPY e ISK sin decimales), con la descripción Order # y el número del carrito, 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. En este momento todavía no existe ningún pedido.

Los webhooks de Mollie no llevan firma, solo el ID del pago. Por eso el módulo nunca confía en un webhook por sí mismo: solo acepta los ID de pago que ha creado él mismo, lee el pago desde la API de Mollie con la clave del modo en que se realizó, comprueba que el pago pertenece al carrito y compara el importe y la moneda pagados con el total del carrito. El pedido solo se marca como pagado cuando Mollie lo confirma de esta forma. El módulo gestiona estos estados de pago de Mollie:

paid: el pago se ha realizado. El pedido se crea en el estado de Order Status After Payment cuando el importe y la moneda coinciden.
authorized: el pago fue autorizado pero no capturado. El pedido se crea en Mollie payment on hold con una nota; captúralo en Mollie Dashboard y el pedido se marcará como pagado automáticamente.
open (bank transfer): Mollie espera el dinero. El pedido se crea en Awaiting Mollie payment y se marca como pagado cuando Mollie recibe el dinero.
open, pending: el pago aún no ha terminado. No cambia nada.
failed, expired, canceled: el último intento de pago no tuvo éxito. Sin pedido, el cliente puede volver a pagar; un pedido que espera este pago pasa a Payment error.
chargeback: Mollie informa de un importe contracargado. Se añade una nota y un pedido pagado se pone en espera.

Cuando el cliente vuelve, el módulo comprueba de la misma forma el último pago del carrito con la API de Mollie. Un pago realizado lleva a la página estándar de confirmación del pedido con Your payment with Mollie has been received. En una transferencia bancaria, la página muestra Your order will be processed as soon as Mollie receives your bank transfer. Si el pedido está en espera, la página muestra We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. Si el pago de un pedido existente falló o el pedido fue cancelado, la página muestra Your Mollie payment was not completed. Please contact us about this order.

Si el pago fue cancelado, fallido, expiró o no se completó, el cliente vuelve a la finalización de compra 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. El carrito se conserva. Si Mollie no responde o todavía no ha decidido, aparece una página Payment confirmation que pide al cliente que no vuelva a pagar y ofrece un botón Check again; el webhook crea el pedido en cuanto llega.

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 carrito ha cambiado, el pago abierto anterior se cancela en Mollie cuando Mollie lo permite. Si el pago anterior se realizó mientras tanto, el pedido se crea sin un nuevo pago.

Si Mollie no puede iniciar el pago, el cliente permanece en la finalización de compra con 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 escribe en el registro.

El webhook funciona aunque la tienda esté en modo mantenimiento y no le afecta la restricción de países de tu tienda.

El cliente elige el método de Mollie en la página de Mollie, no en tu finalización de compra. El módulo no tiene suscripciones ni pagos recurrentes, ni tarjetas guardadas ni mandatos, ni campos de tarjeta en tu sitio, ni botones express de Apple Pay o PayPal, y no usa la Orders API, por lo 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 se anulan en Mollie Dashboard, no desde PrestaShop.

Pedidos y reembolsos

Estados del pedido

Sin pedido todavía: el cliente fue enviado a Mollie y no ha pagado, o Mollie todavía no ha confirmado el pago. Solo existe el carrito.

Payment accepted o Delivered: el pago fue confirmado. El estado sigue a Order Status After Payment. El pago se registra con el ID de pago de Mollie (tr_...) como ID de transacción, y una nota muestra el pago de Mollie, el método y el modo.

Awaiting Mollie payment: el cliente eligió transferencia bancaria en la página de Mollie. El pedido pasa al estado de pagado cuando Mollie recibe el dinero.

Mollie payment on hold: un pago autorizado espera la captura, Mollie informó de un contracargo, el importe o la moneda pagados eran distintos del carrito (por ejemplo, el carrito se modificó después de iniciar el pago), se pagó una prueba con la tienda en modo real (no se recibió dinero), o el pago llegó después de que el pedido se cancelara. La nota lo explica. Revisa el pago en Mollie Dashboard y después procesa el pedido o reembolsa el pago.

Payment error: falló, expiró o se canceló una transferencia bancaria o una autorización de un pedido existente. Un pedido pagado nunca se modifica.

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

Si se paga un segundo pago del mismo carrito, el pedido no cambia. Una nota te pide reembolsar el pago duplicado en tu Mollie Dashboard.

Bloque de pago de Mollie

La página del pedido muestra un bloque Mollie payment con el ID del pago de Mollie, el método, el estado del pago, el importe pagado y reembolsado, una insignia Test mode para los pagos de prueba, el historial de reembolsos y las Mollie notes del pedido. Las notas solo son visibles en el back office.

Reembolsos

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

El módulo no crea facturas de abono. Los botones de reembolso estándar de PrestaShop de la página del pedido no devuelven dinero a través de Mollie. Los reembolsos creados en Mollie Dashboard no se muestran en el pedido; un contracargo añade una nota.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Mollie Gateway es el primero de la página Modules > Module Manager > VibeFox Mollie Gateway > Configure, por encima de los ajustes. Introduce 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 están la línea Product: presta-payment-mollie 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 es aceptada, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on con una fecha. Tras 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. Eliminar la clave de la tienda no libera su hueco de dominio. Libéralo en tu cuenta de vibefox.net.

Sin una clave activa, Mollie 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 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 tras introducir la clave, y después una vez a la semana. No se necesita 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

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 del carrito es compatible con Mollie. La página de ajustes muestra un aviso si falta una clave y si la moneda de la tienda no es compatible. 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 webhook no puede llegar a tu tienda. La URL que aparece en Webhook debe ser accesible desde internet (sin autenticación básica ni cortafuegos que lo impidan). El pedido también se crea cuando el cliente vuelve a la tienda tras pagar, o cuando el cliente hace clic en Check again.

El webhook responde Unknown payment.: el pago no fue creado por esta tienda, o Mollie no lo conoce con la clave de API de su modo, por ejemplo un pago de otra cuenta de Mollie.

El webhook responde Payment ID mismatch.: el pago no pertenece al carrito para el que se creó. No se cambia nada.

El webhook responde Failed to fetch payment.: no se pudo contactar con la API de Mollie, o la clave de API del modo del pago no está configurada. Mollie vuelve a intentar el webhook más tarde.

El webhook responde Temporarily unavailable.: otra petición estaba procesando el carrito en el mismo momento, o no se pudo crear el pedido (por ejemplo, el módulo está desactivado). Mollie vuelve a intentar el webhook. Activa Logging para ver el motivo.

La URL del webhook muestra Method not allowed. en el navegador: es normal. La URL solo acepta peticiones de Mollie.

Una clave de API no se guarda: la clave debe empezar por test_ o live_ seguido de al menos 30 letras y números. Cópiala de nuevo desde Mollie Dashboard.

El cliente ve un error al elegir Mollie: mira el campo Log en la página del módulo. Muestra el código HTTP y el mensaje de Mollie. 401 significa una clave de API incorrecta; 422 indica un campo de la petición, por ejemplo un importe o una moneda que Mollie no acepta.

El pedido está en Mollie payment on hold: lee las notas del pedido (véase Estados del pedido) y después procesa el pedido o reembolsa el pago.

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 o datos de pago: los desarrolladores pueden cambiar la lista de monedas con el hook actionWcpMollieSupportedCurrencies y la petición de pago con el hook actionWcpMolliePaymentData.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox Mollie Gateway y elige Uninstall. La clave de licencia y el estado de la licencia de este módulo siempre se eliminan. Si Delete Data on Uninstall 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 ID de pago y los registros de reembolsos de Mollie y los estados de pedido Awaiting Mollie payment y Mollie payment on hold siempre se conservan, así que los pedidos pagados antes pueden reembolsarse tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.

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