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 | 6.8 |
| WooCommerce | 3.0 | 9.8 |
| PHP | 8.0 | 8.3 |
:::caution PHP 8.0 requerido desde la versión 7.0.1 del plugin 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 → Settings → API Access.
- 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 → Settings → API Access. Las credenciales de prueba y de producción tienen campos separados — el interruptor de Mode determina qué par está activo.
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 alojada), personalizar el título y la descripción, y aplicar tema al formulario embebido mediante JSON.
Métodos de pago admitidos
- Tarjeta (Visa, Mastercard y más) — con tokenización 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)
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.
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 → Apple Pay.
- Si usas el checkout con Blocks, confirma que las páginas de Carrito y Checkout usan bloques (no shortcodes).