PrestaShop

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

Live demo

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
1.7.x	v1.x (latest)	≥ 7.4	Pick the latest 1.x tag on the releases page

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.x release tag.

You also need:

• A MONEI account
• The PHP curl extension enabled

Before you begin

To test your integration:

• Use your test mode API Key. You can find it in MONEI Dashboard → Settings → API Access.
• You can check the status of a test payment in your MONEI Dashboard → Payments (in test mode).

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.

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

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

Enter your API Key. You can find your API Key in MONEI Dashboard → Settings → API Access.

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 + ) 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 so returning customers can pay with a saved card.

Card field layout

Under Card field layout, choose how the card form looks.

Single line (default) — card number, expiry and CVC share one field, which suits a compact checkout.

Split fields — number, expiry and CVC each get their own field. Focus moves from number to expiry to CVC as the customer types.

Both layouts inherit your theme's own input styling, so the card fields match the rest of your checkout on the classic and hummingbird themes alike. Card details go straight to MONEI whichever you pick, so your PCI DSS scope stays at SAQ A.

Saved cards

Turn on card tokenization to let a customer reuse a card. At checkout they see Save Card details for future payments, and any card they saved appears the next time they pay. Card details are stored on MONEI servers, never in your PrestaShop database.

Supported payment methods

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

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

Express checkout

Express checkout puts an Apple Pay, Google Pay or PayPal button on your product and cart pages. The customer pays from the wallet sheet, and the shipping and billing address comes from the wallet, so nobody fills in the checkout form.

To turn it on, open MONEI → Configure → Express Checkout and set:

Setting	What it does
Enable Express Checkout	Turns the buttons on. Off by default.
Show on	Where the buttons appear: Product page, Cart page.

It is not shown on the checkout payment step: by then the shopper has already entered their email, address and carrier, so a wallet button there would only duplicate the ordinary Apple Pay, Google Pay and PayPal payment options.

The same conditions as the regular payment method apply. Apple Pay needs your domain registered, and the Apple Pay or Google Pay button only appears for a customer whose device and browser can pay with that wallet. PayPal needs a connected PayPal business account.

For the equivalent in a custom integration, see Express checkout.

Before you go live

• Make sure that you are using live (production) mode API Key.
• Make sure that you have at least one active payment method.
• 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.