# PrestaShop

Para aceptar pagos a través de MONEI en tu tienda PrestaShop solo necesitas instalar y configurar el módulo MONEI para PrestaShop.

[Demo en vivo](https://prestashop-demo.monei.com/)

## Requisitos[​](#requisitos "Enlace directo al Requisitos")

El módulo se distribuye en dos líneas de versiones paralelas desde el mismo repositorio. Elige la que corresponda a tu versión principal de PrestaShop — instalar la línea incorrecta falla silenciosamente con el modal genérico de PrestaShop "no hay detalles adicionales".

| Tu PrestaShop  | Línea del módulo | PHP   | Descarga                                                                                                              |
| -------------- | ---------------- | ----- | --------------------------------------------------------------------------------------------------------------------- |
| 8.0 y superior | v2.x (latest)    | ≥ 7.4 | [releases/latest/download/monei.zip](https://github.com/MONEI/MONEI-PrestaShop/releases/latest/download/monei.zip)    |
| 1.7.x          | v1.7.x (latest)  | ≥ 7.4 | Selecciona la última etiqueta `1.7.x` en la [página de versiones](https://github.com/MONEI/MONEI-PrestaShop/releases) |

Ambas líneas reciben versiones paralelas. El enlace `releases/latest` siempre apunta al ZIP de v2.x, por lo que los comercios con PrestaShop 1.7 deben seleccionar una etiqueta de versión `1.7.x` explícita.

También necesitas:

* Una [cuenta MONEI](https://dashboard.monei.com/signup)
* La extensión PHP `curl` activada

## 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")

1. Descarga el `monei.zip` correcto para tu versión de PrestaShop desde la tabla anterior.
2. Ve al panel de administración de PrestaShop.
3. Navega a **Modules → Module Manager**.
4. Haz clic en **Upload a module**.
5. Selecciona el archivo `monei.zip` descargado.

![Configurar MONEI PrestaShop](/es/assets/images/configure-prestashop-0-3a4c2ea73553c2db32389837f73c7849.png)

tip

Si la instalación falla con el error genérico "no hay detalles adicionales", lo más probable es que hayas descargado la versión incorrecta para tu versión principal de PrestaShop. Consulta la tabla anterior y descarga la versión correspondiente.

## Configurar[​](#configurar "Enlace directo al Configurar")

Ve a **PrestaShop → Payment → Payment Methods → MONEI → Configure**

![Configurar pagos con tarjeta](/es/assets/images/configure-prestashop-1-839c442b2e12c43d01cc736a1629dded.png)

Introduce tu clave de API. Puedes encontrar tu clave de API en [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).

Desde la pantalla de configuración puedes:

* Alternar entre modo **test** y **live** (cada modo tiene su propio campo de clave de API).
* Elegir una acción de pago — **Sale** (autorización + captura) o **Authorize** (captura posterior desde el panel de administración).
* Activar o desactivar cada método de pago individualmente (Tarjeta, Apple Pay, Google Pay, Bizum, PayPal, Multibanco, MB Way).
* Para cada método, elegir entre un formulario **inline** en el checkout o una **redirección** a la página de pago alojada de MONEI.
* Activar la **tokenización de tarjeta** para que los clientes recurrentes puedan pagar con una tarjeta guardada.

## Métodos de pago admitidos[​](#métodos-de-pago-admitidos "Enlace directo al Métodos de pago admitidos")

* Tarjeta (Visa, Mastercard y más)
* Apple Pay
* Google Pay
* Bizum (España)
* PayPal
* Multibanco (Portugal)
* MB Way (Portugal)

La preautorización (Authorize + captura posterior) está disponible para Tarjeta, Apple Pay, Google Pay y PayPal. No está disponible para MB Way y Multibanco.

## 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 tu URL de webhook sea accesible desde MONEI (sin lista de IPs permitidas, sin bloqueo de bots de Cloudflare).
* Para Apple Pay, registra tu dominio en [MONEI Dashboard → Apple Pay](https://dashboard.monei.com/settings/apple-pay).