# PrestaShop

To accept payments through MONEI in your PrestaShop store you simply need to install and configure MONEI PrestaShop Module.

[Live demo](https://prestashop-demo.monei.com/)

## Requirements[​](#requirements "Direct link to Requirements")

The module ships as two parallel release lines from the same repository. Pick the one that matches your PrestaShop major — installing the wrong line fails silently with PrestaShop's generic "no additional details" modal.

| Your PrestaShop | Module line     | PHP   | Download                                                                                                           |
| --------------- | --------------- | ----- | ------------------------------------------------------------------------------------------------------------------ |
| 8.0 and newer   | 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 | Pick the latest `1.7.x` tag on the [releases page](https://github.com/MONEI/MONEI-PrestaShop/releases)             |

Both lines receive parallel releases. The `releases/latest` link always points to the v2.x ZIP, so PrestaShop 1.7 merchants must select an explicit `1.7.x` release tag.

You also need:

* A [MONEI account](https://dashboard.monei.com/signup)
* The PHP `curl` extension enabled

## Before you begin[​](#before-you-begin "Direct link to Before you begin")

To test your integration:

* Use your [test mode](https://docs.monei.com/testing/.md) API Key. You can find it in [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).
* You can check the status of a test payment in your [MONEI Dashboard → Payments](https://dashboard.monei.com/payments) (in test mode).

## Install[​](#install "Direct link to Install")

1. Download the correct `monei.zip` for your PrestaShop version from the table above.
2. Go to your PrestaShop admin panel.
3. Navigate to **Modules → Module Manager**.
4. Click on **Upload a module**.
5. Select the downloaded `monei.zip` file.

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

tip

If install fails with the generic "no additional details" error, you most likely downloaded the wrong version for your PrestaShop major. Check the table above and download the matching release.

## Configure[​](#configure "Direct link to Configure")

Go to **PrestaShop → Payment → Payment Methods → MONEI → Configure**

![Configure Card Payments](/assets/images/configure-prestashop-1-839c442b2e12c43d01cc736a1629dded.png)

Enter your API Key. You can find your API Key in [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).

From the configuration screen you can:

* Toggle between **test** and **live** mode (each mode has its own API key field).
* Choose a payment action — **Sale** (auth + capture) or **Authorize** (capture later from the admin).
* Enable or disable each payment method individually (Card, Apple Pay, Google Pay, Bizum, PayPal, Multibanco, MB Way).
* For each method, choose between an **inline** form on checkout or a **redirect** to MONEI's Hosted Payment Page.
* Enable **card tokenization** so returning customers can pay with a saved card.

## Supported payment methods[​](#supported-payment-methods "Direct link to Supported payment methods")

* Card (Visa, Mastercard, and more)
* Apple Pay
* Google Pay
* Bizum (Spain)
* PayPal
* Multibanco (Portugal)
* MB Way (Portugal)

Pre-authorization (Authorize + later capture) is supported for Card, Apple Pay, Google Pay and PayPal. Not supported for MB Way and Multibanco.

## Before you go live[​](#before-you-go-live "Direct link to Before you go live")

* Make sure that you are using [live (production) mode](https://docs.monei.com/testing/.md) API Key.
* Make sure that you have at least one active [payment method](https://dashboard.monei.com/settings/payment-methods).
* Verify your webhook URL is reachable from MONEI (no IP allowlist, no Cloudflare bot block).
* For Apple Pay, register your domain in [MONEI Dashboard → Settings → Payment methods](https://dashboard.monei.com/settings/payment-methods).