# 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="https://1855875201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuavme8c9AG1nZnBMERrf%2Fuploads%2FI5Akenhikr6LRKlyBXDn%2FBildschirmfoto_.png?alt=media&#x26;token=df1364e6-8121-46ec-98b2-b03c49e5b2b1" 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="https://1855875201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuavme8c9AG1nZnBMERrf%2Fuploads%2FXv76XpCUEMV9bmom9QwP%2FMollie%20API%20KEY.png?alt=media&#x26;token=56fdab51-5008-4958-9baa-baf9d1b107c8" 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="https://1855875201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuavme8c9AG1nZnBMERrf%2Fuploads%2FRXudzw0EK5Mh01UUYq8t%2Ftest%20connection.png?alt=media&#x26;token=409e0971-8725-4d70-928c-7907745c8141" 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 %}