# 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](https://woocommerce-demo.monei.com)

## Requisitos[​](#requisitos "Enlace directo al 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[​](#antes-de-empezar "Enlace directo al Antes de empezar")

Para probar tu integración:

* Usa tu clave de API del [modo de prueba](https://docs.monei.com/es/es/testing/.md). Puedes encontrarla en [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).
* Puedes comprobar el estado de un pago de prueba en [MONEI Dashboard → Payments](https://dashboard.monei.com/payments) (en modo de prueba).

## Instalar[​](#instalar "Enlace directo al Instalar")

![Instalar MONEI WooCommerce](/es/assets/images/configure-woo-0-2225e48f0e2ae37695063d05f930a8ee.png)

[](https://wordpress.org/plugins/monei/)

[Descargar desde wordpress.org](https://wordpress.org/plugins/monei/)

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](https://github.com/MONEI/MONEI-WooCommerce/releases) y súbelo desde **Plugins → Añadir nuevo → Subir plugin**.

## Configurar[​](#configurar "Enlace directo al 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](https://dashboard.monei.com/settings/api). Las credenciales de prueba y de producción tienen campos separados — el interruptor de **Mode** determina qué par está activo.

![Configurar MONEI WooCommerce](/es/assets/images/configure-woo-1-7cbac5ff60b4c3092ee478d388e2b0c2.png)

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.

![Configurar pagos con tarjeta](/es/assets/images/configure-woo-2-025f30aade6a206acd63266e44598795.png)

## Métodos de pago admitidos[​](#métodos-de-pago-admitidos "Enlace directo al 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[​](#migración-a-woocommerce-blocks "Enlace directo al Migración a WooCommerce Blocks")

A partir de la **versión 6.0**, el plugin admite [WooCommerce Blocks](https://woocommerce.com/document/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.

![Configurar la página de Checkout](/es/assets/images/configure-woo-3-8a636d28f76456cb8833c97d276006df.png)

Ve a **Pages** y busca la página **Cart**. Elimina el shortcode antiguo y añade el bloque **Cart** a la página.

![Configurar la página del carrito](/es/assets/images/configure-woo-4-9a987623e70fc009f8060c63fc792e1e.png)

## Antes de pasar a producción[​](#antes-de-pasar-a-producción "Enlace directo al Antes de pasar a producción")

* Asegúrate de usar la clave de API del [modo en vivo (producción)](https://docs.monei.com/es/es/testing/.md).
* Asegúrate de tener al menos un [método de pago](https://dashboard.monei.com/settings/payment-methods) 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](https://dashboard.monei.com/settings/apple-pay).
* Si usas el checkout con Blocks, confirma que las páginas de Carrito y Checkout usan bloques (no shortcodes).