Resumen rápido
- Instala Mollie Payments for WooCommerce, el plugin oficial de Mollie.
- Conecta primero la tienda utilizando la Test API Key, no la clave de producción.
- Activa cada método de pago tanto en Mollie como en WooCommerce.
- Haz pedidos de prueba simulando al menos un pago correcto, uno fallido y uno cancelado.
- No des por hecho que Bizum se activa marcando una casilla: para comercios españoles requiere un proceso previo con el banco y Mollie.
- Pasa a Live API únicamente cuando hayas comprobado que checkout, pagos y estados de pedidos funcionan.
- Si Mollie registra el pago pero WooCommerce deja el pedido pendiente, revisa especialmente los webhooks y los logs.
- El plugin puede instalarse sin comprar una licencia, pero procesar pagos sí tiene costes por transacción.
Cómo instalar y conectar Mollie con WooCommerce
Mollie actúa como proveedor de pagos y WooCommerce como sistema que gestiona los productos, el carrito y los pedidos de tu tienda. El plugin es la pieza que conecta ambos.
Si quieres entender mejor qué ocurre detrás del checkout, nuestra guía sobre cómo funcionan las pasarelas de pago te ayudará a situar cada parte. En la práctica, para configurar Mollie no necesitas programar una integración desde cero.
1. Comprueba que tu tienda está preparada
Antes de instalar nada, necesitas:
- WordPress funcionando correctamente.
- WooCommerce instalado y configurado.
- Acceso de administrador a WordPress.
- Una cuenta de Mollie.
- HTTPS activo en tu tienda.
- Posibilidad de realizar pedidos de prueba.
La ficha del plugin oficial establece como requisitos PHP 8.0 o superior, WordPress 5.0 o superior y WooCommerce 3.9 o superior, además de las extensiones PHP cURL y JSON. Si trabajas con un WordPress antiguo, actualiza primero el entorno y comprueba compatibilidades antes de tocar el sistema de cobro.
Puedes consultar la ficha de Mollie Payments for WooCommerce en WordPress.org.
Consejo Finantres: si la tienda ya vende y vas a cambiar una pasarela que funciona, haz primero una copia de seguridad y, cuando sea posible, prueba el cambio en staging. Una actualización del sistema de cobro merece algo más de cuidado que instalar un plugin cualquiera.
2. Instala Mollie Payments for WooCommerce
Desde el panel de WordPress:
- Entra en Plugins > Añadir nuevo.
- Busca
Mollie Payments for WooCommerce. - Comprueba que el desarrollador es Mollie.
- Pulsa Instalar.
- Cuando termine, pulsa Activar.
No instales el primer complemento que incluya la palabra “Mollie”. En una pasarela de pago interesa utilizar la integración oficial salvo que tengas una razón técnica muy concreta para recurrir a otra solución.
Una vez activado, encontrarás la configuración de Mollie dentro de los ajustes de WooCommerce.
3. Conecta Mollie mediante las claves API
Aquí aparece el concepto que más dudas genera si nunca has configurado una pasarela: la API key.
Puedes pensar en ella como una credencial privada que permite que tu WooCommerce se comunique con Mollie. No es una contraseña que debas compartir, publicar en una captura o enviar por correo sin protección.
Mollie diferencia entre dos credenciales:
- Test API Key: sirve para configurar y probar.
- Live API Key: sirve para procesar pagos reales.
En Mollie, accede a la sección de desarrolladores y claves API de tu perfil. Después vuelve a WordPress y entra en:
WooCommerce > Ajustes > Mollie Settings
Introduce la clave de prueba en su campo correspondiente y selecciona el modo Test API. Guarda los cambios.
La documentación oficial de Mollie recomienda mantener el modo de prueba mientras configuras la integración y pasar a producción cuando hayas comprobado que funciona correctamente. Puedes revisar también su guía oficial de integración con WooCommerce.
No publiques nunca una Test API Key ni, mucho menos, una Live API Key. Aunque estés preparando capturas para un tutorial interno, ocúltala por completo.
Cuando esta conexión funciona, WooCommerce ya puede comunicarse con Mollie. Eso es precisamente lo que convierte a esta configuración en un sistema de pagos integrados: el pedido se crea en WooCommerce y el proveedor de pagos informa posteriormente de lo que ha ocurrido con el cobro.
Configura los métodos de pago y el checkout
Conectar la API no significa que todos los métodos de Mollie vayan a aparecer automáticamente en tu tienda.
Hay dos niveles de activación que conviene distinguir:
- El método tiene que estar disponible y activado para tu perfil en Mollie.
- Después debes habilitarlo en WooCommerce.
Este detalle explica muchos casos de “lo he activado y no aparece”.
En WooCommerce puedes entrar en los ajustes de Mollie, localizar cada método y editarlo para habilitarlo. También puedes modificar su título, descripción, logotipo, países en los que quieres mostrarlo y otras opciones de presentación.
Tarjetas, Apple Pay y otros métodos
No necesitas activar todos los medios de pago que Mollie admite. Más opciones no siempre significan un checkout mejor.
Para una tienda orientada a España puede tener sentido empezar con tarjeta y añadir después métodos que tus clientes realmente utilicen. Si vendes en otros mercados europeos, Mollie cobra más sentido porque puedes adaptar el checkout con alternativas locales de distintos países.
WooCommerce también permite cambiar el orden en el que aparecen. Coloca arriba las opciones más importantes para tu público y evita convertir la pantalla de pago en un catálogo interminable.
Con Apple Pay hay además requisitos propios. Por ejemplo, Mollie exige tener activadas las tarjetas y pueden intervenir requisitos de validación del dominio. Si las carteras digitales son importantes para tu ecommerce, nuestra guía sobre cómo aceptar Apple Pay y Google Pay en una tienda online amplía esta parte.
Bizum con Mollie en WooCommerce: cuidado con este paso
Para una tienda española, Bizum merece una explicación aparte porque no basta con entrar en WooCommerce y activar un interruptor.
Mollie exige disponer de una cuenta bancaria empresarial española compatible con Bizum. El proceso indicado por Mollie pasa por contactar con el banco para activar el servicio y solicitar que se configure para el PSP de Mollie. El banco facilita después el identificador de comercio —FUC— y el identificador de terminal que Mollie necesita para completar el alta.
Por eso, si Bizum aparece como una prioridad para tu tienda, confirma el alta antes de diseñar todo el checkout alrededor de ese método.
Error común: activar Bizum en el plugin, no verlo en la tienda y asumir que WooCommerce está fallando. Antes de tocar plugins, revisa si el método está realmente disponible y terminado de configurar en tu perfil de Mollie.
¿Checkout redirigido o campos de tarjeta dentro de la tienda?
Mollie permite configurar Mollie Components para integrar los campos de tarjeta dentro de la experiencia de checkout. También existen flujos donde el cliente pasa por el entorno de pago de Mollie.
No hay una opción universalmente mejor. Un checkout integrado puede dar una experiencia más continua, mientras que una solución alojada puede simplificar parte de la gestión técnica. En nuestra comparativa entre checkout alojado y checkout integrado explicamos las diferencias con más detalle.
Para una tienda pequeña, nuestra recomendación es sencilla: no compliques la integración sin una necesidad real. Primero consigue que el flujo estándar cobre, actualice el pedido correctamente y sea fácil de usar en móvil. Después ya puedes optimizar.
Prueba Mollie antes de aceptar pagos reales
Esta es la parte que no deberías saltarte.
El modo de prueba de Mollie permite simular operaciones sin que se transfiera dinero real. Puedes completar el checkout y elegir distintos resultados para comprobar cómo responde WooCommerce.
No hagas únicamente una compra ficticia que termine bien. La prueba mínima que recomendamos es:
- Un pago correcto.
- Un pago fallido.
- Un pago cancelado.
Imagina que tienes un producto de 50 €. Con la Test API Key activa, añádelo al carrito y completa el proceso como si fueras un cliente.
Con el escenario de pago correcto, comprueba:
- que WooCommerce crea el pedido;
- que Mollie registra el intento;
- que el pedido termina en el estado esperado;
- que el cliente llega a la página correcta después del pago.
Después repite el proceso seleccionando un pago fallido y uno cancelado. La tienda no debería tratar ninguno de estos dos como una venta cobrada.
Ese detalle parece evidente hasta que un plugin, una automatización o una personalización cambia un estado que no debería.
Consejo Finantres: prueba también desde móvil. Un checkout que funciona perfectamente desde el ordenador puede esconder problemas de diseño, botones o campos cuando el cliente compra desde una pantalla pequeña.
Apple Pay Direct tiene particularidades propias de prueba y puede requerir un entorno de producción y dispositivos o navegadores compatibles, por lo que no debes utilizarlo como única referencia para validar el sandbox estándar de Mollie.
Cómo pasar de Test API a Live API
Cuando los pedidos de prueba funcionen, puedes preparar la producción.
Antes comprueba que:
- el alta de Mollie está completada;
- tu perfil web ha sido aprobado;
- los métodos que quieres ofrecer están activados;
- has probado el checkout;
- los estados de WooCommerce se actualizan correctamente.
Después entra de nuevo en:
WooCommerce > Ajustes > Mollie Settings
Añade tu Live API Key, selecciona Live API como modo de pago y guarda los cambios.
Mollie indica que los pagos reales no pueden aceptarse hasta que el perfil correspondiente haya sido aprobado.
Haz una última revisión del checkout después del cambio. No des por hecho que algo que funcionaba en test está listo simplemente porque has pegado una clave distinta.
Nuestra regla sería esta: no pases Mollie a producción cinco minutos antes de lanzar una campaña, una promoción o una venta importante. Déjate margen para detectar cualquier problema.
Qué hacer si Mollie no funciona en WooCommerce
Cuando algo falla, tocar diez ajustes a la vez suele empeorar el diagnóstico.
Empieza por identificar exactamente qué parte no funciona.
| Problema | Qué revisar primero |
|---|---|
| Mollie no conecta | Clave API, modo Test/Live y comunicación con Mollie |
| Un método no aparece | Activación en Mollie y habilitación en WooCommerce |
| Funciona en test pero no en producción | Live API Key y aprobación del perfil |
| El cliente ha pagado pero el pedido sigue pendiente | Webhook y logs de WooCommerce |
| Solo falla para determinados compradores | País, moneda y condiciones del método |
| Bizum no aparece | Proceso de activación de Bizum y elegibilidad |
| Apple Pay no aparece | Tarjetas activadas, configuración del dominio y dispositivo/navegador |
| El checkout empieza a fallar tras una actualización | Compatibilidad, caché y conflictos con otros plugins |
El pago aparece en Mollie pero WooCommerce sigue pendiente
Este es uno de los problemas más importantes porque puedes tener un cliente que ha pagado y un pedido que parece no estar cobrado.
Mollie utiliza notificaciones webhook para comunicar a WooCommerce los cambios de estado. Dicho de forma sencilla: cuando el pago cambia, Mollie avisa a tu tienda para que el pedido también se actualice.
Si esa comunicación falla, ambos sistemas pueden acabar mostrando estados diferentes. Mollie señala entre las posibles causas las URL de webhook incorrectas, redirecciones que interfieren, problemas del servidor o conflictos con otros plugins.
No marques manualmente veinte pedidos como pagados antes de saber qué está ocurriendo. Comprueba primero si el dinero se ha recibido realmente en Mollie y después busca el fallo de sincronización.
Mira los logs antes de adivinar
Para investigar incidencias puedes revisar los registros desde:
WooCommerce > Estado > Logs
Mollie también permite activar información de depuración desde sus ajustes. Los registros pueden indicarte si una llamada ha fallado, existe un conflicto o la tienda no está recibiendo correctamente una actualización.
Si el problema apareció después de instalar otro plugin, prueba en staging desactivando complementos no esenciales uno a uno. Mollie menciona expresamente que plugins de envíos, descuentos o promociones pueden provocar determinados conflictos con los pedidos.
No recomendamos empezar a modificar PHP o webhooks manualmente si no sabes exactamente qué estás cambiando. Si el log apunta a servidor, firewall o código, el siguiente paso sensato es escalar el problema al hosting, al desarrollador o al soporte del proveedor.
Costes, seguridad y cuándo tiene sentido usar Mollie
Instalar Mollie Payments for WooCommerce no significa que los cobros sean gratuitos.
Mollie aplica tarifas por transacción que dependen del medio de pago y, en el caso de las tarjetas, pueden variar según el tipo y procedencia de la tarjeta. Apple Pay, por ejemplo, aplica el coste asociado a la tarjeta utilizada.
Por eso conviene diferenciar tres cosas:
- coste del plugin;
- coste de procesamiento;
- coste efectivo que acabas pagando según el tipo de operaciones que recibes.
Un ejemplo hipotético lo deja claro. Si una pasarela cualquiera cobrase un 1,5 % + 0,25 € por una venta de 50 €, el coste sería 0,75 € de porcentaje más 0,25 € fijos: 1 € en total. Esa cifra es solo un ejemplo matemático, no una tarifa de Mollie.
La parte fija pesa mucho más cuando vendes productos baratos. Por eso no elegiríamos una pasarela únicamente mirando el porcentaje anunciado. Nuestra guía sobre comisiones de TPV explica cómo calcular mejor el coste real.
También merece la pena entender la diferencia entre utilizar Mollie y contratar un TPV virtual directamente con otra entidad: ambos pueden permitirte aceptar pagos online, pero cambian proveedor, integración, métodos disponibles, precios y operativa.
¿Es segura la integración de Mollie?
Mollie declara ser una entidad financiera y de dinero electrónico autorizada en la UE y supervisada por el Banco Central Neerlandés, además de contar con certificación PCI DSS Nivel 1 para el procesamiento de pagos con tarjeta. Puedes consultar su información oficial de seguridad y certificaciones.
Eso no significa que instalar Mollie convierta automáticamente a toda tu tienda en segura o elimine tus responsabilidades.
Tu WordPress sigue siendo tu responsabilidad. Mantén el núcleo, WooCommerce y plugins actualizados; protege las cuentas administrativas; utiliza HTTPS; limita accesos y no introduzcas datos de tarjetas en sistemas que no los necesitan.
La propia documentación de Mollie explica que PCI DSS funciona como una responsabilidad compartida. Si quieres profundizar en qué parte sigue correspondiendo al comercio, consulta nuestra guía sobre PCI DSS para comercios.
¿Para qué tienda encaja mejor Mollie?
Mollie tiene especial sentido cuando quieres gestionar distintos métodos de pago desde una misma integración, sobre todo si tu ecommerce vende en España y también en otros mercados europeos.
Puede encajar bien si:
- utilizas WooCommerce y quieres un plugin oficial;
- necesitas tarjeta y métodos de pago adicionales;
- vendes en varios mercados europeos;
- quieres gestionar pagos, devoluciones y métodos desde un mismo proveedor;
- valoras poder adaptar los métodos mostrados al país del cliente.
No necesariamente sería nuestra primera elección si solo quieres la solución más básica para cobrar con tarjeta, tienes una negociación especialmente buena con el TPV virtual de tu entidad o dependes de un método concreto que otra pasarela resuelve mejor.
La elección no debería hacerse únicamente por comodidad técnica. Antes de decidir, compara los mejores TPV virtuales para WooCommerce y las pasarelas de pago para ecommerce que realmente encajen con tu ticket medio, países de venta y métodos de pago.
Si quieres abrir todavía más la comparativa, también puedes revisar nuestra selección de mejores TPV virtuales para autónomos y negocios.
Conclusión
Configurar Mollie en WooCommerce resulta bastante sencillo si respetas un orden: instala el plugin oficial, conecta la Test API Key, activa los métodos que realmente necesitas y prueba varios resultados antes de introducir la Live API Key.
La prueba es más importante que la instalación. No basta con ver los logotipos de tarjeta en el checkout: comprueba que un pago aceptado actualiza el pedido, que uno cancelado no se procesa como venta y que WooCommerce recibe correctamente los cambios de estado.
Para una tienda española, presta además especial atención a Bizum, porque su activación requiere pasos adicionales. Y si Mollie no encaja por costes, métodos o funcionamiento, compáralo con otras soluciones antes de cambiar todo tu sistema de cobro.
Una pasarela bien configurada debería pasar casi desapercibida para el cliente. El objetivo no es tener más opciones de pago, sino conseguir que las adecuadas funcionen de forma fiable cuando alguien decide comprar.
