# Mollie Integration einrichten

Nach der Installation der Anwendung und dem Erhalt Ihres Mollie API-Keys können Sie die Mollie Integration einrichten.

## 1. Grundlegende Einstellungen

Die Mollie Einrichtungsseite ist die zentrale Anlaufstelle für alle Konfigurationen der Integration.

Suchen Sie in Business Central nach *"Mollie Setup".* Nach den Auswählen öffnet sich die Einrichtungsseite. Folgendes ist zu ergänzen:

* **Firmenname / Company Name** (wird bei Zahlungen angezeigt)
* **Mollie API Key** (aus dem Mollie Dashboard, explizite Anleiten siehe unten "*API-Key"*)
* **Redirect URL** (zu welcher Kunden nach der Zahlung weitergeleitet werden)
* **Standardwährung** **/ Default Currency** (für Zahlungen, wenn diese leer, dann EUR)

<div align="left" data-with-frame="true"><figure><img src="/files/F5wlJOpbgd6NeiirpAx8" alt="" width="563"><figcaption></figcaption></figure></div>

Nachdem Sie alle relevanten Lücken gefüllt haben, klicken Sie auf *"Verbindung testen"*. Bei erfolgreicher Verbindung erscheint eine Bestätigung mit Ihrem Organisationsnamen.

<mark style="color:$success;">Bei Erfolg:</mark> "Verbindung erfolgreich! Verbunden als: \[Ihr Firmenname]"

<mark style="color:$warning;">Bei Fehler:</mark> Überprüfen Sie Ihren API-Key

***

## 2. API-Key&#x20;

### 2.1 API-Key aus Mollie kopieren

Melden Sie sich bei [my.mollie.com](https://my.mollie.com/dashboard) an und navigieren Sie zu **Entwickler** → **API-Keys.** Kopieren Sie den gewünschten Key:

* **Test-Key** (`test_...`) – Für Testzwecke
* **Live-Key** (`live_...`) – Für Produktivbetrieb

### 2.2 In Business Central eingeben

Öffnen Sie *"Mollie Setup"* und geben Sie den API-Key in das Feld *"Mollie API Key"* ein. Das Feld ist maskiert. Der Key wird nicht im Klartext angezeigt.

<div align="left" data-with-frame="true"><figure><img src="/files/9TtuNkXlL0i77xMLWmaK" alt="" width="563"><figcaption></figcaption></figure></div>

### **2.3 Verbindung testen**

Nach Eingabe des API-Keys muss Sie die Verbindung getestet werden, indem Sie auf *"Verbindung testen"* / *"Test Connection"* in der Aktionsleiste klicken. Nun sollte sich das System mit der Mollie API verbinden.

{% tabs %}
{% tab title="Erfolgreiche Verbindung" %}
Bei **erfolgreicher Verbindung** erscheint die Meldung:

> "Verbindung erfolgreich! Verbunden als: \[Ihr Organisationsname]"
> {% endtab %}

{% tab title="Fehlgeschlagene Verbindung" %}
Bei **Fehlern** erscheint:

> "Verbindung fehlgeschlagen. Bitte überprüfen Sie Ihren API-Key."

Mögliche Ursachen:

* API-Key ist falsch oder unvollständig.
* API-Key wurde in Mollie deaktiviert.
* In Business Central wurden keine HTTP Anfragen für die Erweiterungen erlaubt.
  {% endtab %}
  {% endtabs %}

<div align="left" data-with-frame="true"><figure><img src="/files/uzwuxsMz3MyHVJATe9WC" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.4 Test-Modus vs. Live-Modus

{% tabs %}
{% tab title="Test-Modus" %}

### Test-Modus

* Nutzen Sie den **Test API-Key** (`test_...`)
* Keine echten Transaktionen
* Ideal für:
  * Ersteinrichtung
  * Funktionstest
  * Schulungen
    {% endtab %}

{% tab title="Live-Modus" %}

### Live-Modus

* Nutzen Sie den **Live API-Key** (`live_...`)
* Echte Zahlungen werden verarbeitet.
* Voraussetzungen:
  * Verifiziertes Mollie-Konto
  * Mindestens eine aktive Zahlungsmethode
    {% endtab %}
    {% endtabs %}

{% hint style="warning" %}
**Wichtig:** Wechseln Sie erst in den Live-Modus, wenn Sie alle Funktionen im Test-Modus erfolgreich getestet haben.
{% endhint %}

### 2.5 Hinweise

{% hint style="info" %}
Wenn Sie den **API Key ändern** möchten, beispielsweise beim Wechsel von der Test- in die Live-Umgebung, scrollen Sie nach oben und folgen Sie den Anleitungen der Punkte eins bis drei:&#x20;

1. API-Key aus Mollie kopieren
2. In Business Central eingeben
3. Verbindung testen
   {% endhint %}

{% hint style="danger" %}
**Sicherheit:**

* Behandeln Sie Ihren API-Key wie ein Passwort und teilen Sie ihn niemals öffentlich oder per E-Mail.
* Erstellen Sie bei Verdacht auf Kompromittierung einen neuen Key in Mollie.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solutioo.de/mollie-integration/konfiguration/erste-einrichtung.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.