Add-On: Zahlungsdienstleister Mollie

Diese Seite beschreibt Einrichtung und Funktionsweise der Zahlungsanbindung Mollie in PrintLounge.

Mollie ist ein Zahlungsdienstleister, über den Kunden im Checkout bezahlen können (Kreditkarte, iDEAL, PayPal, Apple Pay, SEPA u. v. m. – abhängig von der Freischaltung im Mollie-Konto). Beim Bezahlen wird der Kunde auf die gehostete Mollie-Bezahlseite weitergeleitet; nach Abschluss kehrt er in den Shop zurück. Der Bezahlstatus wird zusätzlich asynchron per Webhook abgesichert.

• Ein Mollie-Konto (www.mollie.com). Für Tests das Konto in den Testmodus schalten.

• Ein API-Key aus dem Mollie-Dashboard unter Entwickler → API-Keys:

  • Test-Key beginnt mit test_…

  • Live-Key beginnt mit live_…

• Das Add-On Mollie muss für den Mandanten aktiviert sein.

Hinweis: Der API-Key bestimmt die Umgebung. Mit einem test_-Key laufen alle Zahlungen im Testmodus, mit einem live_-Key produktiv. Der Wechsel auf Live erfolgt einfach durch Austausch des Keys.

1. Im Backend zu den Zahlungsarten des Shops wechseln.

2. Über „Weitere Mollie-Schnittstelle anlegen" eine neue Mollie-Zahlungsart hinzufügen und einen internen Namen vergeben.

3. Folgende Felder ausfüllen:

4. Über den Button „Verbindung prüfen" den API-Key testen:

   • grün / „Zugangsdaten gültig" → Key korrekt

   • rot / „Zugangsdaten ungültig" → Key prüfen

Ein Webhook muss nicht manuell im Mollie-Dashboard hinterlegt werden – die Webhook-Adresse wird je Zahlung automatisch mitgegeben.

Im Feld Verwendungszweck können Platzhalter verwendet werden, die je Bestellung aufgelöst werden, z. B.:

• {$order->...} – Bestelldaten (z. B. Bestellnummer)

• {$orderItem->...} – Positionen

• {$user->...} – Kundendaten

• {$shopEnvironmentSettings->...} – Shop-Einstellungen

Beispiel: Bestellung {$order->...} erscheint dann mit der konkreten Bestellnummer im Mollie-Dashboard und auf dem Kontoauszug des Kunden. Bei fehlerhaftem Text wird die Beschreibung leer gelassen und eine Benachrichtigung erzeugt (kein Abbruch der Zahlung).

1. Der Kunde wählt im Checkout Mollie als Zahlart und schließt die Bestellung ab.

2. Er wird auf die Mollie-Bezahlseite weitergeleitet und zahlt dort.

3. Nach Abschluss kehrt er in den Shop zurück:

   • Bezahlt → Bestellung wird als bezahlt markiert und abgeschlossen.

   • Abgebrochen / fehlgeschlagen → Hinweisseite mit Bestellcode; die Bestellung bleibt offen und kann erneut bezahlt werden.

4. Parallel meldet Mollie den finalen Status per Webhook an PrintLounge – auch dann, wenn der Kunde nicht in den Shop zurückkehrt (z. B. Browser geschlossen).

• Bezahlt: Bestellung wird auf bezahlt gesetzt (inkl. Zahldatum). Mehrfach eintreffende Meldungen werden ignoriert (keine Doppelverarbeitung).

• Erstattung (Refund): Wird im Mollie-Dashboard eine bezahlte Zahlung erstattet, wird die Bestellung in PrintLounge storniert.

• Fehlgeschlagen / abgebrochen / abgelaufen: keine Statusänderung der Bestellung; der Kunde erhält die Hinweisseite.

• Chargebacks (Rücklastschriften) werden derzeit nicht automatisch verarbeitet.

• Eine Teil-Erstattung storniert aktuell die komplette Bestellung.