WooCommerce
Para aceptar pagos a través de MONEI en tu tienda WooCommerce solo necesitas instalar y configurar el plugin MONEI para WooCommerce.
Demo en vivo
Requisitos
| Componente | Mínimo | Probado hasta |
|---|---|---|
| WordPress | 5.0 | 7.0 |
| WooCommerce | 3.0 | 11.0 |
| PHP | 8.0 | 8.3 |
Las versiones 7.0.1 y posteriores del plugin requieren PHP 8.0+. Si todavía usas PHP 7.4, actualiza PHP antes de actualizar el plugin — WordPress tampoco soporta ya PHP 7.4.
El plugin es compatible con:
- WooCommerce Blocks (Carrito + Checkout) — consulta la sección de migración más abajo
- High-Performance Order Storage (HPOS)
- WooCommerce Subscriptions y YITH WooCommerce Subscription para facturación recurrente con tarjetas guardadas
Antes de empezar
Para probar tu integración:
- Usa tu clave de API del modo de prueba. Puedes encontrarla en MONEI Dashboard → Configuración → Acceso a API.
- Puedes comprobar el estado de un pago de prueba en MONEI Dashboard → Payments (en modo de prueba).
Instalar
La forma recomendada es wp-admin → Plugins → Añadir nuevo → busca MONEI → Instalar → Activar. WordPress actualizará el plugin automáticamente en el futuro.
Para una versión previa al lanzamiento o una etiqueta específica, descarga el ZIP desde la página de versiones de GitHub y súbelo desde Plugins → Añadir nuevo → Subir plugin.
Configurar
Ve a WooCommerce → Settings → MONEI Settings
Introduce tu Account ID y tu clave de API. Puedes encontrar tu Account ID y tu clave de API en MONEI Dashboard → Configuración → Acceso a API. Las credenciales de prueba y de producción tienen campos separados — el interruptor de Mode determina qué par está activo.
El resto de la página define cómo se comporta cada método de MONEI:
| Ajuste | Qué hace |
|---|---|
| API Key Mode | Qué par de credenciales está activo, Test o Live. |
| What to do after payment? | El estado que recibe un pedido pagado: Processing (recomendado) o Complete. Usa Complete solo si no hay que preparar ni enviar nada. |
| Payment Action | Sale cobra de inmediato. Authorization retiene el dinero hasta que lo capturas — consulta Acción de pago. |
| Log Level | Cuánto escribe el plugin en WooCommerce → Status → Logs — consulta Resolver problemas. |
Ve a WooCommerce → Settings → Payments
Configura los métodos de pago que quieres aceptar en tu tienda. Cada método de MONEI tiene su propio panel de ajustes donde puedes alternar entre el modo component (formulario inline) y redirect (página de pago alojada), personalizar el título y la descripción, y aplicar tema al formulario embebido mediante JSON.
Diseño de los campos de tarjeta
En MONEI Cards, Card Field Layout decide el aspecto del formulario de tarjeta.
Separate fields (por defecto) — el número, la caducidad y el CVC tienen cada uno su propio campo. El foco pasa del número a la caducidad y al CVC a medida que el cliente escribe.
Single line — los tres comparten un solo campo, lo que encaja en un checkout compacto.
Card Input Style aplica el tema a ambos diseños desde el mismo JSON, así que cambiar de diseño mantiene tu estilo.
Hasta la v7.2.4 el valor por defecto era una sola línea. Si nunca elegiste un diseño, tu checkout pasa a campos separados al actualizar — elige Single line en MONEI Cards para mantener el formulario anterior. Si ya habías elegido un diseño, se conserva.
Elijas el que elijas, los datos de la tarjeta van directos a MONEI y tu alcance de PCI DSS se mantiene en SAQ A.
Tarjetas guardadas
En MONEI Cards, activa Saved cards para que un cliente pueda reutilizar una tarjeta. En el checkout verá Guardar la información de pago en mi cuenta para futuras compras, y cualquier tarjeta que haya guardado aparecerá la próxima vez que pague.
Los datos de la tarjeta se guardan en los servidores de MONEI, nunca en tu base de datos de WordPress. Las tarjetas guardadas son además lo que hace posible la facturación recurrente — consulta Suscripciones.
Métodos de pago admitidos
- Tarjeta (Visa, Mastercard y más) — con para tarjetas guardadas
- Apple Pay
- Google Pay
- Bizum (España — se oculta automáticamente para clientes no españoles)
- PayPal
- Multibanco (Portugal — oculto para clientes no portugueses, solo redirección)
- MB Way (Portugal — oculto para clientes no portugueses, solo redirección)
Express checkout
Express checkout coloca un botón de Apple Pay, Google Pay o PayPal en tu tienda. El cliente paga desde la hoja de la wallet, y la dirección de envío y facturación viene de la wallet, así que nadie rellena el formulario de checkout. Funciona tanto en el checkout clásico como en los bloques de Carrito y Checkout.
Express checkout está disponible a partir de la versión 7.1.0 del plugin.
Para activarlo, ve a WooCommerce → Settings → Payments, abre MONEI Apple Pay / Google Pay o MONEI PayPal, y configura:
| Ajuste | Qué hace |
|---|---|
| Express Checkout | Activa el botón. Desactivado por defecto. |
| Express Checkout Button Locations | Dónde aparece el botón: Product page, Cart page, Checkout page. Los tres por defecto. |
| Express Checkout Button Style | Aplica el tema al botón en JSON. |
Cada método es independiente — puedes ofrecer un botón de wallet solo en la página de producto, y PayPal en ninguna, si eso encaja con tu tienda.
Se aplican las mismas condiciones que al método de pago normal. Apple Pay necesita tu dominio registrado, y el botón de Apple Pay o Google Pay solo aparece para un cliente cuyo dispositivo y navegador puedan pagar con esa wallet.
PayPal devuelve el nombre, el email y el país del comprador, y una dirección postal solo cuando la cuenta tiene una guardada. Los bloques de Carrito y Checkout crean el pedido a través de la Store API de WooCommerce, que exige una dirección de facturación completa y rechaza una incompleta. La página de producto crea el pedido por su cuenta y acepta lo que envía PayPal. Si se rechaza a un comprador, la tienda ahora indica qué campos faltan en lugar de fallar en silencio.
Para el equivalente en una integración personalizada, consulta Express checkout.
Suscripciones
El plugin factura suscripciones con WooCommerce Subscriptions o con YITH WooCommerce Subscription. Instala uno de los dos y MONEI Cards y MONEI Apple Pay / Google Pay aceptarán productos de suscripción — el resto de métodos de MONEI no.
Activa primero las tarjetas guardadas. Una renovación cobra el token guardado con el primer pago, así que sin ellas no hay nada que cobrar el día de la renovación.
El cliente cambia la tarjeta asociada a una suscripción desde Mi cuenta → Suscripciones → Cambiar pago.
Para suscripciones creadas a través de la API, consulta Suscripciones.
Acción de pago
WooCommerce → Settings → MONEI Settings → Payment Action decide cuándo se mueve el dinero.
Sale (Immediate charge) — la opción por defecto. Se cobra al cliente en el momento de pagar.
Authorization (Pre-authorization) — el dinero queda retenido en la tarjeta del cliente y el pedido pasa a On hold. Lo capturas moviendo el pedido a Processing o Completed, o lo liberas moviendo el pedido a Cancelled o Refunded. Ambas cosas ocurren automáticamente al cambiar el estado; no hay un botón de captura aparte.
Captura dentro de los 7 días siguientes a un pago con tarjeta. Pasado ese plazo la autorización se marca como caducada y ya no se puede capturar — tendrás que pedir al cliente que pague de nuevo. El plazo lo fija el método de pago, así que no es el mismo en todos; consulta Pagos para saber cuál se aplica.
La preautorización se aplica a Tarjeta, Apple Pay, Google Pay y PayPal. MB Way y Multibanco cobran de inmediato diga lo que diga este ajuste.
Antes de la 7.2.4 esos dos métodos cobraban de inmediato aunque estuviera seleccionado Authorization. Actualiza el plugin si dependes de ello.
Reembolsos
Reembolsa desde el propio pedido: WooCommerce → Orders, abre el pedido y elige Refund. Introduce el importe completo o una parte, y usa el botón de reembolso que nombra el método de pago de MONEI — no Refund manually, que solo ajusta el pedido en WooCommerce y no mueve dinero. El reembolso llega a MONEI de inmediato y el pedido recibe una nota con el resultado.
Un reembolso que MONEI rechaza también deja una nota en el pedido explicando por qué.
Migración a WooCommerce Blocks
A partir de la versión 6.0, el plugin admite WooCommerce Blocks. Para activar la experiencia de checkout moderna, reemplaza los shortcodes heredados por los bloques de Carrito y Checkout.
Ve a Pages y busca la página Checkout. Elimina el shortcode antiguo y añade el bloque Checkout a la página.
Ve a Pages y busca la página Cart. Elimina el shortcode antiguo y añade el bloque Cart a la página.
Resolver problemas
Pon WooCommerce → Settings → MONEI Settings → Log Level en INFO mientras reproduces el problema, y después lee el registro en WooCommerce → Status → Logs eligiendo el archivo MONEI.
Vuelve a dejar el nivel en ERROR al terminar. INFO escribe una línea por cada paso del pago y penaliza el rendimiento en una tienda con tráfico.
Un método de pago no aparece en el checkout
- El método tiene que estar activo en MONEI Dashboard → Configuración → Métodos de pago además de habilitado en WooCommerce.
- Bizum, MB Way y Multibanco se ocultan para un cliente fuera del país al que sirven.
- Apple Pay y Google Pay solo aparecen en un dispositivo y navegador que puedan pagar con ellos. Apple Pay necesita además tu dominio registrado.
- El plugin cachea durante 30 segundos qué métodos ofrece tu cuenta, así que un cambio en el dashboard tarda un momento y una recarga en verse.
Un pedido sigue en Pending después de que el cliente pagó
MONEI confirma un pago mediante la llamada IPN. Si tu tienda nunca la recibe, el pago aparece correcto en el dashboard mientras el pedido sigue en Pending.
Comprueba que https://<tu-tienda>/wc-api/monei_ipn/ sea accesible desde fuera — sin lista de IPs permitidas, sin protección antibots por delante, y con los permalinks guardados al menos una vez.
Antes de pasar a producción
- Asegúrate de usar la clave de API del modo en vivo (producción).
- Asegúrate de tener al menos un método de pago activo.
- Verifica que la URL de IPN
https://<tu-tienda>/wc-api/monei_ipn/sea accesible desde MONEI (sin lista de IPs permitidas, sin bloqueo de bots de Cloudflare, con los permalinks guardados). - Para Apple Pay, registra tu dominio en MONEI Dashboard → Configuración → Métodos de pago.
- Si usas el checkout con Blocks, confirma que las páginas de Carrito y Checkout usan bloques (no shortcodes).