---
title: How to Connect Mollie to OneSuite
description: "Connect Mollie so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Mollie card. Paste your Mollie **API key**, choose a **Currency**, and click **Save**. A live key takes real payments. A test key takes test payments only. **In this…"
url: "https://help.onesuite.io/docs/how-to-connect-mollie-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect Mollie to OneSuite

Connect Mollie so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Mollie card. Paste your Mollie **API key**, choose a **Currency**, and click **Save**. A live key takes real payments. A test key takes test payments only.

**In this guide you'll learn how to:**

- Find your Mollie API key
- Choose between a live key and a test key
- Connect Mollie to OneSuite
- Switch Mollie on for an invoice

## Before you start

- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- You need a Mollie account and access to the Mollie Dashboard.
- Your API key is a private code from Mollie. It lets OneSuite work with your Mollie account.
- A live key starts with live_. A test key starts with test_.
- A test payment is a practice payment. No real money moves.

## What does OneSuite ask for when you connect Mollie?

| Field | Where to find it | Required |
| --- | --- | --- |
| **API key** | In the Mollie Dashboard, open **Developers**, then **API keys**. The example in the field starts with live_. | Yes |
| **Currency** | Starts as **Euro (EUR)**. OneSuite uses it when an invoice has no currency of its own. | No |

## How do I connect Mollie to OneSuite?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **Mollie** and click **Connect**.
4. In the Mollie Dashboard, open **Developers**, then **API keys**. Copy your key.
5. Paste it into **API key**.
6. Check the **Currency**.
7. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## How do I check it worked?

The Mollie card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see Mollie marked **Connected** under **Invoices** > **Configure** > **Getting paid** > **Online payments**.

OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use Mollie on an older invoice:

1. Open the invoice.
2. Switch Mollie on in its **Payments** panel.
3. Save the invoice and send it again.

## FAQs

### What is the difference between a live and a test Mollie key?

A live_ key is for real payments. A test_ key is for test payments only. Mollie's [guide to API keys](https://help.mollie.com/hc/en-gb/articles/115000328205) explains both.

### Does Mollie need a webhook in OneSuite?

No. A webhook is how a payment service tells OneSuite that a client has paid. The Mollie dialog shows no webhook URL, so you have nothing to add in Mollie.

### Which currency does Mollie use in OneSuite?

The **Currency** list starts as Euro (EUR). OneSuite uses your choice when an invoice has no currency of its own.

## What to do next

**See every gateway:** Browse all the guides in [Payment Integration](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
