# MONEI Multibanco

To accept Multibanco payments through MONEI in your Shopify store you simply need to install and configure MONEI Multibanco Shopify App.

This app adds a **single Multibanco option** to your Shopify checkout. When customers select it, they're redirected to get a Multibanco reference to pay, and then returned to your store. It handles **Multibanco only** — to also offer cards, wallets, or other methods, install the matching app alongside it. See the [Shopify apps overview](https://docs.monei.com/e-commerce/shopify/overview/.md) to compare apps.

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

Password: `demo`

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

Before installing, make sure that:

* **The payment method is enabled** in your [MONEI Dashboard → Settings → Payments → Payment methods](https://dashboard.monei.com/settings/payment-methods) (Multibanco).
* **You are in the correct mode**: The app connects to the **test or live mode** you are currently using in the MONEI dashboard. Use the mode switcher in the dashboard header to [switch between test and live mode](https://docs.monei.com/testing/.md), then install the app when you are already in the mode you want. If you are not yet approved for live, you can switch to test mode to try out the apps.

To verify test payments, check [MONEI Dashboard → Payments](https://dashboard.monei.com/payments) (switch to test mode to see test payments).

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

[Install app](https://accounts.shopify.com/store-login?no_redirect=true\&redirect=%2Fadmin%2Fsettings%2Fpayments%2Falternative-providers%2F90701825)

### Installation steps[​](#installation-steps "Direct link to Installation steps")

1. Click the link above to install the app directly.

2. You will be redirected to the **MONEI dashboard**. Log in if you are not already logged in. On the **Connect** screen for Multibanco, complete the connection.

   ![Connect MONEI Multibanco](/assets/images/connect-8d6c572e9b4f451389a99a0d5c81c951.png)

3. You will then be redirected to **Shopify → Settings → Payments**. Click **Activate** to enable the payment method.

   ![Activate MONEI Multibanco](/assets/images/activate-c5e3e3881f7141a9ef4de63a3531ea34.png)

The payment-method toggles on this screen only show or hide icons

The payment methods listed here have on/off toggles, but they control only which **icons** appear at checkout — switching one on or off does **not** enable or disable the method. Which methods you can actually accept is controlled in your [MONEI Dashboard → Payment methods](https://dashboard.monei.com/settings/payment-methods).

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

### Accessing configuration from the dashboard[​](#accessing-configuration-from-the-dashboard "Direct link to Accessing configuration from the dashboard")

Go to **Settings → Payments → Integrations → Shopify**.

![Shopify integration page in the MONEI Dashboard settings, listing your connected Shopify stores](/img/dashboard/en/settings-integrations-shopify.png)

Shopify integration page in the MONEI Dashboard settings, listing your connected Shopify stores

The page links every MONEI app you can install, then lists **Connected Shopify stores** — the connections in your **current** test or live mode. Use the mode switcher to see the connections in the other mode. On a row, open the **···** menu:

* **Configure** — turns test mode on or off for that connection, and assigns a MONEI store to each checkout country.
* **Open in Shopify** — opens the Shopify activation screen for that app.

To disconnect a Shopify store, uninstall the MONEI app from your Shopify admin.

![Shopify store configuration dialog in the MONEI Dashboard, where you bind checkout countries to your MONEI stores](/img/dashboard/en/settings-shopify-store-config.png)

Shopify store configuration dialog in the MONEI Dashboard, where you bind checkout countries to your MONEI stores

### Accessing from Shopify Admin[​](#accessing-from-shopify-admin "Direct link to Accessing from Shopify Admin")

You can also open the MONEI integration from Shopify:

* **Settings → Apps → MONEI Multibanco** → **Open App**, or
* **Settings → Payments → MONEI Multibanco** → **More actions** → **Manage**

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

* Switch to [live (production) mode](https://docs.monei.com/testing/.md) in the MONEI dashboard and ensure the app is configured for live mode.
* Ensure Multibanco is activated as a [payment method](https://dashboard.monei.com/settings/payment-methods) (Settings → Payments → Payment methods) in your MONEI account.

## Find your orders in Shopify[​](#find-your-orders-in-shopify "Direct link to Find your orders in Shopify")

After a payment, match it to its Shopify order using the MONEI Order ID — see [Find a Shopify order](https://docs.monei.com/e-commerce/shopify/find-order/.md).
